# HG changeset patch # User Paul Eggert # Date 1356599785 28800 # Node ID 4e33322b32f8bee06f9dc79d6b05f7b8d2dd3a6b # Parent 1c4d62fce4a14fbee9ea1111e5f0bcbfa21304fa Hyphen and dash fixes. diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/alloca-opt.texi --- a/doc/alloca-opt.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/alloca-opt.texi Thu Dec 27 01:16:25 2012 -0800 @@ -22,7 +22,7 @@ The user can @code{#include } 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 } must be the first one after the autoconf-generated @file{config.h}, for AIX 3 compatibility. Thanks to IBM for this nice restriction! diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/gcd.texi --- a/doc/gcd.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/gcd.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/gnulib-intro.texi --- a/doc/gnulib-intro.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/gnulib-intro.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/gnulib-tool.texi --- a/doc/gnulib-tool.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/gnulib-tool.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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, diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/gnulib.texi --- a/doc/gnulib.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/gnulib.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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. diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/havelib.texi --- a/doc/havelib.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/havelib.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/intprops.texi --- a/doc/intprops.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/intprops.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/lib-symbol-visibility.texi --- a/doc/lib-symbol-visibility.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/lib-symbol-visibility.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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. diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/parse-datetime.texi --- a/doc/parse-datetime.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/parse-datetime.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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} diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/ceil.texi --- a/doc/posix-functions/ceil.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/ceil.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/ceilf.texi --- a/doc/posix-functions/ceilf.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/ceilf.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/ceill.texi --- a/doc/posix-functions/ceill.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/ceill.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/chown.texi --- a/doc/posix-functions/chown.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/chown.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/expm1f.texi --- a/doc/posix-functions/expm1f.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/expm1f.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/iconv.texi --- a/doc/posix-functions/iconv.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/iconv.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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. diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/iconv_open.texi --- a/doc/posix-functions/iconv_open.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/iconv_open.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/log1pf.texi --- a/doc/posix-functions/log1pf.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/log1pf.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/lseek.texi --- a/doc/posix-functions/lseek.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/lseek.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/pthread_sigmask.texi --- a/doc/posix-functions/pthread_sigmask.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/pthread_sigmask.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/realpath.texi --- a/doc/posix-functions/realpath.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/realpath.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/round.texi --- a/doc/posix-functions/round.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/round.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/roundf.texi --- a/doc/posix-functions/roundf.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/roundf.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/roundl.texi --- a/doc/posix-functions/roundl.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/roundl.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/strerror_r.texi --- a/doc/posix-functions/strerror_r.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/strerror_r.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/strtod.texi --- a/doc/posix-functions/strtod.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/strtod.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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. diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/truncl.texi --- a/doc/posix-functions/truncl.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/truncl.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-functions/write.texi --- a/doc/posix-functions/write.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-functions/write.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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 diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/posix-headers/sys_select.texi --- a/doc/posix-headers/sys_select.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/posix-headers/sys_select.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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{} -before @code{FD_ZERO} can be used --- on some platforms: +This header file is not self-contained---it requires @code{} +before @code{FD_ZERO} can be used---on some platforms: AIX 7.1, Solaris 11 2011-11. @end itemize diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/safe-alloc.texi --- a/doc/safe-alloc.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/safe-alloc.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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) diff -r 1c4d62fce4a1 -r 4e33322b32f8 doc/warnings.texi --- a/doc/warnings.texi Wed Dec 26 14:00:23 2012 -0800 +++ b/doc/warnings.texi Thu Dec 27 01:16:25 2012 -0800 @@ -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