Re: [Patch, Newlib/Libm] Avoid index.html and Index.html file name clash on platform like windows

[Jeff Johnston <jjohnstn at redhat dot com>]

> -----Original Message-----
> From: newlib-owner@sourceware.org [mailto:newlib-
> owner@sourceware.org] On Behalf Of Corinna Vinschen
> Sent: Thursday, November 07, 2013 7:48 PM
> To: newlib@sourceware.org
> Subject: Re: [Patch, Newlib/Libm] Avoid index.html and Index.html file name
> clash on platform like windows
> 
> On Nov  7 13:34, Terry Guo wrote:
> > > > On Nov  6 11:05, Terry Guo wrote:
> > > > > Hello,
> > > > >
> > > > > When I copy Newlib built on Ubuntu to my Windows machine which
> > > > > is case insensitive, I ran into this filename clash issue. I
> > > > > checked some other GNU projects like Binutils and found they
> > > > > already rename the node Index to something else like "AS Index".
> > > > > This patch intends to solve same issue using same approach by
> > > > > rename Index to "Libm Index". Tested and it works. Is it ok?
> > > >
> > > > I think so, but I'm not a texinfo expert.  I noticed that the
> > > > equivalent lines in libc/libc.texinfo are:
> > > >
> > > >   * Library Index::
> > > >
> > > >   [...]
> > > >
> > > >   @node Library Index
> > > >   @unnumbered Index
> > > >
> > > > Note the "Index" in the unnumbered directive.  Is that a bug in
> > > > libc/libc.texinfo, or should libm/libm.texinfo do the same?
> 
> > > Jeff Johnston wrote:
> > > > I think it is fine in libc and libm should probably do the same.
> > > > The Index chapter in libc should not be a numbered chapter.  The
> > > > node refers to it properly.
> > > >
> > > > From the texinfo documentation on @unnumbered/@appendix:
> > > >
> > > > "Use the @unnumbered command to start a chapter-level element
> that
> > > > appears without chapter numbers of any kind. Use the @appendix
> > > command
> > > > to start an appendix that is labeled by letter (âAâ, âBâ, â)
> > > > instead of by number; appendices are also at the chapter level of
> structuring."
> > > >
> > > > "Write an @appendix or @unnumbered command at the beginning of a
> > > line
> > > > and follow it on the same line by the title, just as with @chapter.
> > > >
> > > > -- Jeff J.
> > >
> > > Thank you guys for your comments. I now updated the patch and rerun
> > > the test. No problem found. Is it OK now?
> > > [...]
> 
> Uh, sorry guys, but you seem to have both misunderstood me.  What I was
> up to is the fact that the @unnumbered entry in libc.texinfo is
> *not* "Library Index", but only "Index".  My question was about this point.
> What's right for the @unnumbered entry, just "Index" as in libc.texinfo or
> ""Library Index" as Terry proposed now?
> 
> 

IMO, it is only a minor issue.

It would technically be more correct
to have the names match but I wouldn't expect anybody would be at all confused 
by the slight difference in name (no complaints thus far) and most people would
expect the section to be called "Index".  My personal preference would be that the name be 
"Document Index" in both cases, but I certainly have no problem calling them
both "Library Index" or leaving it as is.

-- Jeff J.