[plt-scheme] Scribble: Table of content question

From: Matthew Flatt (mflatt at cs.utah.edu)
Date: Tue Jul 29 16:28:23 EDT 2008

At Tue, 29 Jul 2008 21:13:19 +0200, "Robert Matovinovic" wrote:
> Is there a possibility to reduce the depth of the table of content produced
> by the table-of-content or local-table-of-content command?
> I have scribble files, which are included by include-section commands into
> the upper level files and would like to hide their contents in the upper
> level table of contents. This is mainly because otherwise the top level
> table of contents becomes very long and unpractical. 

There are two things you can do, neither of which seem to be documented
(so I'll fix that):

 * The `local-table-of-contents' functions accepts a #:style argument.
   Supply the style 'immediate-only to get a listing with only
   immediate sub-sections.

   Chapter 3 of the Reference uses the 'immediate-only style for its
   local table of contents.

 * If a section has the style 'quiet, then its sub-sections are not
   included in a table of contents unless they are top-level entries in
   the table.

   Sections 2.1, 2.3, and 2.5 in the GUI manual (which have many
   sub-sections for different classes and interfaces) use the 'quiet
   style. Sections 12.6 and 12.7 of the Reference (which have many
   sub-sections for things that are read or printed) also use it.


Matthew



Posted on the users mailing list.