The reason I was looking at the versions in the RC tarball was that I
have never been clear as to what release the website
install/prerequisite/target info actually applies to.
It would be much better if this info was on a per release basis on the
web site, like the changelog and manuals. Thus any target
specific stuff which was removed wouldn't affect older releases
documentation.
Speaking of manuals, it might be worth documenting the make commands for
the documentation (make html, install-html and pdf, install-pdf) on the
build.html page.
The documentation can only get checked before the release if people are
aware how to build it.
Andrew
On 01/05/18 08:27, Jakub Jelinek wrote:
Hi!
PR web/85578 complains about broken links in INSTALL/specific.html inside of
the rc tarballs, I've looked at past releases and at least the releases I've
checked (4.7.0, 6.1, 7.1, 7.3, 8.1rc2) all have the broken links,
e.g.
<a href="#aarch64-x-x">aarch64*-*-*</a>
and
<a name="aarch64_002dx_002dx"></a><a
name="aarch64_002a_002d_002a_002d_002a"></a>
<h3 class="heading">aarch64*-*-*</h3>
Looking at online docs, they are ok.
I think this has been fixed for the online docs with:
Index: preprocess
===================================================================
RCS file: /cvs/gcc/wwwdocs/bin/preprocess,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -p -r1.38 -r1.39
--- preprocess 28 Aug 2003 13:05:38 -0000 1.38
+++ preprocess 5 Sep 2004 21:50:02 -0000 1.39
@@ -144,7 +144,10 @@ process_file()
cat $STYLE > $TMPDIR/input
printf '<set-var MHTML::INCLUDE-PREFIX="%s">\n' `pwd` >>
$TMPDIR/input
cat $f >> $TMPDIR/input
- ${MHC} $TMPDIR/input > $TMPDIR/output
+ # Use sed to work around makeinfo 4.7 brokenness.
+ ${MHC} $TMPDIR/input \
+ | sed -e 's/_002d/-/g' -e 's/_002a/*/g' \
+ > $TMPDIR/output
# Copy the page only if it's new or there has been a change, and,
# first of all, if there was no problem when running MetaHTML.
revision 1.39
date: 2004/09/05 21:50:02; author: gerald; state: Exp; lines: +4 -1
Use sed to work around makeinfo 4.7 brokenness.
Isn't this something we should be doing in gcc/doc/install.texi2html
too (or somewhere else)?
Bugzilla is down, so can't discuss it there...
Jakub
