Improve confusing section names.

* doc/autoconf.texi (Specifying Names): Rename node...
(Specifying Target Triplets): ...to this.
(Generic Programs): Adjust references.
* doc/install.texi (System Type): Touch up formatting.
* THANKS: Update.
Reported by Tim Freeman, in http://bugs.debian.org/312873.

Signed-off-by: Eric Blake <ebb9@byu.net>

diff --git a/ChangeLog b/ChangeLog
index 8f9cd54bd48834ada4cee20b473c73aee7bf2e00..9a5fd5d0630967d2f5999d7795dbeda12dc13e84 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,13 @@
 2009-03-17  Eric Blake  <ebb9@byu.net>
 
+       Improve confusing section names.
+       * doc/autoconf.texi (Specifying Names): Rename node...
+       (Specifying Target Triplets): ...to this.
+       (Generic Programs): Adjust references.
+       * doc/install.texi (System Type): Touch up formatting.
+       * THANKS: Update.
+       Reported by Tim Freeman, in http://bugs.debian.org/312873.
+
        Remove historical inaccuracy.
        * doc/autoconf.texi (Portable Shell): Don't perpetuate myth about
        #!/bin/sh needing a space.

diff --git a/THANKS b/THANKS
index 5cb10cbf1dc4f1ab4dbd6f56974882bace52d906..c3e19a20b8f6f3e3171b7e21db9f86ec9e89f477 100644 (file)
--- a/THANKS
+++ b/THANKS
@@ -342,6 +342,7 @@ Ted Bullock                 tbullock@canada.com
 Theodore Ts'o               tytso@mit.edu
 Thien-Thi Nguyen            ttn@gnu.org
 Thomas Winder               tom@vlsivie.tuwien.ac.at
+Tim Freeman                 tim@fungible.com
 Tim Mooney                  mooney@dogbert.cc.ndsu.NoDak.edu
 Tim Rice                    tim@multitalents.net
 Tim Van Holder              tim.van.holder@pandora.be

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 874d1392e616d548c0716b6141410bbb71a212fe..e821cbd4be5478eb0b39e48545834dd2fbe9340c 100644 (file)
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -537,7 +537,7 @@ Portable C and C++ Programming
 
 Manual Configuration
 
-* Specifying Names::            Specifying the system type
+* Specifying Target Triplets::  Specifying target triplets
 * Canonicalizing::              Getting the canonical system type
 * Using System Type::           What to do with the system type
 
@@ -4058,7 +4058,7 @@ with a prefix of the target type as determined by
 If the tool cannot be found with a prefix, and if the build and target
 types are equal, then it is also searched for without a prefix.
 
-As noted in @ref{Specifying Names, , Specifying the system type}, the
+As noted in @ref{Specifying Target Triplets}, the
 target is rarely specified, because most of the time it is the same
 as the host: it is the type of system for which any compiler tool in
 the package produces code.  What this macro looks for is,
@@ -4084,8 +4084,7 @@ sets @code{RANLIB} to @file{i386-gnu-ranlib} if that program exists in
 
 When cross-compiling, this macro will issue a warning if no program
 prefixed with the host type could be found.
-For more information, see @ref{Specifying Names, , Specifying the
-system type}.
+For more information, see @ref{Specifying Target Triplets}.
 @end defmac
 
 @defmac AC_CHECK_TARGET_TOOLS (@var{variable}, @var{progs-to-check-for}, @
@@ -4118,8 +4117,7 @@ is not changed.  Calls @code{AC_SUBST} for @var{variable}.
 
 When cross-compiling, this macro will issue a warning if no program
 prefixed with the host type could be found.
-For more information, see @ref{Specifying Names, , Specifying the
-system type}.
+For more information, see @ref{Specifying Target Triplets}.
 @end defmac
 
 @anchor{AC_PATH_PROG}
@@ -4197,8 +4195,7 @@ name of the program if it is found.
 
 When cross-compiling, this macro will issue a warning if no program
 prefixed with the host type could be found.
-For more information, see @ref{Specifying Names, , Specifying the
-system type}.
+For more information, see @ref{Specifying Target Triplets}.
 @end defmac
 
 
@@ -18972,18 +18969,22 @@ looking for libraries that are unique to particular systems.  However,
 Autoconf provides a uniform method for handling unguessable features.
 
 @menu
-* Specifying Names::            Specifying the system type
+* Specifying Target Triplets::  Specifying target triplets
 * Canonicalizing::              Getting the canonical system type
 * Using System Type::           What to do with the system type
 @end menu
 
-@node Specifying Names
-@section Specifying the System Type
+@node Specifying Target Triplets
+@section Specifying target triplets
 @cindex System type
+@cindex Target triplet
+@c This node used to be named Specifying Names.  The @anchor allows old
+@c links to still work.
+@anchor{Specifying Names}
 
 Autoconf-generated
 @command{configure} scripts can make decisions based on a canonical name
-for the system type, which has the form:
+for the system type, or @dfn{target triplet}, which has the form:
 @samp{@var{cpu}-@var{vendor}-@var{os}}, where @var{os} can be
 @samp{@var{system}} or @samp{@var{kernel}-@var{system}}
 
@@ -18993,7 +18994,8 @@ system it's running on.  To do so it runs a script called
 command or symbols predefined by the C preprocessor.
 
 Alternately, the user can specify the system type with command line
-arguments to @command{configure}.  Doing so is necessary when
+arguments to @command{configure} (@pxref{System Type}.  Doing so is
+necessary when
 cross-compiling.  In the most complex case of cross-compiling, three
 system types are involved.  The options to specify them are:
 

diff --git a/doc/install.texi b/doc/install.texi
index d498639ff8c3b9692220660176d18429e8ef2fbf..a51882cac3068547970270db92b3a85b7caf2a2d 100644 (file)
--- a/doc/install.texi
+++ b/doc/install.texi
@@ -7,7 +7,7 @@
 @unnumbered Installation Instructions
 
 Copyright @copyright{} 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004,
-2005, 2006, 2007, 2008 Free Software Foundation, Inc.
+2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
 
 This file is free documentation; the Free Software Foundation gives
 unlimited permission to copy, distribute and modify it.
@@ -242,7 +242,8 @@ which has the form:
 where @var{system} can have one of these forms:
 
 @example
-@var{os} @var{kernel}-@var{os}
+@var{os}
+@var{kernel}-@var{os}
 @end example
 
 See the file @file{config.sub} for the possible values of each field.