[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: index.html clashes with Index nodes
From: |
Karl Berry |
Subject: |
Re: index.html clashes with Index nodes |
Date: |
Fri, 26 Nov 2010 22:24:43 GMT |
People are complaining that HTML versions of manuals cannot be moved
to MS-Windows
They should remake the manual. People using Windows have to expect
extra pain to be incurred.
But that's not what the message you pointed to is really talking about.
For people doing cross-compilation, the manual shouldn't even be getting
built, as far as I can see. Certainly not in HTML! That only needs to
be done by people making releases, or perhaps working on the
documentation. The build process seems to be going too far.
we should either add an option to do that,
A runtime option would be ok, but I would not encourage GNU packages to
use it, because we're not supposed to cater to Windows, and merging
index and Index into the same file is ugly for users.
I don't know what the Perl implementation does, but I'm sure it won't be
hard to add an option (or perhaps configuration variable), since of
course there is no "compile time".
or document in texinfo.texi that the name "Index" should be
avoided in GNU manuals, for this reason.
The OP may think that's the "simple solution, but I vehemently dislike
it most of all, and am sad to hear that Cygnus/Red Hat's other GNU
manuals are already doing it. "Index" is a natural name. And even
more, renaming nodes is not something to do lightly (causes breakage to
anything referring to the existing name), certainly not to work around
Windows breakage when a workaround *already exists*.
Sigh.
karl