bug-automake
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

sections without nodes in automake manual?


From: Karl Berry
Subject: sections without nodes in automake manual?
Date: Tue, 3 Jun 2008 12:26:20 -0500

I noticed automake.texi has many sectioning commands without nodes.
Mostly but not entirely @subsub-level entries.

This is quite unusual.  It leads to some very long nodes.  Was it a
deliberate decision?  In cases like Install and Dist, I even venture to
say that it is a bug.

Anyway, if it is deliberate, the usual Texinfo style is to use the
@subsubheading (etc.) commands, instead of @subsubsection.  As is done
in the `API versioning' chapter (unlike all others that I saw).

Below is the edited output from C-u C-c C-s with the places I saw that
were potentially missing @nodes.

karl

lines matching 
"address@hidden>\\|address@hidden(appendix\\(?:s\\(?:\\(?:ubs\\(?:ubs\\)?\\)?ec\\)\\)?\\|chap\\(?:heading\\|ter\\)\\|heading\\|majorheading\\|s\\(?:ection\\|ub\\(?:heading\\|s\\(?:ection\\|ub\\(?:heading\\|section\\)\\)\\)\\)\\|top\\|unnumbered\\(?:s\\(?:\\(?:ubs\\(?:ubs\\)?\\)?ec\\)\\)?\\)\\>"
 in buffer automake.texi/doc/automake/src/gnu/~.
   3061:@node Macro search path
   3062:        @subsection Macro search path
   3096:            @subsubsection Modifying the macro search path: 
@option{--acdir}
   3110:            @subsubsection Modifying the macro search path: @samp{-I 
@var{dir}}
   3123:            @subsubsection Modifying the macro search path: 
@file{dirlist}

   3979:@node Conditional Subdirectories
   3980:    @section Conditional Subdirectories
   4011:        @subsection @code{SUBDIRS} vs.@: @code{DIST_SUBDIRS}
   4043:        @subsection Conditional subdirectories with 
@code{AM_CONDITIONAL}
   4084:        @subsection Conditional Subdirectories with @code{AC_SUBST}
   4118:        @subsection Non-configured Subdirectories

   4564:@node Conditional Sources
   4565:        @subsection Conditional compilation of sources
   4577:            @subsubsection Conditional compilation using @code{_LDADD} 
substitutions
   4615:            @subsubsection Conditional compilation using Automake 
conditionals

   4650:@node Conditional Programs
   4651:        @subsection Conditional compilation of programs
   4661:            @subsubsection Conditional programs using 
@command{configure} substitutions
   4686:            @subsubsection Conditional programs using Automake 
conditionals

   5199:@node Libtool Issues
   5200:        @subsection Common Issues Related to Libtool's Use
   5202:            @subsubsection @samp{required file `./ltmain.sh' not found}
   5230:            @subsubsection Objects @samp{created with both libtool and 
without}

   6903:@node Built sources example
   6904:        @subsection Built sources example
   6916:        @unnumberedsubsec First try
   6957:        @unnumberedsubsec Using @code{BUILT_SOURCES}
   7006:        @unnumberedsubsec Recording dependencies manually
   7042:        @unnumberedsubsec Build @file{bindir.h} from @file{configure}
   7067:        @unnumberedsubsec Build @file{bindir.c}, not @file{bindir.h}.
   7087:        @unnumberedsubsec Which is best?

   7703:@node Install
   7704:@chapter What Gets Installed
   7709:    @section Basics of installation
   7740:    @section The two parts of install
   7773:    @section Extending installation
   7789:    @section Staged installs
   7822:    @section Rules for the user

   7901:@node Dist
   7902:@chapter What Goes in a Distribution
   7904:    @section Basics of distribution
   7963:    @section Fine-grained distribution control
   7985:    @section The dist hook
   8035:    @section Checking the distribution
   8129:    @section The types of distributions

   8168:@node Tests
   8169:@chapter Support for test suites
   8177:    @section Simple Tests
   8248:    @section DejaGnu Tests
   8292:    @section Install Tests

   8870:@node Conditionals
   8871:@chapter Conditionals
   8877:    @unnumberedsec Usage
   8983:    @unnumberedsec Portability
   8996:    @unnumberedsec Limits

   9687:@node CVS
   9688:    @section CVS and generated files
   9690:        @subsection Background: distributed generated files
   9711:        @subsection Background: CVS and timestamps
   9734:        @subsection Living with CVS in Autoconfiscated projects
   9742:            @subsubheading All files in CVS
   9808:            @subsubheading Generated files out of CVS
   9834:        @subsection Third-party files

   9849:@node maintainer-mode
   9850:    @section @command{missing} and @code{AM_MAINTAINER_MODE}
   9852:        @subsection @command{missing}
   9881:        @subsection @code{AM_MAINTAINER_MODE}

  10212:@node Flag Variables Ordering
  10213:    @section Flag Variables Ordering
  10234:        @subsection Compile Flag Variables
  10412:        @subsection Other Variables

  11726:@node Dependency Tracking Evolution
  11727:    @section Dependency Tracking in Automake
  11736:        @subsection First Take
  11737:            @unnumberedsubsubsec Description
  11751:            @unnumberedsubsubsec Bugs
  11787:            @unnumberedsubsubsec Historical Note
  11795:        @subsection Dependencies As Side Effects
  11796:            @unnumberedsubsubsec Description
  11815:            @unnumberedsubsubsec Bugs
  11844:        @subsection Dependencies for the User
  11845:            @unnumberedsubsubsec Description
  11873:            @unnumberedsubsubsec Bugs
  11944:        @subsection Techniques for Computing Dependencies
  11976:        @subsection Recommendations for Tool Writers
  11987:        @subsection Future Directions for Automake's Dependency Tracking




reply via email to

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