bug-automake
[Top][All Lists]
Advanced

[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



reply via email to

[Prev in Thread] Current Thread [Next in Thread]