diff --git a/ChangeLog b/ChangeLog index 8f9cd54b..9a5fd5d0 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,13 @@ 2009-03-17 Eric Blake + 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 5cb10cbf..c3e19a20 100644 --- 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 874d1392..e821cbd4 100644 --- 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 d498639f..a51882ca 100644 --- 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.