Update to WWW Docs for Contributing Doc Patches [wwwdocs]
Gerald Pfeifer
gerald@pfeifer.com
Sat Sep 25 15:05:00 GMT 2010
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
More information about the Gcc-patches
mailing list