From patchwork Fri Sep 24 21:24:35 2010
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
X-Patchwork-Submitter: Gerald Pfeifer <gerald@pfeifer.com>
X-Patchwork-Id: 65694
Return-Path: 
 <gcc-patches-return-273694-incoming=patchwork.ozlabs.org@gcc.gnu.org>
X-Original-To: incoming@patchwork.ozlabs.org
Delivered-To: patchwork-incoming@bilbo.ozlabs.org
Received: from sourceware.org (server1.sourceware.org [209.132.180.131])
	by ozlabs.org (Postfix) with SMTP id D43ADB70FB
	for <incoming@patchwork.ozlabs.org>;
	Sat, 25 Sep 2010 07:24:46 +1000 (EST)
Received: (qmail 30969 invoked by alias); 24 Sep 2010 21:24:44 -0000
Received: (qmail 30961 invoked by uid 22791); 24 Sep 2010 21:24:44 -0000
X-SWARE-Spam-Status: No, hits=-2.0 required=5.0	tests=AWL,BAYES_00,TW_WW
X-Spam-Check-By: sourceware.org
Received: from vexpert.dbai.tuwien.ac.at (HELO vexpert.dbai.tuwien.ac.at)
	(128.131.111.2) by sourceware.org (qpsmtpd/0.43rc1) with
	ESMTP; Fri, 24 Sep 2010 21:24:37 +0000
Received: from acrux.dbai.tuwien.ac.at (acrux.dbai.tuwien.ac.at
	[128.131.111.60])	(using TLSv1 with cipher DHE-RSA-AES256-SHA
	(256/256 bits))	(No client certificate requested)	by
	vexpert.dbai.tuwien.ac.at (Postfix) with ESMTPS id 951941E06E;
	Fri, 24 Sep 2010 23:24:32 +0200 (CEST)
Date: Fri, 24 Sep 2010 23:24:35 +0200 (CEST)
From: Gerald Pfeifer <gerald@pfeifer.com>
To: Tom Browder <tom.browder@gmail.com>,
	"Joseph S. Myers" <joseph@codesourcery.com>
cc: gcc-patches <gcc-patches@gcc.gnu.org>
Subject: Re: Update to WWW Docs for Contributing Doc Patches [wwwdocs]
In-Reply-To: <AANLkTin7JFdpbXKqcL_YvMABF1cr+b1Vt4meA1pL5Eks@mail.gmail.com>
Message-ID: <alpine.LNX.2.00.1009241941470.5068@acrux.dbai.tuwien.ac.at>
References: <AANLkTin7JFdpbXKqcL_YvMABF1cr+b1Vt4meA1pL5Eks@mail.gmail.com>
User-Agent: Alpine 2.00 (LNX 1167 2008-08-23)
MIME-Version: 1.0
X-IsSubscribed: yes
Mailing-List: contact gcc-patches-help@gcc.gnu.org; run by ezmlm
Precedence: bulk
List-Id: <gcc-patches.gcc.gnu.org>
List-Unsubscribe: 
 <mailto:gcc-patches-unsubscribe-incoming=patchwork.ozlabs.org@gcc.gnu.org>
List-Archive: <http://gcc.gnu.org/ml/gcc-patches/>
List-Post: <mailto:gcc-patches@gcc.gnu.org>
List-Help: <mailto:gcc-patches-help@gcc.gnu.org>
Sender: gcc-patches-owner@gcc.gnu.org
Delivered-To: mailing list gcc-patches@gcc.gnu.org

On Wed, 8 Sep 2010, Tom Browder wrote:
> When  trying to do "make info" and "make dvi" according to wwwdocs for
> doc patches, I got errors due to the build environment after a
> configure (outside the gcc tree).  I found I had to also complete a
> build of the c language to get those targets to work--thus the
> recommended change in the patch at the end of this message.
> 
> I used this minimal set of commands to get a good build of the
> required doc test targets:
> 
> $ ../<gcc trunk src>/configure --enable-languages=c --disable-bootstrap
> $ make
> $ make info
> $ make dvi

Thanks, Tom!  I suggest the small variation of your patch that I am 
including below.  Joseph, thoughts?

Gerald

Index: contribute.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/contribute.html,v
retrieving revision 1.77
diff -u -3 -p -r1.77 contribute.html
--- contribute.html	10 Jul 2010 20:22:25 -0000	1.77
+++ contribute.html	24 Sep 2010 17:42:49 -0000
@@ -148,8 +148,9 @@ testsuite run.</p>
 
 <h2><a name="docchanges">Documentation Changes</a></h2>
 
-<p>Documentation changes do not require a bootstrap, but you must
-perform <code>make info</code> and <code>make dvi</code> and correct
+<p>Documentation changes do not require a new bootstrap (a working
+bootstrap is necessary to get the build environment correct), but you
+must perform <code>make info</code> and <code>make dvi</code> and correct
 any errors.  You should investigate complaints about overfull or
 underfull hboxes from <code>make dvi</code>, as these can be the only
 indication of serious markup problems, but do not feel obliged to