diff options
Diffstat (limited to 'manual')
| -rw-r--r-- | manual/arith.texi | 22 | ||||
| -rw-r--r-- | manual/errno.texi | 25 | ||||
| -rw-r--r-- | manual/libc.texinfo | 102 |
3 files changed, 79 insertions, 70 deletions
diff --git a/manual/arith.texi b/manual/arith.texi index a5d2814b1d..b3f646a187 100644 --- a/manual/arith.texi +++ b/manual/arith.texi @@ -446,20 +446,20 @@ These functions are declared in @file{stdlib.h}. @deftypefun {long int} strtol (const char *@var{string}, char **@var{tailptr}, int @var{base}) The @code{strtol} (``string-to-long'') function converts the initial part of @var{string} to a signed integer, which is returned as a value -of type @code{long int}. +of type @code{long int}. This function attempts to decompose @var{string} as follows: @itemize @bullet -@item +@item A (possibly empty) sequence of whitespace characters. Which characters are whitespace is determined by the @code{isspace} function (@pxref{Classification of Characters}). These are discarded. -@item +@item An optional plus or minus sign (@samp{+} or @samp{-}). -@item +@item A nonempty sequence of digits in the radix specified by @var{base}. If @var{base} is zero, decimal radix is assumed unless the series of @@ -471,7 +471,7 @@ Otherwise @var{base} must have a value between @code{2} and @code{35}. If @var{base} is @code{16}, the digits may optionally be preceded by @samp{0x} or @samp{0X}. -@item +@item Any remaining characters in the string. If @var{tailptr} is not a null pointer, @code{strtol} stores a pointer to this tail in @code{*@var{tailptr}}. @@ -499,9 +499,11 @@ There is an example at the end of this section. @comment ANSI @deftypefun {unsigned long int} strtoul (const char *@var{string}, char **@var{tailptr}, int @var{base}) The @code{strtoul} (``string-to-unsigned-long'') function is like -@code{strtol} except that it returns its value with type @code{unsigned -long int}. The value returned in case of overflow is @code{ULONG_MAX} -(@pxref{Range of Type}). +@code{strtol} except it deals with unsigned numbers, and returns its +value with type @code{unsigned long int}. No @samp{+} or @samp{-} sign +may appear before the number, but the syntax is otherwise the same as +described above for @code{strtol}. The value returned in case of +overflow is @code{ULONG_MAX} (@pxref{Range of Type}). @end deftypefun @comment stdlib.h @@ -568,12 +570,12 @@ These functions are declared in @file{stdlib.h}. @deftypefun double strtod (const char *@var{string}, char **@var{tailptr}) The @code{strtod} (``string-to-double'') function converts the initial part of @var{string} to a floating-point number, which is returned as a -value of type @code{double}. +value of type @code{double}. This function attempts to decompose @var{string} as follows: @itemize @bullet -@item +@item A (possibly empty) sequence of whitespace characters. Which characters are whitespace is determined by the @code{isspace} function (@pxref{Classification of Characters}). These are discarded. diff --git a/manual/errno.texi b/manual/errno.texi index 836fff3bf2..a00ac7859d 100644 --- a/manual/errno.texi +++ b/manual/errno.texi @@ -18,7 +18,7 @@ facility. @menu * Checking for Errors:: How errors are reported by library functions. -* Error Codes:: Error code macros; all of these expand +* Error Codes:: Error code macros; all of these expand into integer constant values. * Error Messages:: Mapping error codes onto error messages. @end menu @@ -492,7 +492,7 @@ A file that isn't a socket was specified when a socket is required. @deftypevr Macro int EMSGSIZE @comment errno 40 @c DO NOT REMOVE The size of a message sent on a socket was larger than the supported -maximum size. +maximum size. @end deftypevr @comment errno.h @@ -836,6 +836,14 @@ of error you get if you request them and they are not supported. @end deftypevr @comment errno.h +@comment ISO C: Invalid or incomplete multibyte or wide character +@deftypevr Macro int EILSEQ +@comment errno 106 @c DO NOT REMOVE +While decoding a multibyte character the function came along an invalid +or an incomplete sequence of bytes or the given wide character is invalid. +@end deftypevr + +@comment errno.h @comment GNU: Inappropriate operation for background process @deftypevr Macro int EBACKGROUND @comment errno 100 @c DO NOT REMOVE @@ -920,11 +928,11 @@ This function prints an error message to the stream @code{stderr}; see @ref{Standard Streams}. If you call @code{perror} with a @var{message} that is either a null -pointer or an empty string, @code{perror} just prints the error message +pointer or an empty string, @code{perror} just prints the error message corresponding to @code{errno}, adding a trailing newline. If you supply a non-null @var{message} argument, then @code{perror} -prefixes its output with this string. It adds a colon and a space +prefixes its output with this string. It adds a colon and a space character to separate the @var{message} from the error string corresponding to @code{errno}. @@ -952,7 +960,7 @@ variable @code{program_invocation_name}: @comment errno.h @comment GNU -@deftypevar {char *} program_invocation_name +@deftypevar {char *} program_invocation_name This variable's value is the name that was used to invoke the program running in the current process. It is the same as @code{argv[0]}. Note that this is not necessarily a useful file name; often it contains no @@ -961,7 +969,7 @@ directory names. @xref{Program Arguments}. @comment errno.h @comment GNU -@deftypevar {char *} program_invocation_short_name +@deftypevar {char *} program_invocation_short_name This variable's value is the name that was used to invoke the program running in the current process, with directory names removed. (That is to say, it is the same as @code{program_invocation_name} minus @@ -997,10 +1005,10 @@ functions might overwrite @code{errno} in the meantime. FILE * open_sesame (char *name) -@{ +@{ FILE *stream; - errno = 0; + errno = 0; stream = fopen (name, "r"); if (stream == NULL) @{ @@ -1012,4 +1020,3 @@ open_sesame (char *name) return stream; @} @end smallexample - diff --git a/manual/libc.texinfo b/manual/libc.texinfo index 1ba44c2071..7a8c1c3327 100644 --- a/manual/libc.texinfo +++ b/manual/libc.texinfo @@ -10,10 +10,10 @@ @set xref-automatic-section-title @smallbook -@c I've already told people the printed edition will be 0.06 -@set EDITION 0.06 +@c sold 0.06/1.09, print run out 21may96 +@set EDITION 0.07 DRAFT @set VERSION 1.09 Beta -@set UPDATED 23 December 1994 +@set UPDATED 21 May 1996 @set ISBN 1-882114-53-1 @ifinfo @@ -22,7 +22,7 @@ This file documents the GNU C library. This is Edition @value{EDITION}, last updated @value{UPDATED}, of @cite{The GNU C Library Reference Manual}, for Version @value{VERSION}. -Copyright (C) 1993, 1994, 1995 Free Software Foundation, Inc. +Copyright (C) 1993, '94, '95, '96 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -66,11 +66,11 @@ Foundation. @center for version @value{VERSION} @page @vskip 0pt plus 1filll -Copyright @copyright{} 1993, 1994, 1995 Free Software Foundation, Inc. +Copyright @copyright{} 1993, '94, '95, '96 Free Software Foundation, Inc. @sp 2 Published by the Free Software Foundation @* -675 Massachusetts Avenue @* -Cambridge, MA 02139 USA @* +59 Temple Place -- Suite 330, @* +Boston, MA 02111-1307 USA @* Printed copies are available for $50 each. @* ISBN @value{ISBN} @* @@ -145,7 +145,7 @@ of the GNU C Library. Appendices -* Language Features:: C language features provided by the library. +* Language Features:: C language features provided by the library. * Library Summary:: A summary showing the syntax, header file, and derivation of each library feature. @@ -173,10 +173,10 @@ Introduction Standards and Portability * ANSI C:: The American National Standard for the - C programming language. + C programming language. * POSIX:: The IEEE 1003 standards for operating systems. * Berkeley Unix:: BSD and SunOS. -* SVID:: The System V Interface Description. +* SVID:: The System V Interface Description. Using the Library @@ -243,9 +243,9 @@ Obstacks complicated) growing objects. * Status of an Obstack:: Inquiries about the status of an obstack. * Obstacks Data Alignment:: Controlling alignment of objects in obstacks. -* Obstack Chunks:: How obstacks obtain and release chunks. +* Obstack Chunks:: How obstacks obtain and release chunks. Efficiency considerations. -* Summary of Obstacks:: +* Summary of Obstacks:: Automatic Storage with Variable Size @@ -291,7 +291,7 @@ Extended Characters and vice versa. * Length of Char:: how many bytes make up one multibyte char. * Converting One Char:: Converting a string character by character. -* Example of Conversion:: Example showing why converting +* Example of Conversion:: Example showing why converting one character at a time may be useful. * Shift State:: Multibyte codes with "shift characters". @@ -305,7 +305,7 @@ Locales and Internationalization * Standard Locales:: Locale names available on all systems. * Numeric Formatting:: How to format numbers for the chosen locale. -Searching and Sorting +Searching and Sorting * Comparison Functions:: Defining how to compare two objects. Since the sort and search facilities are @@ -345,7 +345,7 @@ File Names I/O on Streams * Streams:: About the data type representing a stream. -* Standard Streams:: Streams to the standard input and output +* Standard Streams:: Streams to the standard input and output devices are created for you. * Opening Streams:: How to create a stream to talk to a file. * Closing Streams:: Close a stream when you are finished with it. @@ -388,10 +388,10 @@ Formatted Output Customizing Printf -* Registering New Conversions:: -* Conversion Specifier Options:: -* Defining the Output Handler:: -* Printf Extension Example:: +* Registering New Conversions:: +* Conversion Specifier Options:: +* Defining the Output Handler:: +* Printf Extension Example:: Formatted Input @@ -412,13 +412,13 @@ Stream Buffering Other Kinds of Streams -* String Streams:: -* Custom Streams:: +* String Streams:: +* Custom Streams:: Programming Your Own Custom Streams -* Streams and Cookies:: -* Hook Functions:: +* Streams and Cookies:: +* Hook Functions:: Low-Level I/O @@ -512,7 +512,7 @@ Internet Domain * Services Database:: Ports may have symbolic names. * Byte Order:: Different hosts may use different byte ordering conventions; you need to - canonicalize host address and port number. + canonicalize host address and port number. * Inet Example:: Putting it all together. Host Addresses @@ -588,9 +588,9 @@ Terminal Modes Special Characters -* Editing Characters:: -* Signal Characters:: -* Start/Stop Characters:: +* Editing Characters:: +* Signal Characters:: +* Start/Stop Characters:: Mathematics @@ -689,12 +689,12 @@ Specifying Signal Actions Defining Signal Handlers -* Handler Returns:: -* Termination in Handler:: -* Longjmp in Handler:: -* Signals in Handler:: -* Nonreentrancy:: -* Atomic Data Access:: +* Handler Returns:: +* Termination in Handler:: +* Longjmp in Handler:: +* Signals in Handler:: +* Nonreentrancy:: +* Atomic Data Access:: Generating Signals @@ -726,7 +726,7 @@ Waiting for a Signal BSD Signal Handling * BSD Handler:: BSD Function to Establish a Handler. -* Blocking in BSD:: BSD Functions for Blocking Signals +* Blocking in BSD:: BSD Functions for Blocking Signals Process Startup and Termination @@ -756,12 +756,12 @@ Program Termination * Normal Termination:: If a program calls @code{exit}, a process terminates normally. -* Exit Status:: The @code{exit status} provides information - about why the process terminated. +* Exit Status:: The @code{exit status} provides information + about why the process terminated. * Cleanups on Exit:: A process can run its own cleanup - functions upon normal termination. + functions upon normal termination. * Aborting a Program:: The @code{abort} function causes - abnormal program termination. + abnormal program termination. * Termination Internals:: What happens when a process terminates. @@ -773,7 +773,7 @@ Child Processes * Creating a Process:: How to fork a child process. * Executing a File:: How to make a child execute another program. * Process Completion:: How to tell when a child process has completed. -* Process Completion Status:: How to interpret the status value +* Process Completion Status:: How to interpret the status value returned from a child process. * BSD Wait Functions:: More functions, for backward compatibility. * Process Creation Example:: A complete example program. @@ -814,11 +814,11 @@ Users and Groups its user and/or group IDs. * How Change Persona:: Restrictions on changing user and group IDs. * Reading Persona:: Examining the process's user and group IDs. -* Setting User ID:: -* Setting Groups:: -* Enable/Disable Setuid:: +* Setting User ID:: +* Setting Groups:: +* Enable/Disable Setuid:: * Setuid Program Example:: Setuid Program Example -* Tips for Setuid:: +* Tips for Setuid:: * Who Logged In:: Getting the name of the user who logged in, or of the real user ID of the current process. @@ -831,15 +831,15 @@ Users and Groups User Database -* User Data Structure:: -* Lookup User:: +* User Data Structure:: +* Lookup User:: * Scanning All Users:: Scanning the List of All Users -* Writing a User Entry:: +* Writing a User Entry:: Group Database -* Group Data Structure:: -* Lookup Group:: +* Group Data Structure:: +* Lookup Group:: * Scanning All Groups:: Scanning the List of All Groups System Information @@ -858,17 +858,17 @@ System Configuration Limits * Sysconf:: Getting specific configuration values of general limits and system options. * Minimums:: Minimum values for general limits. - + * Limits for Files:: Size limitations on individual files. These can vary between file systems or even from file to file. * Options for Files:: Optional features that some files may support. * File Minimums:: Minimum values for file limits. * Pathconf:: Getting the limit values for a particular file. - + * Utility Limits:: Capacity limits of POSIX.2 utility programs. * Utility Minimums:: Minimum allowable values of those limits. - + * String Parameters:: Getting the default search path. Library Facilities that are Part of the C Language |