changeset 17223:4e33322b32f8

Hyphen and dash fixes.
author Paul Eggert <eggert@cs.ucla.edu>
date Thu, 27 Dec 2012 01:16:25 -0800
parents 1c4d62fce4a1
children 9a6fffa64c3c
files doc/alloca-opt.texi doc/gcd.texi doc/gnulib-intro.texi doc/gnulib-tool.texi doc/gnulib.texi doc/havelib.texi doc/intprops.texi doc/lib-symbol-visibility.texi doc/parse-datetime.texi doc/posix-functions/ceil.texi doc/posix-functions/ceilf.texi doc/posix-functions/ceill.texi doc/posix-functions/chown.texi doc/posix-functions/expm1f.texi doc/posix-functions/iconv.texi doc/posix-functions/iconv_open.texi doc/posix-functions/log1pf.texi doc/posix-functions/lseek.texi doc/posix-functions/pthread_sigmask.texi doc/posix-functions/realpath.texi doc/posix-functions/round.texi doc/posix-functions/roundf.texi doc/posix-functions/roundl.texi doc/posix-functions/strerror_r.texi doc/posix-functions/strtod.texi doc/posix-functions/truncl.texi doc/posix-functions/write.texi doc/posix-headers/sys_select.texi doc/safe-alloc.texi doc/warnings.texi
diffstat 30 files changed, 72 insertions(+), 70 deletions(-) [+]
line wrap: on
line diff
--- a/doc/alloca-opt.texi
+++ b/doc/alloca-opt.texi
@@ -22,7 +22,7 @@
 The user can @code{#include <alloca.h>} on all platforms, and use
 @code{alloca} on those platforms where the preprocessor macro HAVE_ALLOCA
 evaluates to true. If HAVE_ALLOCA is false, the code should use a heap-based
-memory allocation based on @code{malloc} or - in C++ - @code{new}. Note that
+memory allocation based on @code{malloc} or (in C++) @code{new}. Note that
 the @code{#include <alloca.h>} must be the first one after the
 autoconf-generated @file{config.h}, for AIX 3 compatibility. Thanks to IBM for
 this nice restriction!
--- a/doc/gcd.texi
+++ b/doc/gcd.texi
@@ -35,8 +35,8 @@
 If you need the least common multiple of two numbers, it can be computed
 like this: @code{lcm(a,b) = (a / gcd(a,b)) * b} or
 @code{lcm(a,b) = a * (b / gcd(a,b))}.
-Avoid the formula @code{lcm(a,b) = (a * b) / gcd(a,b)} because - although
-mathematically correct - it can yield a wrong result, due to integer overflow.
+Avoid the formula @code{lcm(a,b) = (a * b) / gcd(a,b)} because---although
+mathematically correct---it can yield a wrong result, due to integer overflow.
 
 In some applications it is useful to have a function taking the gcd of two
 signed numbers. In this case, the gcd function result is usually normalized
--- a/doc/gnulib-intro.texi
+++ b/doc/gnulib-intro.texi
@@ -60,8 +60,8 @@
 There is no clear borderline between both areas.
 
 For example, Gnulib has a facility for generating the name of backup
-files.  While this task is entirely at the application level --- no
-standard specifies an API for it --- the na@"{@dotless{i}}ve code has
+files.  While this task is entirely at the application level---no
+standard specifies an API for it---the na@"{@dotless{i}}ve code has
 some portability problems because on some platforms the length of file
 name components is limited to 30 characters or so.  Gnulib handles
 that.
@@ -79,8 +79,8 @@
 
 Gnulib supports a number of platforms that we call the ``reasonable
 portability targets''.  This class consists of widespread operating systems,
-for three years after their last availability, or --- for proprietary
-operating systems --- as long as the vendor provides commercial support for
+for three years after their last availability, or---for proprietary
+operating systems---as long as the vendor provides commercial support for
 it.  Already existing Gnulib code for older operating systems is usually
 left in place for longer than these three years.  So it comes that programs
 that use Gnulib run pretty well also on these older operating systems.
@@ -200,13 +200,13 @@
 the @file{m4/} subdirectory.  Build scripts reside in the
 @file{build-aux/} subdirectory.
 
-The module description contains the list of files --- @code{gnulib-tool}
+The module description contains the list of files; @code{gnulib-tool}
 copies these files.  It contains the module's
-dependencies --- @code{gnulib-tool} installs them as well.  It also
+dependencies; @code{gnulib-tool} installs them as well.  It also
 contains the autoconf macro invocation (usually a single line or
-nothing at all) --- @code{gnulib-tool} ensures this is invoked from the
+nothing at all); @code{gnulib-tool} ensures this is invoked from the
 package's @file{configure.ac} file.  And also a @file{Makefile.am}
-snippet --- @code{gnulib-tool} collects these into a @file{Makefile.am}
+snippet; @code{gnulib-tool} collects these into a @file{Makefile.am}
 for the tailored Gnulib part.  The module description and include file
 specification are for documentation purposes; they are combined into
 @file{MODULES.html}.
@@ -217,9 +217,9 @@
 @item
 It ensures consistency of the used autoconf macros and @file{Makefile.am}
 rules with the source code.  For example, source code which uses the
-@code{getopt_long} function --- this is a common way to implement parsing
-of command line options in a way that complies with the GNU standards ---
-needs the source code (@file{lib/getopt.c} and others), the autoconf macro
+@code{getopt_long} function---this is a common way to implement parsing
+of command line options in a way that complies with the GNU standards---needs
+the source code (@file{lib/getopt.c} and others), the autoconf macro
 which detects whether the system's libc already has this function (in
 @file{m4/getopt.m4}), and a few @file{Makefile.am} lines that create the
 substitute @file{getopt.h} if not.  These three pieces belong together.
@@ -294,17 +294,17 @@
 @subsection Enhancements of ISO C or POSIX functions
 
 These are sometimes POSIX functions with GNU extensions also found in
-glibc --- examples: @samp{getopt}, @samp{fnmatch} --- and often new
-APIs --- for example, for all functions that allocate memory in one way
+glibc---examples: @samp{getopt}, @samp{fnmatch}---and often new
+APIs---for example, for all functions that allocate memory in one way
 or the other, we have variants which also include the error checking
 against the out-of-memory condition.
 
 @subsection Portable general use facilities
 
-Examples are a module for copying a file --- the portability problems
+Examples are a module for copying a file---the portability problems
 relate to the copying of the file's modification time, access rights,
-and extended attributes --- or a module for extracting the tail
-component of a file name --- here the portability to native Windows
+and extended attributes---or a module for extracting the tail
+component of a file name---here the portability to native Windows
 requires a different API than the classical POSIX @code{basename} function.
 
 @subsection Reusable application code
@@ -373,7 +373,7 @@
 Module description files are under this copyright:
 
 @quotation
-Copyright @copyright{} 200X-200Y Free Software Foundation, Inc.@*
+Copyright @copyright{} 20XX--20YY Free Software Foundation, Inc.@*
 Copying and distribution of this file, with or without modification,
 in any medium, are permitted without royalty provided the copyright
 notice and this notice are preserved.
@@ -383,7 +383,7 @@
 Autoconf macro files are under this copyright:
 
 @quotation
-Copyright @copyright{} 200X-200Y Free Software Foundation, Inc.@*
+Copyright @copyright{} 20XX--20YY Free Software Foundation, Inc.@*
 This file is free software; the Free Software Foundation
 gives unlimited permission to copy and/or distribute it,
 with or without modifications, as long as this notice is preserved.
@@ -398,7 +398,7 @@
 Documentation files are under this copyright:
 
 @quotation
-Copyright @copyright{} 2004-200Y Free Software Foundation, Inc.@*
+Copyright @copyright{} 2004--20YY Free Software Foundation, Inc.@*
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3 or
 any later version published by the Free Software Foundation; with no
--- a/doc/gnulib-tool.texi
+++ b/doc/gnulib-tool.texi
@@ -577,8 +577,8 @@
 in such a way that they will always use this domain regardless of the
 default domain set by @code{textdomain}.
 
-In order to use this method, you must -- in each program that might use
-Gnulib code -- add an extra line to the part of the program that
+In order to use this method, you must---in each program that might use
+Gnulib code---add an extra line to the part of the program that
 initializes locale-dependent behavior.  Where you would normally write
 something like:
 
@@ -780,7 +780,7 @@
 that is based on a function @code{mktime_internal}.  The module
 @code{mktime-internal} that provides this function provides it on all
 platforms.  So, by default, the file @file{mktime-internal.c} will be
-compiled on all platforms --- even on glibc and BSD systems which have a
+compiled on all platforms, even on glibc and BSD systems which have a
 working @code{timegm} function.  When the option
 @samp{--conditional-dependencies} is given, on the other hand, and if
 @code{mktime-internal} was not explicitly required on the command line,
--- a/doc/gnulib.texi
+++ b/doc/gnulib.texi
@@ -23,7 +23,7 @@
 which is a library of common routines intended to be shared at the
 source level.
 
-Copyright @copyright{} 2004-2012 Free Software Foundation, Inc.
+Copyright @copyright{} 2004--2012 Free Software Foundation, Inc.
 
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3 or
@@ -164,7 +164,7 @@
 file (.h file) and implemented in one or more implementation files (.c files).
 The separation has the effect that users of your module need to read only
 the contents of the .h file and the module description in order to understand
-what the module is about and how to use it - not the entire implementation.
+what the module is about and how to use it---not the entire implementation.
 Furthermore, users of your module don't need to repeat the declarations of
 the functions in their code, and are likely to receive notification through
 compiler errors if you make incompatible changes to the API (like, adding a
@@ -931,8 +931,8 @@
 an application layer that does not need to invoke POSIX functions and
 an operating system interface layer that contains all the OS function
 calls.  In such a situation, you will want to turn on the namespace mode
-for the application layer --- to avoid many preprocessor macro
-definitions --- and turn it off for the OS interface layer --- to avoid
+for the application layer---to avoid many preprocessor macro
+definitions---and turn it off for the OS interface layer---to avoid
 the drawback of the namespace mode, mentioned above.
 
 
--- a/doc/havelib.texi
+++ b/doc/havelib.texi
@@ -8,9 +8,9 @@
 
 The macros @code{AC_CHECK_LIB}, @code{AC_SEARCH_LIBS} from GNU Autoconf check
 for the presence of certain C, C++, or Fortran library archive files.
-The libraries are looked up in the default linker path -- a system dependent
-list of directories, that usually contains the @file{/usr/lib} directory --
- and those directories given by @code{-L} options in the @code{LDFLAGS}
+The libraries are looked up in the default linker path---a system dependent
+list of directories, that usually contains the @file{/usr/lib} directory---and
+those directories given by @code{-L} options in the @code{LDFLAGS}
 variable.
 
 @unnumberedsubsec Locating Libraries
--- a/doc/intprops.texi
+++ b/doc/intprops.texi
@@ -31,14 +31,14 @@
 
 Many techniques have been proposed to attack these problems.  These
 include precondition testing, GCC's @option{-ftrapv} option, GCC's
-no-undefined-overflow branch, the As-if Infinitely Ranged (AIR) model
+no-undefined-overflow branch, the as-if infinitely ranged (AIR) model
 implemented in Clang, saturation semantics where overflow reliably
 yields an extreme value, the RICH static transformer to an
 overflow-checking variant, and special testing methods.  For more
 information about these techniques, see: Dannenberg R, Dormann W,
 Keaton D @emph{et al.},
 @url{http://www.sei.cmu.edu/library/abstracts/reports/10tn008.cfm,
-As-if Infinitely Ranged integer model -- 2nd ed.}, Software Engineering
+As-if infinitely ranged integer model, 2nd ed.}, Software Engineering
 Institute Technical Note CMU/SEI-2010-TN-008, April 2010.
 
 Gnulib supports the precondition testing technique, as this is easy to
--- a/doc/lib-symbol-visibility.texi
+++ b/doc/lib-symbol-visibility.texi
@@ -93,10 +93,10 @@
 introduced in GCC 4.0, the third approach could not be used.)
 
 More explanations on this subject can be found in
-@url{http://gcc.gnu.org/wiki/Visibility} - which contains more details
-on the GCC features and additional advice for C++ libraries - and in
-Ulrich Drepper's paper @url{http://people.redhat.com/drepper/dsohowto.pdf}
-- which also explains other tricks for reducing the startup time impact
+@url{http://gcc.gnu.org/wiki/Visibility}, which contains more details
+on the GCC features and additional advice for C++ libraries, and in
+Ulrich Drepper's paper @url{http://people.redhat.com/drepper/dsohowto.pdf},
+which also explains other tricks for reducing the startup time impact
 of shared libraries.
 
 The gnulib autoconf macro @code{gl_VISIBILITY} tests for GCC 4.0 or newer.
--- a/doc/parse-datetime.texi
+++ b/doc/parse-datetime.texi
@@ -38,7 +38,7 @@
 that we often look into our own immediate past or future, last Tuesday
 or a week from Sunday, with feelings of helpless confusion.  @dots{}
 
---- Robert Grudin, @cite{Time and the Art of Living}.
+---Robert Grudin, @cite{Time and the Art of Living}.
 @end quotation
 
 This section describes the textual date representations that @sc{gnu}
--- a/doc/posix-functions/ceil.texi
+++ b/doc/posix-functions/ceil.texi
@@ -13,7 +13,7 @@
 Portability problems fixed by Gnulib module @code{ceil-ieee}:
 @itemize
 @item
-This function returns a positive zero for an argument between -1 and 0
+This function returns a positive zero for an argument between @minus{}1 and 0
 on some platforms:
 AIX 7.1, OSF/1 5.1.
 @item
--- a/doc/posix-functions/ceilf.texi
+++ b/doc/posix-functions/ceilf.texi
@@ -19,7 +19,7 @@
 Portability problems fixed by Gnulib module @code{ceilf-ieee}:
 @itemize
 @item
-This function returns a positive zero for an argument between -1 and 0
+This function returns a positive zero for an argument between @minus{}1 and 0
 on some platforms:
 Mac OS X 10.5, AIX 7.1, OSF/1 5.1.
 @item
--- a/doc/posix-functions/ceill.texi
+++ b/doc/posix-functions/ceill.texi
@@ -19,7 +19,7 @@
 Portability problems fixed by Gnulib module @code{ceill-ieee}:
 @itemize
 @item
-This function returns a positive zero for an argument between -1 and 0
+This function returns a positive zero for an argument between @minus{}1 and 0
 on some platforms:
 OSF/1 5.1.
 @end itemize
--- a/doc/posix-functions/chown.texi
+++ b/doc/posix-functions/chown.texi
@@ -14,10 +14,10 @@
 FreeBSD 7.2, AIX 7.1, Solaris 9.
 @item
 Some platforms fail to update the change time when at least one
-argument was not -1, but no ownership changes resulted:
+argument was not @minus{}1, but no ownership changes resulted:
 OpenBSD 4.0.
 @item
-When passed an argument of -1, some implementations really set the owner
+When passed an argument of @minus{}1, some implementations really set the owner
 user/group id of the file to this value, rather than leaving that id of the
 file alone.
 @item
--- a/doc/posix-functions/expm1f.texi
+++ b/doc/posix-functions/expm1f.texi
@@ -12,7 +12,7 @@
 This function is missing on some platforms:
 Minix 3.1.8, AIX 5.1, HP-UX 11, Solaris 9, mingw, MSVC 9.
 @item
-This function produces wrong results for arguments <= -17.32868 on some platforms:
+This function produces wrong results for arguments <= @minus{}17.32868 on some platforms:
 IRIX 6.5.
 @end itemize
 
--- a/doc/posix-functions/iconv.texi
+++ b/doc/posix-functions/iconv.texi
@@ -30,7 +30,7 @@
 When @code{iconv} encounters an input character that is valid but that
 cannot be converted to the output character set, glibc's and GNU libiconv's
 @code{iconv} stop the conversion.  Some other implementations put an
-implementation-defined character into the output buffer.  ---
+implementation-defined character into the output buffer.
 Gnulib provides higher-level facilities @code{striconv} and @code{striconveh}
 (wrappers around @code{iconv}) that deal with conversion errors in a platform
 independent way.
--- a/doc/posix-functions/iconv_open.texi
+++ b/doc/posix-functions/iconv_open.texi
@@ -40,7 +40,7 @@
 @item
 For some encodings A and B, this function cannot convert directly from A to B,
 although an indirect conversion from A through UTF-8 to B is possible.  This
-occurs on some platforms: Solaris 11 2010-11.  ---  Gnulib provides a higher-level
+occurs on some platforms: Solaris 11 2010-11.  Gnulib provides a higher-level
 facility @code{striconveh} (a wrapper around @code{iconv}) that deals with
 this problem.
 @item
--- a/doc/posix-functions/log1pf.texi
+++ b/doc/posix-functions/log1pf.texi
@@ -12,7 +12,7 @@
 This function is missing on some platforms:
 Minix 3.1.8, AIX 5.1, HP-UX 11, Solaris 9, MSVC 9.
 @item
-This function returns a wrong value for the argument -1.0f on some platforms:
+This function returns a wrong value for the argument @code{-1.0f} on some platforms:
 IRIX 6.5.
 @end itemize
 
--- a/doc/posix-functions/lseek.texi
+++ b/doc/posix-functions/lseek.texi
@@ -23,7 +23,7 @@
 and most character devices don't support it.
 @item
 When the third argument is invalid, POSIX says that @code{lseek} should set
-@code{errno} to @code{EINVAL} and return -1, but in this situation a
+@code{errno} to @code{EINVAL} and return @minus{}1, but in this situation a
 @code{SIGSYS} signal is raised on some platforms:
 IRIX 6.5.
 @item
--- a/doc/posix-functions/pthread_sigmask.texi
+++ b/doc/posix-functions/pthread_sigmask.texi
@@ -20,7 +20,7 @@
 linked with @code{-lpthread} on some platforms:
 FreeBSD 6.4, HP-UX 11.31, Solaris 9.
 @item
-When it fails, this functions returns -1 instead of the error number on
+When it fails, this functions returns @minus{}1 instead of the error number on
 some platforms:
 Cygwin 1.7.5.
 @item
--- a/doc/posix-functions/realpath.texi
+++ b/doc/posix-functions/realpath.texi
@@ -37,5 +37,5 @@
 @item
 This function does not allow to determine the required size of output buffer;
 the use of a non-NULL @samp{resolved} buffer is non-portable, since
-PATH_MAX --- if it is defined --- is nothing more than a guess.
+PATH_MAX, if it is defined, is nothing more than a guess.
 @end itemize
--- a/doc/posix-functions/round.texi
+++ b/doc/posix-functions/round.texi
@@ -15,14 +15,15 @@
 This function is not declared on some platforms:
 glibc 2.8, IRIX 6.5, OSF/1 5.1.
 @item
-This functions returns a wrong result for x = 1/2 - 2^-54 on some platforms:
+This functions returns a wrong result for @math{x = 1/2 - 2^-54}
+on some platforms:
 NetBSD 3.0, AIX 7.1.
 @end itemize
 
 Portability problems fixed by Gnulib module @code{round-ieee}:
 @itemize
 @item
-This function returns a positive zero for an argument between -0.5 and 0
+This function returns a positive zero for an argument between @minus{}0.5 and 0
 on some platforms:
 AIX 7.1, OSF/1 5.1.
 @item
--- a/doc/posix-functions/roundf.texi
+++ b/doc/posix-functions/roundf.texi
@@ -15,14 +15,15 @@
 This function is not declared on some platforms:
 glibc 2.8, IRIX 6.5, OSF/1 5.1.
 @item
-This functions returns a wrong result for x = 1/2 - 2^-25 on some platforms:
+This functions returns a wrong result for @math{x = 1/2 - 2^-25}
+on some platforms:
 mingw.
 @end itemize
 
 Portability problems fixed by Gnulib module @code{roundf-ieee}:
 @itemize
 @item
-This function returns a positive zero for an argument between -0.5 and 0
+This function returns a positive zero for an argument between @minus{}0.5 and 0
 on some platforms:
 AIX 7.1, OSF/1 5.1.
 @item
--- a/doc/posix-functions/roundl.texi
+++ b/doc/posix-functions/roundl.texi
@@ -19,7 +19,7 @@
 Portability problems fixed by Gnulib module @code{roundl-ieee}:
 @itemize
 @item
-This function returns a positive zero for an argument between -0.5 and 0
+This function returns a positive zero for an argument between @minus{}0.5 and 0
 on some platforms:
 AIX 7.1.
 @item
--- a/doc/posix-functions/strerror_r.texi
+++ b/doc/posix-functions/strerror_r.texi
@@ -32,7 +32,7 @@
 platforms:
 AIX 5.1, OSF/1 5.1.
 @item
-When this function fails, it returns -1 and sets @code{errno}, instead of
+When this function fails, it returns @minus{}1 and sets @code{errno}, instead of
 returning the error number, on some platforms:
 glibc 2.12 with @code{-D_POSIX_C_SOURCE=200112L}, AIX 6.1, OSF/1 5.1.
 @item
--- a/doc/posix-functions/strtod.texi
+++ b/doc/posix-functions/strtod.texi
@@ -31,7 +31,7 @@
 glibc 2.4, Mac OS X 10.5, FreeBSD 6.2, AIX 7.1, Cygwin < 1.5.25-11.
 
 @item
-This function returns +0.0 (not -0.0) for @samp{-0} on some platforms:
+This function returns +0.0 (not @minus{}0.0) for @samp{-0} on some platforms:
 IRIX 6.5, OSF/1 4.0.
 
 @item
@@ -73,7 +73,7 @@
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function returns +0.0 (not -0.0) for negative underflow on some
+This function returns +0.0 (not @minus{}0.0) for negative underflow on some
 platforms:
 glibc 2.7, Cygwin 1.5.x, mingw, MSVC 9.
 
--- a/doc/posix-functions/truncl.texi
+++ b/doc/posix-functions/truncl.texi
@@ -22,7 +22,7 @@
 Portability problems fixed by Gnulib module @code{truncl-ieee}:
 @itemize
 @item
-This function returns a positive zero for an argument between -1 and 0
+This function returns a positive zero for an argument between @minus{}1 and 0
 on some platforms:
 OSF/1 5.1.
 @end itemize
--- a/doc/posix-functions/write.texi
+++ b/doc/posix-functions/write.texi
@@ -18,8 +18,8 @@
 mingw, MSVC 9.
 @item
 When writing to a non-blocking pipe on which no reader is currently waiting
-an amount of bytes that exceeds the pipe buffer's size, then -- even if the
-pipe's buffer is empty -- this function fails, instead of performing a partial
+an amount of bytes that exceeds the pipe buffer's size, then---even if the
+pipe's buffer is empty---this function fails, instead of performing a partial
 write into the pipe buffer, on some platforms:
 mingw, MSVC 9.
 @end itemize
--- a/doc/posix-headers/sys_select.texi
+++ b/doc/posix-headers/sys_select.texi
@@ -17,8 +17,8 @@
 This header file does not define @code{struct timeval} on some platforms:
 OSF/1 4.0.
 @item
-This header file is not self-contained --- it requires @code{<string.h>}
-before @code{FD_ZERO} can be used --- on some platforms:
+This header file is not self-contained---it requires @code{<string.h>}
+before @code{FD_ZERO} can be used---on some platforms:
 AIX 7.1, Solaris 11 2011-11.
 @end itemize
 
--- a/doc/safe-alloc.texi
+++ b/doc/safe-alloc.texi
@@ -45,7 +45,7 @@
 allocated memory in @code{ptr}.  Fill the newly allocated memory with
 zeros.
 
-Returns -1 on failure, 0 on success.
+Returns @minus{}1 on failure, 0 on success.
 @end defmac
 
 @defmac {int} ALLOC_N (ptr, count)
@@ -54,7 +54,7 @@
 bytes long, and store the address of allocated memory in
 @code{ptr}.  Fill the newly allocated memory with zeros.
 
-Returns -1 on failure, 0 on success.
+Returns @minus{}1 on failure, 0 on success.
 @end defmac
 
 @defmac {int} ALLOC_N_UNINITIALIZED (ptr, count)
@@ -63,7 +63,7 @@
 bytes long, and store the address of allocated memory in
 @code{ptr}.  The allocated memory is not initialized.
 
-Returns -1 on failure, 0 on success.
+Returns @minus{}1 on failure, 0 on success.
 @end defmac
 
 @defmac {int} REALLOC_N (ptr, count)
@@ -73,7 +73,7 @@
 and store the address of allocated memory in @code{ptr}.  If
 reallocation fails, the @code{ptr} variable is not modified.
 
-Returns -1 on failure, 0 on success.
+Returns @minus{}1 on failure, 0 on success.
 @end defmac
 
 @defmac {void} FREE (ptr)
--- a/doc/warnings.texi
+++ b/doc/warnings.texi
@@ -16,8 +16,8 @@
 @item
 You can make these warnings apply to selected directories only.  In
 projects where subprojects are maintained by different people, or where
-parts of the source code are imported from external sources -- for example
-from gnulib --, it is useful to apply different warning options to
+parts of the source code are imported from external sources (for example
+from gnulib), it is useful to apply different warning options to
 different directories.
 
 @item