This is the mail archive of the gcc@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[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....


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]