Re: [PATCH, doc]: Rename Index node to prevent file collision

[Michael Hope <michael dot hope at linaro dot org>]

On 15 June 2012 04:42, Eli Zaretskii <eliz@gnu.org> wrote:
>> Date: Thu, 14 Jun 2012 15:06:30 +0000 (UTC)
>> From: "Joseph S. Myers" <joseph@codesourcery.com>
>> cc: gdb-patches@sourceware.org
>>
>> On Thu, 14 Jun 2012, Michael Hope wrote:
>>
>> > Hi there. ?This patch renames the 'Index' node in the GDB end user
>> > documentation to 'GDB Index'
>> > to prevent generating HTML filenames that differ only in case.
>>
>> This was rejected when I submitted it
>> <http://sourceware.org/ml/gdb-patches/2009-01/msg00298.html>.
>
> Right, and I still would like very much to follow GNU practice in this
> matter.
>
> Michael, is your setup also that you produce the HTML files on a Posix
> host, but then deploy them on Windows?

Yip.  We supply pre-built toolchains for Linux and Windows[1].  The
build is crtosstool-NG based, runs on Ubuntu Lucid, and uses the LSB
compilers for Linux and the mingw cross compilers for Windows.  We
cross-make the manuals the same as we cross-build the compiler.

The makeinfo manual says: """If makeinfo is run on a system which does
not distinguish case in filenames, nodes which are the same except for
case will also be folded into the same output file.""".  I don't think
that's valid here as the index is a special case: we shouldn't merge
the top level index.html with the output of a node called Index.

-- Michael