This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: [v3] index chapter documentation, tweaks
> > ! <h2><a name="4">Source Documentation</a></h2>
> > ! <p>In addition to the distribution documentation (these pages), we
> > also--- 14,313 ----
> >
> > ! <hr>
> > ! <br>
> > ! <h2><a name="3">Source-Level Documentation</a></h2>
> > ! <p>The library sources have been specially formatted so that with
> > the
>
> We really ought not to change the name= numbers; that breaks bookmarks
> and published links. (The numbers were in the same order as the
> paragraphs, but then the paragraphs were shuffled.) In retrospect I
> should have used meaningful names instead of numbers.
Ok. I changed this.
> The <hr /> form looks weird but I'm told it's required for XHTML
> compliance.
This too.
> > ! <ul>
> > ! <li>Intro (Chapter 17)
> > ! <ul>
> > ! <li><a href="17_intro/howto.html#1">Header files</a>
> > ! </ul>
> > ! <ul>
> > ! <li><a href="17_intro/howto.html#3">Using <foo> vs
> > <foo.h></a>! </ul>
> > ! <ul>
> > ! <li><a href="17_intro/howto.html#2">Multithreading</a>
> > ! </ul>
>
> I like the idea of breaking out the various contents (this list could
> be generated with a decent-enough script), but I think
>
> <ul>
> <li>Intro (Chapter 17)
> <ul>
> <li>the first thing
> <li>the next thing
> ...
> </ul>
> </ul>
>
> would look better in a browser, i.e., the items should be all in one
> list instead of each one getting a separate list.
This too. Thanks!
-benjamin