summaryrefslogtreecommitdiff
path: root/manual
diff options
context:
space:
mode:
authorRoland McGrath <roland@gnu.org>1996-05-22 02:11:55 +0000
committerRoland McGrath <roland@gnu.org>1996-05-22 02:11:55 +0000
commitb8fe19fa809ac786b7d3dbb464cb1b3f887dc69d (patch)
tree0758f3dea04af210777ee864f4fa99e7f107b29e /manual
parent1b82a4a8cacdca3d02e98c1799b206da043d940c (diff)
downloadglibc-b8fe19fa809ac786b7d3dbb464cb1b3f887dc69d.tar.gz
Wed May 22 01:48:54 1996 Ulrich Drepper <drepper@cygnus.com>
* stdlib/strtol.c [!QUAD] (ULONG_MAX, LONG_MAX): Define these macros if they are not available. (WEAKNAME): New macro to declare argument as weak. Define function with __ prefix and add normal name as weak alias. * sysdeps/posix/euidaccess.c (S_IROTH, S_IWOTH, S_IXOTH): Defines these macros if not already available based on R_OK, W_OK, and X_OK. Tue May 21 18:48:46 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu> * misc/sys/syslog.h (__need___va_list): Define this instead of __need_va_list before including <stdarg.h>. * Makerules (o-iterator): Use $(object-suffixes-left) instead of $(object-suffixes) to produce repetitions; this is used for other lists than just that one. [versioned]: Use $(o-iterator) properly. * sysdeps/unix/sysv/linux/Implies: Include `gnu'. * sysdeps/mach/hurd/Implies: Likewise. Sat May 18 02:57:46 1996 Ulrich Drepper <drepper@cygnus.com> * login/Makefile: New file. This directory contains functions for user administration. * Makefile (subdirs): Add login. * misc/Makefile (headers): Remove utmp.h. Now in login/utmp.h. (extra-libs, libutil-routines): Ditto. * misc/login.c, misc/login_tty.c, misc/logout.c, misc/logwtmp.c, misc/utmp.h: Moved to misc/. * login/login.c, login/login_tty.c, login/logout.c, login/logwtmp.c, login/utmp.h: Moved to here from misc/. * login/utmp.h: Split file. Definitions of data structures and constants are now in the system dependent utmpbits.h file. * login/setutent_r.c, login/setutent.c, login/endutent_r.c, login/endutent.c, login/getutent_r.c, login/getutent.c, login/getutid_r.c, login/getutid.c, login/getutline_r.c, login/getutline.c, login/pututline_r.c, login/pututline.c: New files. Routines to handle utmp-style files. * sysdeps/gnu/utmpbits.h: New file. Contains GNU/Linux specific definitions of utmp data structures and constants. * sysdeps/unix/sysv/utmpbits.h: Renamed from sysdeps/unix/sysv/utmp.h. * sysdeps/generic/utmpbits.h: New file. Generic (BSDish) version of definitions of utmp data structures and constants. Fri May 17 00:01:31 1996 Ulrich Drepper <drepper@cygnus.com> * locale/C-monetary.c: Default value for mon_decimal_point should be '.'. * stdio-common/printf.h: Remove Linux libc compatibility stuff. Add `extra' flag. Currently used in __printf_fp. * stdio-common/printf_fp.c (__guess_grouping): Renamed from `guess_grouping' and extend visibility to extern. This function is now used in `strfmon'. (__printf_fp): Recognize new bit flag in info struct. This triggers to use the grouping information and decimal point from the LC_MONETARY category instead of the LC_NUMERIC category. * stdio-common/vfprintf.c (process_arg): Correct major bug. In `complicated' loop we must not use the varargs because the args are already available in the ARGS_VALUE array. * stdlib/Makefile (headers): Add monetary.h. (routines): Add strfmon. * stdlib/monetary.h: New file. Header for strfmon function. * stdlib/strfmon.c: New file. Implement strfmon function to print monetary amounts according to current locale's rules. * sysdeps/unix/sysv/linux/i386/sys/vm86.h: The kernel header is now (>= Linux-1.3.100) called <asm/vm86.h>.
Diffstat (limited to 'manual')
-rw-r--r--manual/arith.texi22
-rw-r--r--manual/errno.texi25
-rw-r--r--manual/libc.texinfo102
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