This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: PATCH: maintainer-scripts/update_web_docs and install.texi
- To: "Joseph S. Myers" <jsm28 at cam dot ac dot uk>
- Subject: Re: PATCH: maintainer-scripts/update_web_docs and install.texi
- From: Gerald Pfeifer <pfeifer at dbai dot tuwien dot ac dot at>
- Date: Fri, 8 Jun 2001 08:27:55 +0200 (CEST)
- cc: <gcc-patches at gcc dot gnu dot org>
On Mon, 4 Jun 2001, Joseph S. Myers wrote:
>> 2001-06-04 Gerald Pfeifer <pfeifer@dbai.tuwien.ac.at>
>>
>> * update_web_docs (WWWBASE_PREFORMATTED, PREPROCESS): New
>> variables.
>> Fix a comment and add another one.
>> Generate the installation documentation in HTML format from
>> gcc/doc/install.texi
> Will this do the right thing when called with -r/-d to generate
> documentation for a particular branch or release, i.e. not update the main
> install docs?
No, this was left in my TODO. Addressed as follows (patch at the end):
2001-06-08 Gerald Pfeifer <pfeifer@dbai.tuwien.ac.at>
* update_web_docs: Only update the install documentation for the
CVS HEAD.
> Now the install docs are in CVS with the GCC sources and so can be
> branched for releases, can we remove information about old releases from
> them so they only describe how to build the particular release or branch
> of CVS they're in, not differences from 2.95 or EGCS, etc.?
We'd need some further improvements for this. Specifically, we should
refer to http://gcc.gnu.org/someversionspecificurl instead of just
/install in those docs, then.
But, and this is a big But, I'm afraid that most maintainers do not update
docs on the branches appropriately, so that often the best version to use
really is the one on HEAD.
Gerald
Index: update_web_docs
===================================================================
RCS file: /cvs/gcc/gcc/maintainer-scripts/update_web_docs,v
retrieving revision 1.7
diff -u -3 -p -r1.7 update_web_docs
--- update_web_docs 2001/06/07 07:27:49 1.7
+++ update_web_docs 2001/06/08 06:26:20
@@ -155,16 +155,18 @@ if [ "$DO_THANKS_HTML" = y ]; then
fi
# Finally, generate the installation documentation (but only for CVS HEAD).
-SOURCEDIR=$WORKDIR
-DESTDIR=$WWWBASE_PREFORMATTED/install
-export SOURCEDIR
-export DESTDIR
-$WORKDIR/gcc/gcc/doc/install.texi2html
+if [ "$RELEASE" = "HEAD" ]; then
+ SOURCEDIR=$WORKDIR
+ DESTDIR=$WWWBASE_PREFORMATTED/install
+ export SOURCEDIR
+ export DESTDIR
+ $WORKDIR/gcc/gcc/doc/install.texi2html
-for file in `ls $DESTDIR`
-do
- $PREPROCESS install/$file
-done
+ for file in `ls $DESTDIR`
+ do
+ $PREPROCESS install/$file
+ done
+fi
# Clean up behind us.