This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
[WWWDOCS] Bad links on http://gcc.gnu.org/install/specific.html
- From: "Dave Korn" <dk at artimi dot com>
- To: <gcc at gcc dot gnu dot org>
- Date: Mon, 19 Jul 2004 15:20:01 +0100
- Subject: [WWWDOCS] Bad links on http://gcc.gnu.org/install/specific.html
Heh, we appear to have a "partial transition" on that page.
The TOC has a long list of target-triplets, many of which contain
pattern-matching asterisks. Each of these list entries is also a link to a
within-page anchor.
Originally the anchors had the same names as the target triples, asterisks
and all. Presumably someone decided this was a potential problem (URL
encoding, anybody?) and that they should be changed to something safe. So
the asterisks are replaced by 002a in the internal anchors.
But not, alas, in the TOC links. Examples:
TOC entries:
<li><a href="#alpha*-*-*">alpha*-*-*</a>
<li><a href="#*-*-solaris2*">*-*-solaris2*</a>
<li><a href="#x86_64-*-*">x86_64-*-*</a> amd64-*-*
Corresponding page anchors:
<h3 class="heading"><a name="TOC0"></a><a
name="alpha_002a_002d_002a_002d_002a"></a>alpha*-*-*</h3>
<h3 class="heading"><a name="TOC47"></a><a
name="_002a_002d_002a_002dsolaris2_002a"></a>*-*-solaris2*</h3>
<h3 class="heading"><a name="TOC56"></a><a
name="x86_005f64_002d_002a_002d_002a"></a>x86_64-*-*, amd64-*-*</h3>
It seems to need the following replacements of chars with ascii
equivalents in the links in the TOC:
'*' -> '_002a'
'-' -> '_002d'
'.' -> '_002e'
'_' -> '_005f'
and I also spotted one completely mangled link:
<li><a href="#*-*-sysv*">*-*-sysv*</a>
<h3 class="heading"><a name="TOC53"></a><a
name="_0023sysv"></a>*-*-sysv*</h3>
(someone's converted the # between the page name and the anchor and left out
the asterisks and hyphens!)
I'd also assume that those bits in the paragraph headers after <h3> that
say <a name="TOCxx"> should really be <a href="TOCxx">, and should enclose
the text of the section name, and that the <li> entries in the TOC should
have the corresponding <a name="TOCxx"> anchors, in order to make the usual
click-on-TOC-entry-to-go-to-chapter-heading-then-click-on-chapter-heading-to
-return-to-TOC-entry
cheers,
DaveK
--
Can't think of a witty .sigline today....