[PATCH] Fixes for autoconf.texi

[Art Haas]

Hi.

Here's a patch that fixes a couple of things in the autoconf
documentation.

* AC_HELP_STRING is replaced with AS_HELP_STRING, and AC_HELP_STRING is
  added to the obsolete macros section.
* typo 'ellaborate' -> 'elaborate'. A possibly better word in this
  sentence would be "complex".
* Added '@.' for sentences that ended in a capital letter. The texinfo
  docs had some stuff about this do indicate the capital is not an
  initial. I don't generate printed output from the texinfo source, so I
  don't know if this changes makes any difference or not.

Art Haas

Index: autoconf.texi
===================================================================
RCS file: /cvsroot/autoconf/autoconf/doc/autoconf.texi,v
retrieving revision 1.733
diff -u -u -r1.733 autoconf.texi
--- autoconf.texi       14 May 2003 08:29:04 -0000      1.733
+++ autoconf.texi       19 May 2003 19:22:18 -0000
@@ -5558,7 +5558,7 @@
 As discussed above for @code{AC_F77_DUMMY_MAIN}, many Fortran libraries
 allow you to provide an entry point called (say) @code{MAIN__} instead of
 the usual @code{main}, which is then called by a @code{main} function in
-the Fortran libraries that initializes things like Fortran I/O.  The
+the Fortran libraries that initializes things like Fortran I/address@hidden  
The
 @code{AC_F77_MAIN} macro detects whether it is @emph{possible} to
 utilize such an alternate main function, and defines @code{F77_MAIN} to
 the name of the function.  (If no alternate main function name is found,
@@ -6186,7 +6186,7 @@
 
 The macro @code{AC_TRY_CPP} (@pxref{Obsolete Macros}) used to play the
 role of @code{AC_PREPROC_IFELSE}, but double quotes its argument, making
-it impossible to use it to ellaborate sources.  You are encouraged to
+it impossible to use it to elaborate sources.  You are encouraged to
 get rid of your old use of the macro @code{AC_TRY_CPP} in favor of
 @code{AC_PREPROC_IFELSE}, but, in the first place, are you sure you need
 to run the @emph{preprocessor} and not the compiler?
@@ -6357,7 +6357,7 @@
 @table @asis
 @item Darwin
 @cindex Darwin
-Darwin is also known as Mac OS X.  Beware that the file system @emph{can} be
+Darwin is also known as Mac OS address@hidden  Beware that the file system 
@emph{can} be
 case-preserving, but case insensitive.  This can cause nasty problems,
 since for instance the installation attempt for a package having an
 @file{INSTALL} file can result in @samp{make install} report that
@@ -6366,7 +6366,7 @@
 That's all dependent on whether the file system is a UFS (case
 sensitive) or HFS+ (case preserving).  By default Apple wants you to
 install the OS on HFS+.  Unfortunately, there are some pieces of
-software which really need to be built on UFS.  We may want to rebuild
+software which really need to be built on address@hidden  We may want to 
rebuild
 Darwin to have both UFS and HFS+ available (and put the /local/build
 tree on the UFS).
 
@@ -9153,7 +9153,7 @@
 
 The traditional way to work around this portability problem is to use
 @address@hidden"$@@"@}}.  Unfortunately this method does not work with
-Zsh (3.x and 4.x), which is used on Mac OS X.  When emulating
+Zsh (3.x and 4.x), which is used on Mac OS address@hidden  When emulating
 the Bourne shell, Zsh performs word splitting on @address@hidden"$@@"@}}:
 
 @example
@@ -10310,7 +10310,7 @@
 
 @noindent
 Either do not depend on such patterns (i.e., use @samp{/^(.*foo|bar)/},
-or use a simple test to reject such AWK.
+or use a simple test to reject such address@hidden
 
 
 @item @command{cat}
@@ -11878,7 +11878,7 @@
 spaces.
 
 You should format your @var{help-string} with the macro
address@hidden (@pxref{Pretty Help Strings}).
address@hidden (@pxref{Pretty Help Strings}).
 @end defmac
 
 @defmac AC_WITH (@var{package}, @var{action-if-given}, 
@ovar{action-if-not-given})
@@ -11946,7 +11946,7 @@
 (@pxref{External Software}).
 
 You should format your @var{help-string} with the macro
address@hidden (@pxref{Pretty Help Strings}).
address@hidden (@pxref{Pretty Help Strings}).
 @end defmac
 
 @defmac AC_ENABLE (@var{feature}, @var{action-if-given}, 
@ovar{action-if-not-given})
@@ -11964,9 +11964,9 @@
 (@pxref{Package Options}) can be challenging.  Specifically, you want
 your own @samp{help strings} to line up in the appropriate columns of
 @samp{configure --help} just like the standard Autoconf @samp{help
-strings} do.  This is the purpose of the @code{AC_HELP_STRING} macro.
+strings} do.  This is the purpose of the @code{AS_HELP_STRING} macro.
 
address@hidden AC_HELP_STRING (@var{left-hand-side}, @var{right-hand-side})
address@hidden AS_HELP_STRING (@var{left-hand-side}, @var{right-hand-side})
 @acindex{HELP_STRING}
 
 Expands into an help string that looks pretty when the user executes
@@ -11977,14 +11977,14 @@
 @example
 AC_DEFUN([TEST_MACRO],
 [AC_ARG_WITH([foo],
-             AC_HELP_STRING([--with-foo],
+             AS_HELP_STRING([--with-foo],
                             [use foo (default is NO)]),
              [ac_cv_use_foo=$withval], [ac_cv_use_foo=no])
 AC_CACHE_CHECK([whether to use foo],
                [ac_cv_use_foo], [ac_cv_use_foo=no])])
 @end example
 
-Please note that the call to @code{AC_HELP_STRING} is @strong{unquoted}.
+Please note that the call to @code{AS_HELP_STRING} is @strong{unquoted}.
 Then the last few lines of @samp{configure --help} will appear like
 this:
 
@@ -11993,14 +11993,14 @@
   --with-foo              use foo (default is NO)
 @end example
 
-The @code{AC_HELP_STRING} macro is particularly helpful when the
+The @code{AS_HELP_STRING} macro is particularly helpful when the
 @var{left-hand-side} and/or @var{right-hand-side} are composed of macro
 arguments, as shown in the following example.
 
 @example
 AC_DEFUN(MY_ARG_WITH,
 [AC_ARG_WITH([$1],
-             AC_HELP_STRING([--with-$1], [use $1 (default is $2)]),
+             AS_HELP_STRING([--with-$1], [use $1 (default is $2)]),
              ac_cv_use_$1=$withval, ac_cv_use_$1=no),
 AC_CACHE_CHECK(whether to use $1, ac_cv_use_$1, ac_cv_use_$1=$2)])
 @end example
@@ -12806,7 +12806,7 @@
 
 These days portable programs should use @code{waitpid}, not
 @code{wait3}, as @code{wait3} is being removed from the Open Group
-standards, and will not appear in the next revision of POSIX.
+standards, and will not appear in the next revision of address@hidden
 @end defmac
 
 @defmac AC_GCC_TRADITIONAL
@@ -12858,6 +12858,11 @@
 @code{AC_EGREP_HEADER}
 @end defmac
 
address@hidden AC_HELP_STRING
address@hidden
address@hidden
address@hidden defmac
+
 @defmac AC_INIT (@var{unique-file-in-source-dir})
 @acindex{INIT}
 Formerly @code{AC_INIT} used to have a single argument, and was
-- 
To announce that there must be no criticism of the President, or that we
are to stand by the President, right or wrong, is not only unpatriotic
and servile, but is morally treasonable to the American public.
 -- Theodore Roosevelt, Kansas City Star, 1918