[Top][All Lists]
[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
- sections without nodes in automake manual?,
Karl Berry <=