This is the mail archive of the gcc-patches@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]

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


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