autoconf-patches
[Top][All Lists]
Advanced

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

autoconf.texi minor typo patches


From: Paul Eggert
Subject: autoconf.texi minor typo patches
Date: Wed, 11 Sep 2002 23:12:17 -0700 (PDT)

My previous autoconf.texi patch introduced a misspelling
"compatiblity" so in penance I spell- and typo-checked the whole
document, and installed the following patch.  Most of the changes are
white-space fixes, e.g., standardizing on two spaces after a sentence.

2002-09-11  Paul Eggert  <address@hidden>

        * doc/autoconf.texi: Fix minor formatting, spelling, and
        grammatical typos.

Index: autoconf.texi
===================================================================
RCS file: /cvsroot/autoconf/autoconf/doc/autoconf.texi,v
retrieving revision 1.672
retrieving revision 1.673
diff -p -u -r1.672 -r1.673
--- autoconf.texi       11 Sep 2002 19:03:59 -0000      1.672
+++ autoconf.texi       12 Sep 2002 05:58:03 -0000      1.673
@@ -590,7 +590,7 @@ The ubiquity of @command{make} means tha
 only viable way to distribute automatic build rules for software, but
 one quickly runs into @command{make}'s numerous limitations.  Its lack of
 support for automatic dependency tracking, recursive builds in
-subdirectories, reliable timestamps (e.g. for network filesystems), and
+subdirectories, reliable timestamps (e.g., for network filesystems), and
 so on, mean that developers must painfully (and often incorrectly)
 reinvent the wheel for each project.  Portability is non-trivial, thanks
 to the quirks of @command{make} on many systems.  On top of all this is the
@@ -623,7 +623,7 @@ in @file{/usr/local/bin} (or whatever pr
 
 Automake may require that additional tools be present on the
 @emph{developer's} machine.  For example, the @code{Makefile.in} that
-the developer works with may not be portable (e.g. it might use special
+the developer works with may not be portable (e.g., it might use special
 features of your compiler to automatically generate dependency
 information).  Running @code{make dist}, however, produces a
 @file{hello-1.0.tar.gz} package (or whatever the program/version is)
@@ -854,7 +854,7 @@ There are two obvious possibilities: cre
 extending an existing one.  The former option is very attractive: all
 sorts of optimizations could easily be implemented in the compiler and
 many rigorous checks could be performed on the Autoconf program
-(e.g. rejecting any non-portable construct).  Alternatively, you can
+(e.g., rejecting any non-portable construct).  Alternatively, you can
 extend an existing language, such as the @code{sh} (Bourne shell)
 language.
 
@@ -1213,7 +1213,7 @@ disable warnings falling into @var{categ
 
 Warnings about @samp{syntax} are enabled by default, and the environment
 variable @code{WARNINGS}, a comma separated list of categories, is
-honored. @samp{autoconf -W @var{category}} will actually
+honored.  @samp{autoconf -W @var{category}} will actually
 behave as if you had run:
 
 @example
@@ -1311,7 +1311,7 @@ The @var{num}th argument of the call to 
 @itemx address@hidden@address@hidden@@
 All the arguments passed to @var{macro}, separated by the character
 @var{sep} or the string @var{separator} (@samp{,} by default).  Each
-argument is quoted, i.e. enclosed in a pair of square brackets.
+argument is quoted, i.e., enclosed in a pair of square brackets.
 
 @item $*
 @itemx address@hidden
@@ -1395,7 +1395,7 @@ AUTOMAKE|:::::|automake|:::::|$missing_d
 
 Installing the various components of the @sc{gnu} Build System can be
 tedious: running @command{autopoint} for Gettext, @command{automake} for
address@hidden etc. in each directory.  It may be needed either
address@hidden etc.@: in each directory.  It may be needed either
 because some tools such as @command{automake} have been updated on your
 system, or because some of the sources such as @file{configure.ac} have
 been updated, or finally, simply in order to install the @sc{gnu} Build
@@ -1775,7 +1775,7 @@ and use this instead:
 
 The macros @code{AC_CONFIG_FILES} and @code{AC_CONFIG_HEADERS} use
 special @var{tag}s: they may have the form @address@hidden or
address@hidden@var{output}:@var{inputs}}. The file @var{output} is instantiated
address@hidden@var{output}:@var{inputs}}.  The file @var{output} is instantiated
 from its templates, @var{inputs} (defaulting to @address@hidden).
 
 For instance
@@ -2175,7 +2175,7 @@ The directory for installing C header fi
 
 @defvar prefix
 @ovindex prefix
-The common installation prefix for all files. If @var{exec_prefix}
+The common installation prefix for all files.  If @var{exec_prefix}
 is defined to a different value, @var{prefix} is used only for
 architecture-independent files.
 @end defvar
@@ -2226,8 +2226,8 @@ current value of @code{prefix}.
 
 A corollary is that you should not use these variables except in
 Makefiles.  For instance, instead of trying to evaluate @code{datadir}
-in @file{configure} and hardcoding it in Makefiles using
-e.g. @samp{AC_DEFINE_UNQUOTED(DATADIR, "$datadir")}, you should add
+in @file{configure} and hard-coding it in Makefiles using
+e.g., @samp{AC_DEFINE_UNQUOTED(DATADIR, "$datadir")}, you should add
 @samp{-DDATADIR="$(datadir)"} to your @code{CPPFLAGS}.
 
 Similarly you should not rely on @code{AC_OUTPUT_FILES} to replace
@@ -2239,8 +2239,8 @@ Makefile snippet similar to:
 @example
 @group
 edit = sed \
-       -e 's,@@datadir\@@,$(pkgdatadir),g' \
-       -e 's,@@prefix\@@,$(prefix),g'
+        -e 's,@@datadir\@@,$(pkgdatadir),g' \
+        -e 's,@@prefix\@@,$(prefix),g'
 @end group
 
 autoconf autoheader: Makefile
@@ -2488,7 +2488,7 @@ directives:
 #if HAVE_UNISTD_H
 # include <unistd.h>
 #else
-/* We are in trouble. */
+/* We are in trouble.  */
 #endif
 @end group
 @end example
@@ -2578,7 +2578,7 @@ Prepend @var{dir} to include path.  Mult
 @itemx -W @var{category}
 @evindex WARNINGS
 Report the warnings related to @var{category} (which can actually be a
-comma separated list). Current categories include:
+comma separated list).  Current categories include:
 
 @table @samp
 @item obsolete
@@ -2811,10 +2811,10 @@ fi
 @end example
 
 If a given @var{dir} contains @command{configure.gnu}, it is run instead
-of @command{configure}. This is for packages that might use a
+of @command{configure}.  This is for packages that might use a
 non-Autoconf script @command{Configure}, which can't be called through a
 wrapper @command{configure} since it would be the same file on
-case-insensitive filesystems. Likewise, if a @var{dir} contains
+case-insensitive filesystems.  Likewise, if a @var{dir} contains
 @file{configure.ac} but no @command{configure}, the Cygnus
 @command{configure} script found by @code{AC_CONFIG_AUX_DIR} is used.
 
@@ -3212,7 +3212,7 @@ AC_PATH_PROG([INETD], [inetd], [/usr/lib
 @end example
 
 You are strongly encouraged to declare the @var{variable} passed to
address@hidden etc. as precious, @xref{Setting Output Variables},
address@hidden etc.@: as precious, @xref{Setting Output Variables},
 @code{AC_ARG_VAR}, for more details.
 
 @defmac AC_CHECK_PROG (@var{variable}, @var{prog-to-check-for}, 
@var{value-if-found}, @ovar{value-if-not-found}, @ovar{path},  @ovar{reject})
@@ -3259,9 +3259,9 @@ sets @code{RANLIB} to @file{i386-gnu-ran
 Like @code{AC_CHECK_TOOL}, each of the tools in the list
 @var{progs-to-check-for} are checked with a prefix of the host type as
 determined by @code{AC_CANONICAL_HOST}, followed by a dash
-(@pxref{Canonicalizing}). If none of the tools can be found with a
-prefix, then the first one without a prefix is used. If a tool is found,
-set @var{variable} to the name of that program. If none of the tools in
+(@pxref{Canonicalizing}).  If none of the tools can be found with a
+prefix, then the first one without a prefix is used.  If a tool is found,
+set @var{variable} to the name of that program.  If none of the tools in
 the list are found, set @var{variable} to @var{value-if-not-found}; if
 @var{value-if-not-found} is not specified, the value of @var{variable}
 is not changed.  Calls @code{AC_SUBST} for @var{variable}.
@@ -3332,19 +3332,19 @@ with the library succeeds; @var{action-i
 commands to run if the link fails.  If @var{action-if-found} is not
 specified, the default action will prepend @address@hidden to
 @code{LIBS} and define @address@hidden (in all
-capitals). This macro is intended to support building of @code{LIBS} in
+capitals).  This macro is intended to support building of @code{LIBS} in
 a right-to-left (least-dependent to most-dependent) fashion such that
 library dependencies are satisfied as a natural side-effect of
-consecutive tests. Some linkers are very sensitive to library ordering
+consecutive tests.  Some linkers are very sensitive to library ordering
 so the order in which @code{LIBS} is generated is important to reliable
 detection of libraries.
 
 If linking with @var{library} results in unresolved symbols that would
 be resolved by linking with additional libraries, give those libraries
 as the @var{other-libraries} argument, separated by spaces:
-e.g. @option{-lXt -lX11}.  Otherwise, this macro will fail to detect
+e.g., @option{-lXt -lX11}.  Otherwise, this macro will fail to detect
 that @var{library} is present, because linking the test program will
-always fail with unresolved symbols. The @var{other-libraries} argument
+always fail with unresolved symbols.  The @var{other-libraries} argument
 should be limited to cases where it is desirable to test for one library
 in the presence of another that is not already in @code{LIBS}.
 @end defmac
@@ -3363,7 +3363,7 @@ function is not found, run @var{action-i
 If linking with @var{library} results in unresolved symbols that would
 be resolved by linking with additional libraries, give those libraries
 as the @var{other-libraries} argument, separated by spaces:
-e.g. @option{-lXt -lX11}.  Otherwise, this macro will fail to detect
+e.g., @option{-lXt -lX11}.  Otherwise, this macro will fail to detect
 that @var{function} is present, because linking the test program will
 always fail with unresolved symbols.
 @end defmac
@@ -3425,7 +3425,7 @@ instance) they return the buffer pointer
 @item @code{sscanf}
 @c @fuindex sscanf
 @prindex @code{sscanf}
-On various old systems, e.g. HP-UX 9, @code{sscanf} requires that its
+On various old systems, e.g., HP-UX 9, @code{sscanf} requires that its
 input string be writable (though it doesn't actually change it).  This
 can be a problem when using @command{gcc} since it normally puts
 constant strings in read-only memory
@@ -3467,7 +3467,7 @@ up being written to after the OS has rem
 @prindex @code{va_copy}
 The ISO C99 standard provides @code{va_copy} for copying
 @code{va_list} variables.  It may be available in older environments
-too, though possibly as @code{__va_copy} (eg. @command{gcc} in strict
+too, though possibly as @code{__va_copy} (e.g., @command{gcc} in strict
 C89 mode).  These can be tested with @code{#ifdef}.  A fallback to
 @code{memcpy (&dst, &src, sizeof(va_list))} will give maximum
 portability.
@@ -3476,11 +3476,11 @@ portability.
 @c @fuindex va_list
 @prindex @code{va_list}
 @code{va_list} is not necessarily just a pointer.  It can be a
address@hidden (eg. @command{gcc} on Alpha), which means @code{NULL} is
-not portable.  Or it can be an array (eg. @command{gcc} in some
address@hidden (e.g., @command{gcc} on Alpha), which means @code{NULL} is
+not portable.  Or it can be an array (e.g., @command{gcc} in some
 PowerPC configurations), which means as a function parameter it can be
 effectively call-by-reference and library routines might modify the
-value back in the caller (eg. @code{vsnprintf} in the GNU C Library
+value back in the caller (e.g., @code{vsnprintf} in the GNU C Library
 2.1).
 
 @item Signed @code{>>}
@@ -3616,16 +3616,16 @@ Library 2.1.
 @prindex @code{fork}
 @c @fuindex vfork
 @prindex @code{vfork}
-This macro checks for the @code{fork} and @code{vfork} functions. If a
-working @code{fork} is found, define @code{HAVE_WORKING_FORK}. This macro
+This macro checks for the @code{fork} and @code{vfork} functions.  If a
+working @code{fork} is found, define @code{HAVE_WORKING_FORK}.  This macro
 checks whether @code{fork} is just a stub by trying to run it.
 
-If @file{vfork.h} is found, define @code{HAVE_VFORK_H}. If a working
address@hidden is found, define @code{HAVE_WORKING_VFORK}. Otherwise,
+If @file{vfork.h} is found, define @code{HAVE_VFORK_H}.  If a working
address@hidden is found, define @code{HAVE_WORKING_VFORK}.  Otherwise,
 define @code{vfork} to be @code{fork} for backward compatibility with
-previous versions of @command{autoconf}. This macro checks for several known
+previous versions of @command{autoconf}.  This macro checks for several known
 errors in implementations of @code{vfork} and considers the system to not
-have a working @code{vfork} if it detects any of them. It is not considered
+have a working @code{vfork} if it detects any of them.  It is not considered
 to be an implementation error if a child's invocation of @code{signal}
 modifies the parent's signal handler, since child processes rarely change
 their signal handlers.
@@ -4093,7 +4093,7 @@ simply call @code{AC_LIBOBJ} with litera
 
 Note that this macro replaces the obsolete @code{AC_LIBOBJ_DECL}, with
 slightly different semantics: the old macro took the function name,
-e.g. @code{foo}, as its argument rather than the file name.
+e.g., @code{foo}, as its argument rather than the file name.
 @end defmac
 
 @defmac AC_LIBSOURCES (@var{files})
@@ -4161,11 +4161,11 @@ problem they cause.  By definition, this
 additions.  Please help us keeping it as complete as possible.
 
 @table @asis
address@hidden @file{inttypes.h} vs. @file{stdint.h}
address@hidden @file{inttypes.h} vs.@: @file{stdint.h}
 Paul Eggert notes that: ISO C 1999 says that @file{inttypes.h} includes
 @file{stdint.h}, so there's no need to include @file{stdint.h}
 separately in a standard environment.  Many implementations have
address@hidden but not @file{stdint.h} (e.g. Solaris 7), but I don't
address@hidden but not @file{stdint.h} (e.g., Solaris 7), but I don't
 know of any implementation that has @file{stdint.h} but not
 @file{inttypes.h}.  Nor do I know of any free software that includes
 @file{stdint.h}; @file{stdint.h} seems to be a creation of the committee.
@@ -4240,7 +4240,7 @@ If @file{sys/types.h} does not define @c
 @defmac AC_HEADER_STAT
 @acindex HEADER_STAT
 @acindex STAT_MACROS_BROKEN
-If the macros @code{S_ISDIR}, @code{S_ISREG} et al. defined in
+If the macros @code{S_ISDIR}, @code{S_ISREG}, etc.@: defined in
 @file{sys/stat.h} do not work properly (returning false positives),
 define @code{STAT_MACROS_BROKEN}.  This is the case on Tektronix UTekV,
 Amdahl UTS and Motorola System V/88.
@@ -5244,13 +5244,13 @@ making sure to first set the current lan
 @defmac AC_F77_LIBRARY_LDFLAGS
 @acindex F77_LIBRARY_LDFLAGS
 @ovindex FLIBS
-Determine the linker flags (e.g. @option{-L} and @option{-l}) for the
+Determine the linker flags (e.g., @option{-L} and @option{-l}) for the
 @dfn{Fortran 77 intrinsic and run-time libraries} that are required to
 successfully link a Fortran 77 program or shared library.  The output
 variable @code{FLIBS} is set to these flags.
 
 This macro is intended to be used in those situations when it is
-necessary to mix, e.g. C++ and Fortran 77 source code into a single
+necessary to mix, e.g., C++ and Fortran 77 source code into a single
 program or shared library (@pxref{Mixing Fortran 77 With C and C++,,,
 automake, GNU Automake}).
 
@@ -5277,7 +5277,7 @@ also be necessary to link C/C++ with For
 With many compilers, the Fortran libraries detected by
 @code{AC_F77_LIBRARY_LDFLAGS} provide their own @code{main} entry
 function that initializes things like Fortran I/O, and which then calls
-a user-provided entry function named e.g. @code{MAIN__} to run the
+a user-provided entry function named (say) @code{MAIN__} to run the
 user's program.  The @code{AC_F77_DUMMY_MAIN} or @code{AC_F77_MAIN}
 macro figures out how to deal with this interaction.
 
@@ -5291,7 +5291,7 @@ variable @code{F77_DUMMY_MAIN} holds thi
 solution was found, and @code{none} when no such dummy main is needed.
 
 By default, @var{action-if-found} defines @code{F77_DUMMY_MAIN} to the
-name of this routine (e.g. @code{MAIN__}) @emph{if} it is required.
+name of this routine (e.g., @code{MAIN__}) @emph{if} it is required.
 @ovar{action-if-not-found} defaults to exiting with an error.
 
 In order to link with Fortran routines, the user's C/C++ program should
@@ -5316,7 +5316,7 @@ unless one wants to change the default a
 @acindex F77_MAIN
 @cvindex F77_MAIN
 As discussed above for @code{AC_F77_DUMMY_MAIN}, many Fortran libraries
-allow you to provide an entry point called e.g. @code{MAIN__} instead of
+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
 @code{AC_F77_MAIN} macro detects whether it is @emph{possible} to
@@ -5375,7 +5375,7 @@ Although Autoconf tries to be intelligen
 name-mangling scheme of the Fortran 77 compiler, there may be Fortran 77
 compilers that it doesn't support yet.  In this case, the above code
 will generate a compile-time error, but some other behavior
-(e.g. disabling Fortran-related features) can be induced by checking
+(e.g., disabling Fortran-related features) can be induced by checking
 whether the @code{F77_FUNC} macro is defined.
 
 Now, to call that routine from a C program, we would do something like:
@@ -5388,7 +5388,7 @@ Now, to call that routine from a C progr
 @end example
 
 If the Fortran 77 identifier contains an underscore
-(e.g. @code{foo_bar}), you should use @code{F77_FUNC_} instead of
+(e.g., @code{foo_bar}), you should use @code{F77_FUNC_} instead of
 @code{F77_FUNC} (with the same arguments).  This is because some Fortran
 77 compilers mangle names differently if they contain an underscore.
 @end defmac
@@ -5603,7 +5603,7 @@ variable, back quote, and backslash subs
 @var{input}.
 
 This macro uses @code{CPPFLAGS}, but not @code{CFLAGS}, because
address@hidden, @option{-O}, etc. are not valid options to many C
address@hidden, @option{-O}, etc.@: are not valid options to many C
 preprocessors.
 @end defmac
 
@@ -5909,7 +5909,7 @@ That's all dependent on whether the file
 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
-darwin to have both UFS and HFS+ available (and put the /local/build
+Darwin to have both UFS and HFS+ available (and put the /local/build
 tree on the UFS).
 
 @item @sc{qnx 4.25}
@@ -5919,7 +5919,7 @@ tree on the UFS).
 @c QNX Neutrino.
 @sc{qnx} is a realtime operating system running on Intel architecture
 meant to be scalable from the small embedded systems to hundred
-processor super-computer.  It claims to be @sc{posix} certified. More
+processor super-computer.  It claims to be @sc{posix} certified.  More
 information is available on the @href{www.qnx.com, @sc{qnx} home page},
 including the @href{http://support.qnx.com/support/docs/qnx4/, @sc{qnx}
 man pages}.
@@ -5979,7 +5979,7 @@ AC_MSG_RESULT([$fstype])
 
 Autoconf-generated @command{configure} scripts check for the C compiler and
 its features by default.  Packages that use other programming languages
-(maybe more than one, e.g. C and C++) need to test features of the
+(maybe more than one, e.g., C and C++) need to test features of the
 compilers for the respective languages.  The following macros determine
 which programming language is used in the subsequent tests in
 @file{configure.ac}.
@@ -6105,7 +6105,7 @@ AC_DEFINE(EQUATION, "$a > $b")
 
 If neither @var{value} nor @var{description} are given, then
 @var{value} defaults to 1 instead of to the empty string.  This is for
-backwards compatiblity with older versions of Autoconf, but this usage
+backwards compatibility with older versions of Autoconf, but this usage
 is obsolescent and may be withdrawn in future versions of Autoconf.
 
 @end defmac
@@ -6318,7 +6318,7 @@ setting the variable @var{cache-id}, see
 
 It is very common to find buggy macros using @code{AC_CACHE_VAL} or
 @code{AC_CACHE_CHECK}, because people are tempted to call
address@hidden in the @var{commands-to-set-it}. Instead, the code that
address@hidden in the @var{commands-to-set-it}.  Instead, the code that
 @emph{follows} the call to @code{AC_CACHE_VAL} should call
 @code{AC_DEFINE}, by examining the value of the cache variable.  For
 instance, the following macro is broken:
@@ -6390,7 +6390,7 @@ For cache values used by the distributed
 @samp{ac}.
 
 @item @code{_cv_}
-Indicates that this shell variable is a cache value. This string
+Indicates that this shell variable is a cache value.  This string
 @emph{must} be present in the variable name, including the leading
 underscore.
 
@@ -6449,7 +6449,7 @@ use, instead of the usual per-program ca
 file will gradually accumulate information whenever someone runs a new
 @command{configure} script.  (Running @command{configure} merges the new cache
 results with the existing cache file.)  This may cause problems,
-however, if the system configuration (e.g. the installed libraries or
+however, if the system configuration (e.g., the installed libraries or
 compilers) changes and the stale cache file is not deleted.
 
 @node Cache Checkpointing
@@ -6552,7 +6552,7 @@ This macro prints nothing if @command{co
 
 @defmac AC_MSG_NOTICE (@var{message})
 @acindex MSG_NOTICE
-Deliver the @var{message} to the user. It is useful mainly to print a
+Deliver the @var{message} to the user.  It is useful mainly to print a
 general description of the overall purpose of a group of feature checks,
 e.g.,
 
@@ -7204,7 +7204,7 @@ disable warnings falling into @var{categ
 
 Warnings about @samp{syntax} are enabled by default, and the environment
 variable @code{WARNINGS}, a comma separated list of categories, is
-honored. @command{autom4te -W @var{category}} will actually
+honored.  @command{autom4te -W @var{category}} will actually
 behave as if you had run:
 
 @example
@@ -7343,7 +7343,7 @@ cumulative; instead, you should just mak
 needed.
 
 The @var{format} is a regular string, with newlines if desired, and
-several special escape codes.  It defaults to @samp{$f:$l:$n:$%}. It can
+several special escape codes.  It defaults to @samp{$f:$l:$n:$%}.  It can
 use the following special escapes:
 
 @table @samp
@@ -7371,7 +7371,7 @@ The @var{num}th argument of the call to 
 @itemx address@hidden@address@hidden@@
 All the arguments passed to @var{macro}, separated by the character
 @var{sep} or the string @var{separator} (@samp{,} by default).  Each
-argument is quoted, i.e. enclosed in a pair of square brackets.
+argument is quoted, i.e., enclosed in a pair of square brackets.
 
 @item $*
 @itemx address@hidden
@@ -7396,7 +7396,7 @@ not.
 Cache the traces of @var{macro}, but do not enable traces.  This is
 especially important to save cpu cycles in the future.  For instance,
 when invoked, @command{autoconf} preselects all the macros that
address@hidden, @command{automake}, @command{autoreconf} etc. will
address@hidden, @command{automake}, @command{autoreconf} etc.@: will
 trace, so that running @command{m4} is not needed to trace them: the
 cache suffices.  This results in a huge speed-up.
 @end table
@@ -7625,8 +7625,8 @@ scripts.  This name was coined by Lars J
 according to the Webster's Revised Unabridged Dictionary (1913):
 
 @quotation
-Mash \Mash\, n. [Akin to G. meisch, maisch, meische, maische, mash,
-wash, and prob. to AS. miscian to mix. See ``Mix''.]
+Mash \Mash\, n.  [Akin to G. meisch, maisch, meische, maische, mash,
+wash, and prob. to AS.@: miscian to mix.  See ``Mix''.]
 
 @enumerate 1
 @item
@@ -7637,7 +7637,7 @@ address@hidden
 A mixture of meal or bran and water fed to animals.
 
 @item
-A mess; trouble. [Obs.] --Beau. & Fl.
+A mess; trouble.  [Obs.] --Beau.@: & Fl.
 @end enumerate
 @end quotation
 
@@ -8249,7 +8249,7 @@ after the exclamation point in interpret
 
 @noindent
 If you omit the space before the path, then address@hidden based systems
-(such as Sequent DYNIX) will ignore the line, because they interpret
+(such as DYNIX) will ignore the line, because they interpret
 @samp{#! /} as a 4-byte magic number.  Some old systems have quite
 small limits on the length of the @samp{#!} line too, for instance 32
 bytes (not including the newline) on SunOS 4.
@@ -8297,7 +8297,7 @@ Below we describe some of the members of
 @cindex Ash
 @command{ash} is often used on @sc{gnu}/Linux and @sc{bsd} systems as a
 light-weight Bourne-compatible shell.  Ash 0.2 has some bugs that are
-fixed in the 0.3.x series, but portable shell scripts should workaround
+fixed in the 0.3.x series, but portable shell scripts should work around
 them, since version 0.2 is still shipped with many @sc{gnu}/Linux
 distributions.
 
@@ -8331,7 +8331,7 @@ Substitutions}, item ``Command Substitut
 @cindex Bash
 To detect whether you are running @command{bash}, test if
 @code{BASH_VERSION} is set.  To disable its extensions and require
address@hidden compatibility, run @samp{set -o posix}. @xref{Bash POSIX
address@hidden compatibility, run @samp{set -o posix}.  @xref{Bash POSIX
 Mode,, Bash @sc{posix} Mode, bash, The GNU Bash Reference Manual}, for
 details.
 
@@ -8356,7 +8356,7 @@ minimal OS install and therefore some fo
 To detect whether you are running @command{zsh}, test if
 @code{ZSH_VERSION} is set.  By default @command{zsh} is @emph{not}
 compatible with the Bourne shell: you have to run @samp{emulate sh} and
-set @code{NULLCMD} to @samp{:}. @xref{Compatibility,, Compatibility,
+set @code{NULLCMD} to @samp{:}.  @xref{Compatibility,, Compatibility,
 zsh, The Z Shell Manual}, for details.
 
 Zsh 3.0.8 is the native @command{/bin/sh} on Mac OS X 10.0.3.
@@ -8644,7 +8644,7 @@ as well.
 
 @item Invalid characters
 Some characters are invalid in @sc{dos} filenames, and should therefore
-be avoided. In a @sc{lfn} environment, these are @samp{/}, @samp{\},
+be avoided.  In a @sc{lfn} environment, these are @samp{/}, @samp{\},
 @samp{?}, @samp{*}, @samp{:}, @samp{<}, @samp{>}, @samp{|} and @samp{"}.
 In a @sc{sfn} environment, other characters are also invalid.  These
 include @samp{+}, @samp{,}, @samp{[} and @samp{]}.
@@ -8654,7 +8654,7 @@ include @samp{+}, @samp{,}, @samp{[} and
 @section Shell Substitutions
 
 Contrary to a persistent urban legend, the Bourne shell does not
-systematically split variables and backquoted expressions, in particular
+systematically split variables and back-quoted expressions, in particular
 on the right-hand side of assignments and in the argument of @code{case}.
 For instance, the following code:
 
@@ -8681,7 +8681,7 @@ first attempt, the computation of @code{
 since not all shells properly understand 
@code{"address@hidden"@dots{}"@dots{}`"}.
 Worse yet, not all shells understand @code{"address@hidden"@dots{}\"@dots{}`"}
 the same way.  There is just no portable way to use double-quoted
-strings inside double-quoted backquoted expressions (pfew!).
+strings inside double-quoted back-quoted expressions (pfew!).
 
 @table @code
 @item $@@
@@ -8700,7 +8700,7 @@ the Bourne shell, Zsh performs word spli
 
 @example
 zsh $ @kbd{emulate sh}
-zsh $ @kbd{for i in "$@"; do echo $i; done}
+zsh $ @kbd{for i in "$@@"; do echo $i; done}
 Hello World
 !
 zsh $ @kbd{for i in address@hidden"$@@"@}; do echo $i; done}
@@ -8792,7 +8792,7 @@ default="yu,yaa"
 
 @noindent
 will set @var{var} to @samp{M-yM-uM-,M-yM-aM-a}, i.e., the 8th bit of
-each char will be set. You won't observe the phenomenon using a simple
+each char will be set.  You won't observe the phenomenon using a simple
 @samp{echo $var} since apparently the shell resets the 8th bit when it
 expands $var.  Here are two means to make this shell confess its sins:
 
@@ -9216,7 +9216,7 @@ can be observed by using @command{set}.
 @node Limitations of Builtins
 @section Limitations of Shell Builtins
 
-No, no, we are serious: some shells do have limitations! :)
+No, no, we are serious: some shells do have limitations!  :)
 
 You should always keep in mind that any built-in or command may support
 options, and therefore have a very different behavior with arguments
@@ -9322,7 +9322,7 @@ which are not aiming at portability shou
 @samp{echo}.
 
 Don't expect any option.  @xref{Preset Output Variables}, @code{ECHO_N}
-etc. for a means to simulate @option{-c}.
+etc.@: for a means to simulate @option{-c}.
 
 Do not use backslashes in the arguments, as there is no consensus on
 their handling.  On @samp{echo '\n' | wc -l}, the @command{sh} of
@@ -9756,7 +9756,7 @@ fi
 $unset PS1 || PS1='$ '
 @end example
 
address@hidden Shell Variables}, for some neutralizing values. Also, see
address@hidden Shell Variables}, for some neutralizing values.  Also, see
 @ref{Limitations of Builtins}, documentation of @command{export}, for
 the case of environment variables.
 @end table
@@ -9940,7 +9940,7 @@ This handles a few subtleties in the sta
 @quotation
 No, under some older flavors of Unix, leading @samp{//} is a special
 path name: it refers to a ``super-root'' and is used to access other
-machines' files.  Leading @samp{///}, @samp{////}, etc. are equivalent
+machines' files.  Leading @samp{///}, @samp{////}, etc.@: are equivalent
 to @samp{/}; but leading @samp{//} is special.  I think this tradition
 started with Apollo Domain/OS, an OS that is still in use on some older
 hosts.
@@ -9961,7 +9961,7 @@ but many older hosts do not yet support 
 replacement @code{grep -E}.  To work around this problem, invoke
 @code{AC_PROG_EGREP} and then use @code{$EGREP}.
 
-The empty alternative is not portable, use @samp{?} instead. For
+The empty alternative is not portable, use @samp{?} instead.  For
 instance with Digital Unix v5.0:
 
 @example
@@ -10034,7 +10034,7 @@ expr a : b \| ''
 unfortunately this behaves exactly as the original expression, see the
 @address@hidden (@samp{:})} entry for more information.
 
-Older @command{expr} implementations (e.g. SunOS 4 @command{expr} and
+Older @command{expr} implementations (e.g., SunOS 4 @command{expr} and
 Solaris 8 @command{/usr/ucb/expr}) have a silly length limit that causes
 @command{expr} to fail if the matched substring is longer than 120
 bytes.  In this case, you might want to fall back on @samp{echo|sed} if
@@ -10069,7 +10069,7 @@ $ @kbd{expr 'a' : '\(a\)' || echo 'a' | 
 
 @noindent
 will output @samp{a} on most hosts, but @samp{aa} on @sc{qnx} 4.25.  A
-simple work around consists in testing @command{expr} and use a variable
+simple workaround consists in testing @command{expr} and use a variable
 set to @command{expr} or to @command{false} according to the result.
 
 
@@ -10084,7 +10084,7 @@ replacement @code{grep -F}.  To work aro
 
 @item @command{find}
 @c -----------------
-The option @option{-maxdepth} seems to be GNU specific. Tru64 v5.1,
+The option @option{-maxdepth} seems to be GNU specific.  Tru64 v5.1,
 NetBSD 1.5 and Solaris 2.5 @command{find} commands do not understand it.
 
 The replacement of @address@hidden@}} is guaranteed only if the argument is
@@ -10126,8 +10126,8 @@ are not available on old systems; use @s
 For versions of the DJGPP before 2.04, @command{ln} emulates soft links
 for executables by generating a stub that in turn calls the real
 program.  This feature also works with nonexistent files like in the
-Unix spec. So @samp{ln -s file link} will generate @file{link.exe},
-which will attempt to call @file{file.exe} if run. But this feature only
+Unix spec.  So @samp{ln -s file link} will generate @file{link.exe},
+which will attempt to call @file{file.exe} if run.  But this feature only
 works for executables, so @samp{cp -p} is used instead for these
 systems.  DJGPP versions 2.04 and later have full symlink support.
 
@@ -10189,7 +10189,7 @@ a critical section where neither the old
 Moving directories across mount points is not portable, use @command{cp}
 and @command{rm}.
 
-Moving/Deleting open files isn't portable. The following can't be done
+Moving/Deleting open files isn't portable.  The following can't be done
 on DOS/WIN32:
 
 @example
@@ -10228,7 +10228,7 @@ an input buffer limited to 4000 bytes.
 
 Alternation, @samp{\|}, is common but @sc{posix}.2 does not require its
 support, so it should be avoided in portable scripts.  Solaris 8
address@hidden does not support alternation; e.g. @samp{sed '/a\|b/d'}
address@hidden does not support alternation; e.g., @samp{sed '/a\|b/d'}
 deletes only lines that contain the literal string @samp{a|b}.
 
 Anchors (@samp{^} and @samp{$}) inside groups are not portable.
@@ -10318,7 +10318,7 @@ kept
 deleted
 @end example
 
-Why? When processing 1, a matches, therefore sets the t flag, b jumps to
+Why?  When processing 1, a matches, therefore sets the t flag, b jumps to
 d, and the output is produced.  When processing line 2, the t flag is
 still set (this is the bug).  Line a fails to match, but @command{sed}
 is not supposed to clear the t flag when a substitution fails.  Line b
@@ -10657,7 +10657,7 @@ prerequisite has been found in a @code{V
 @example
 VPATH = ../src
 .c.o:
-        cc -c $< -o $@
+        cc -c $< -o $@@
 @end example
 
 @noindent
@@ -10669,7 +10669,7 @@ This can be fixed as follows.
 @example
 VPATH = ../src
 .c.o:
-        cc -c `test -f $< || echo ../src/`$< -o $@
+        cc -c `test -f $< || echo ../src/`$< -o $@@
 @end example
 
 This kludge was introduced in Automake in 2000, but the exact context
@@ -10900,7 +10900,7 @@ Building ../bar.x
 @end example
 
 Another point worth mentioning is that once GNU @command{make} has
-decided to ignore a @code{VPATH} filename (e.g. it ignored
+decided to ignore a @code{VPATH} filename (e.g., it ignored
 @file{../bar.x} in the above example) it will continue to ignore it when
 the target occurs as a prerequisite of another rule.
 
@@ -11697,7 +11697,7 @@ Require that @var{file} be instantiated 
 @var{file} and @var{template} may be @samp{-} in which case the standard
 output and/or standard input, respectively, is used.  If a
 @var{template} filename is relative, it is first looked for in the build
-tree, and then in the source tree. @xref{Configuration Actions}, for
+tree, and then in the source tree.  @xref{Configuration Actions}, for
 more details.
 
 This option and the following ones provide one way for separately
@@ -11869,7 +11869,7 @@ if @file{./acconfig.h} contains the stri
 if @file{./acconfig.h} contains the string @samp{@@BOTTOM@@},
 @command{autoheader} copies the lines after that line to the end of the
 file it generates.  Either or both of those strings may be omitted.  An
-even older alternate way to produce the same effect in jurasik versions
+even older alternate way to produce the same effect in ancient versions
 of Autoconf is to create the files @address@hidden (typically
 @file{config.h.top}) and/or @address@hidden in the current
 directory.  If they exist, @command{autoheader} copies them to the
@@ -12125,7 +12125,7 @@ header file is found:
 
 @defmac AC_DYNIX_SEQ
 @acindex DYNIX_SEQ
-If on Dynix/PTX (Sequent @sc{unix}), add @option{-lseq} to output variable
+If on DYNIX/ptx, add @option{-lseq} to output variable
 @code{LIBS}.  This macro used to be defined as
 
 @example
@@ -12596,10 +12596,10 @@ now it just calls @code{AC_FUNC_STRFTIME
 @acindex SYS_RESTARTABLE_SYSCALLS
 @cvindex HAVE_RESTARTABLE_SYSCALLS
 If the system automatically restarts a system call that is interrupted
-by a signal, define @code{HAVE_RESTARTABLE_SYSCALLS}. This macro does
+by a signal, define @code{HAVE_RESTARTABLE_SYSCALLS}.  This macro does
 not check if system calls are restarted in general--it tests whether a
 signal handler installed with @code{signal} (but not @code{sigaction})
-causes system calls to be restarted. It does not test if system calls
+causes system calls to be restarted.  It does not test if system calls
 can be restarted when interrupted by signals that have no handler.
 
 These days portable programs should use @code{sigaction} with
@@ -13170,7 +13170,7 @@ configure as follows:
 
 
 @node AC_LIBOBJ vs LIBOBJS
address@hidden @code{AC_LIBOBJ} vs. @code{LIBOBJS}
address@hidden @code{AC_LIBOBJ} vs.@: @code{LIBOBJS}
 
 Up to Autoconf 2.13, the replacement of functions was triggered via the
 variable @code{LIBOBJS}.  Since Autoconf 2.50, the macro
@@ -13701,7 +13701,7 @@ Invoke @code{AC_CONFIG_TESTDIR}.
 @defmac AC_CONFIG_TESTDIR (@var{directory}, @dvar{test-path, @var{directory}})
 @acindex CONFIG_TESTDIR
 An Autotest test suite is to be configured in @var{directory}.  This
-macro requires the instanciation of @address@hidden/atconfig} from
+macro requires the instantiation of @address@hidden/atconfig} from
 @address@hidden/atconfig.in}, and sets the default
 @code{AUTOTEST_PATH} to @var{test-path} (@pxref{testsuite Invocation}).
 @end defmac
@@ -14000,7 +14000,7 @@ automate this task.  For instance, the m
 the @href{http://www.gnu.org/software/ac-archive/, Autoconf Macro
 Archive}.
 
-This solution is not conformant with the GNU Coding Standards.
+This solution does not conform to the GNU Coding Standards.
 
 @item
 Note that all the previous solutions hard wire the absolute path to




reply via email to

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