onlinedocs/gcc/Index.html and index.html clash

onlinedocs/gcc/Index.html and index.html clash

[Marek Michalkiewicz]

Hello,

trying to copy the HTML manual - http://gcc.gnu.org/onlinedocs/gcc/ -
for someone to use on a non-networked win32 box, I noticed a problem:
there are two different files named index.html and Index.html.  While
not a problem on a case-sensitive Unix filesystem, Windows filesystems
are case-insensitive so one of these two files gets overwritten.

Would it be possible to rename Index.html (uppercase 'I') so it will
not clash, and update all links to that file?

Thanks,
Marek

Re: onlinedocs/gcc/Index.html and index.html clash

[Gerald Pfeifer]

On Mon, 5 Aug 2002, Marek Michalkiewicz wrote:
> trying to copy the HTML manual - http://gcc.gnu.org/onlinedocs/gcc/ -
> for someone to use on a non-networked win32 box, I noticed a problem:
> there are two different files named index.html and Index.html.  While
> not a problem on a case-sensitive Unix filesystem, Windows filesystems
> are case-insensitive so one of these two files gets overwritten.

I investitaged, and noticed that index.html is the one which you "usually"
have on a webserver, while Index.html is the alphabetical document index.

> Would it be possible to rename Index.html (uppercase 'I') so it will
> not clash, and update all links to that file?

Joseph, do you seen any possibility? "Index.html" looks like a bad choice
to me, but propobably one needs to hack makeinfo or contact the authors to
address this?

Gerald
-- 
Gerald "Jerry" pfeifer@dbai.tuwien.ac.at http://www.dbai.tuwien.ac.at/~pfeifer/

Re: onlinedocs/gcc/Index.html and index.html clash

[Joseph S. Myers]

On Tue, 6 Aug 2002, Gerald Pfeifer wrote:

> Joseph, do you seen any possibility? "Index.html" looks like a bad choice
> to me, but propobably one needs to hack makeinfo or contact the authors to
> address this?

The node name "Index" is given explicitly in gcc.texi, so could be changed
(as long as the new name still contains the word "Index", e.g. "The
Index", so that info readers know it's an index for the purpose of
commands such as 'i' to look up index entries).

-- 
Joseph S. Myers
jsm28@cam.ac.uk

Re: onlinedocs/gcc/Index.html and index.html clash

[Gerald Pfeifer]

On Tue, 6 Aug 2002, Joseph S. Myers wrote:
> The node name "Index" is given explicitly in gcc.texi, so could be changed
> (as long as the new name still contains the word "Index", e.g. "The
> Index", so that info readers know it's an index for the purpose of
> commands such as 'i' to look up index entries).

You mean, like the following two patches?  Toon, if Joseph agrees, is
the g77 patch fine with you?

Gerald


2002-08-06  Gerald Pfeifer  <pfeifer@dbai.tuwien.ac.at>

        * doc/gcc.texi (Top): Rename Index to Keyword Index.

Index: doc/gcc.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/doc/gcc.texi,v
retrieving revision 1.53
diff -u -3 -p -r1.53 gcc.texi
--- doc/gcc.texi	20 Apr 2002 20:44:10 -0000	1.53
+++ doc/gcc.texi	6 Aug 2002 12:26:06 -0000
@@ -180,7 +180,7 @@ Introduction, gccint, GNU Compiler Colle
 * Contributors::    People who have contributed to GCC.

 * Option Index::    Index to command line options.
-* Index::	    Index of concepts and symbol names.
+* Keyword Index::    Index of concepts and symbol names.
 @end menu

 @include frontends.texi
@@ -222,8 +222,8 @@ form; it may sometimes be useful to look

 @printindex op

-@node Index
-@unnumbered Index
+@node Keyword Index
+@unnumbered Keyword Index

 @printindex cp


Tue Aug  6 14:22:08 2002  Gerald Pfeifer  <pfeifer@dbai.tuwien.ac.at>

	* g77.texi (Top): Rename Index to Keyword Index.

Index: f/g77.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/f/g77.texi,v
retrieving revision 1.93
diff -u -3 -p -r1.93 g77.texi
--- f/g77.texi	29 Apr 2002 07:57:20 -0000	1.93
+++ f/g77.texi	6 Aug 2002 12:26:12 -0000
@@ -275,7 +275,7 @@ most consistent with the @command{g77} p

 * M: Diagnostics.   Diagnostics produced by @command{g77}.

-* Index::           Index of concepts and symbol names.
+* Keyword Index::   Index of concepts and symbol names.
 @end menu
 @c yes, the "M: " @emph{is} intentional -- bad.def references it (CMPAMBIG)!

@@ -12262,8 +12262,8 @@ that is not Year-2000 (Y2K) compliant.

 @end ifset

-@node Index
-@unnumbered Index
+@node Keyword Index
+@unnumbered Keyword Index

 @printindex cp
 @bye

Re: onlinedocs/gcc/Index.html and index.html clash

[Joseph S. Myers]

On Tue, 6 Aug 2002, Gerald Pfeifer wrote:

> On Tue, 6 Aug 2002, Joseph S. Myers wrote:
> > The node name "Index" is given explicitly in gcc.texi, so could be changed
> > (as long as the new name still contains the word "Index", e.g. "The
> > Index", so that info readers know it's an index for the purpose of
> > commands such as 'i' to look up index entries).
> 
> You mean, like the following two patches?  Toon, if Joseph agrees, is
> the g77 patch fine with you?

Yes (though there should be no need to change the @unnumbered Index (used
for the heading in the printed book rather than the Info files) though you
may want consistency between the printed and online versions).

-- 
Joseph S. Myers
jsm28@cam.ac.uk

Re: onlinedocs/gcc/Index.html and index.html clash

[Toon Moene]

Gerald Pfeifer wrote:

> On Tue, 6 Aug 2002, Joseph S. Myers wrote:
> 
>>The node name "Index" is given explicitly in gcc.texi, so could be changed
>>(as long as the new name still contains the word "Index", e.g. "The
>>Index", so that info readers know it's an index for the purpose of
>>commands such as 'i' to look up index entries).
> 
> 
> You mean, like the following two patches?  Toon, if Joseph agrees, is
> the g77 patch fine with you?

Sure - thanks !

-- 
Toon Moene - mailto:toon@moene.indiv.nluug.nl - phoneto: +31 346 214290
Saturnushof 14, 3738 XG  Maartensdijk, The Netherlands
Maintainer, GNU Fortran 77: http://gcc.gnu.org/onlinedocs/g77_news.html
Join GNU Fortran 95: http://g95.sourceforge.net/ (under construction)

Re: onlinedocs/gcc/Index.html and index.html clash

[Gerald Pfeifer]

On Tue, 6 Aug 2002, Toon Moene wrote:
> Sure - thanks !

Thanks, I now committed both patches.

Marek, at least the GCC and G77 manuals (of current development versions
of GCC and GCC 3.3) will now work around the problem you have encountered.

Gerald
-- 
Gerald "Jerry" pfeifer@dbai.tuwien.ac.at http://www.dbai.tuwien.ac.at/~pfeifer/

Re: onlinedocs/gcc/Index.html and index.html clash

[Marek Michalkiewicz]

Gerald Pfeifer <pfeifer@dbai.tuwien.ac.at> wrote:

> Marek, at least the GCC and G77 manuals (of current development versions
> of GCC and GCC 3.3) will now work around the problem you have encountered.

Many thanks.

Marek