[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH] Don't hide the table of contents
From: |
Bruno Haible |
Subject: |
[PATCH] Don't hide the table of contents |
Date: |
Sun, 15 Aug 2010 16:40:36 +0200 |
User-agent: |
KMail/1.9.9 |
Hi,
I wanted to get an overview of the Automake manual. I did "make html"
(since I prefer to view doc in HTML format), and found myself confused:
- The doc starts with a list of chapters. Fine, but not detailed enough
(I was searching for stuff about shared libraries).
- Then comes a detailed list of nodes. Not useful, because it's a
flattened list, that is 1. the hierarchy level is not visible,
2. chapters without subsections don't appear in this list.
- There is no chapter called "Table of Contents".
- After looking for @contents in the .texi file, I found that the table
of contents exists but is hidden in the "General Index" HTML page
<http://www.gnu.org/software/automake/manual/html_node/General-Index.html>.
The Autoconf manual
<http://www.gnu.org/software/autoconf/manual/html_node/index.html> does it
nicely: It puts a hierarchical table of contents at the beginning. Here is
a suggestion to do the same in the Automake manual.
2010-08-15 Bruno Haible <address@hidden>
Don't hide the table of contents.
* doc/automake.texi: Move the table of contents to the beginning.
--- doc/automake.texi.orig Sun Aug 15 16:31:08 2010
+++ doc/automake.texi Sun Aug 15 16:28:59 2010
@@ -63,6 +63,7 @@
@insertcopying
@end titlepage
address@hidden
@c We use the following macros to define indices:
@c @cindex concepts, and anything that does not fit elsewhere
@@ -12887,8 +12888,6 @@
@printindex cp
address@hidden
address@hidden
@bye
@c LocalWords: texinfo setfilename settitle setchapternewpage texi direntry
- [PATCH] Don't hide the table of contents,
Bruno Haible <=