2005-10-28 Bob Wilson <bob.wilson@acm.org>
* libc/misc/unctrl.c: Replace FUNCTION description.
        * libc/signal/signal.c: Remove documentation for raise and  _raise_r.
        * libc/stdio/getdelim.c: Fix spelling errors.
        * libc/stdio/getw.c: Put RETURNS on a separate line.  Fix  punctuation.
        * libc/stdio/putw.c: Likewise.
        * libc/stdlib/a64l.c: Fix formatting, spelling and  punctuation in
        documentation.
        * libc/stdlib/assert.c: Do not capitalize FUNCTION description.
        * libc/stdlib/efgcvt.c: Add spaces to FUNCTION description.
        * libc/stdlib/envlock.c: Use em-dash in FUNCTION description.
        * libc/stdlib/mlock.c: Likewise.
        * libc/stdlib/mstats.c: Likewise.
        * libc/time/tzlock.c: Likewise.
        * libc/stdlib/rand.c: Use "multi-threaded" and "thread-safe"  in NOTES.
        * libc/stdlib/rand48.c: Remove extra space in FUNCTION  description
        and hyphenate "pseudo-random".
        * libc/string/bcmp.c: Remove extra blank lines in  documentation.
        * libc/string/strncat.c: Likewise.
        * libc/string/memchr.c: Remove extra ">" character in  documentation.
        * libc/string/strcspn.c: Use "characters" instead of "chars".
        * libc/string/strpbrk.c: Likewise.
        * libc/string/strerror_r.c: Capitalize "GNU".
        * libc/string/strnlen.c: Likewise.
        * libc/string/strtok.c: Fix formatting, spelling and  punctuation in
        documentation.  Use "multi-threaded" and "thread-safe" in  NOTES.
        * libc/string/wcscat.c: Split PORTABILITY into two paragraphs.
        * libc/string/wcschr.c: Likewise.
        * libc/string/wcscmp.c: Likewise.
        * libc/string/wcscpy.c: Likewise.
        * libc/string/wcscspn.c: Likewise.
        * libc/string/wcslen.c: Likewise.
        * libc/string/wcsncat.c: Likewise.
        * libc/string/wcsncmp.c: Likewise.
        * libc/string/wcsncpy.c: Likewise.
        * libc/string/wcsnlen.c: Likewise.
        * libc/string/wcspbrk.c: Likewise.
        * libc/string/wcsrchr.c: Likewise.
        * libc/string/wcsspn.c: Likewise.
        * libc/string/wmemchr.c: Likewise.
        * libc/string/wmemcmp.c: Likewise.
        * libc/string/wmemcpy.c: Likewise.
        * libc/string/wmemset.c: Likewise.
        * libc/string/wmemmove.c: Likewise.  Also fix FUNCTION  description.
        * libc/string/wcswidth.c: Formatting and punctuation in  documentation.
        * libc/string/wcwidth.c: Likewise.
        * libm/common/s_modf.c: Remove extra period from documentation.
        * libm/math/s_isnan.c: Fix formatting, grammar and  punctuation in
        documentation.
        * libm/mathfp/s_isnan.c: Likewise.
        * libm/math/s_ldexp.c: Fix punctuation.
        * libm/mathfp/s_ldexp.c: Likewise.
        * libm/math/w_log.c: Likewise.
        * libm/mathfp/s_logarithm.c: Likewise.
        * libm/math/w_j0.c: Add spaces to FUNCTION description.
        * libm/mathfp/w_jn.c: Likewise.
			
			
This commit is contained in:
		| @@ -1,3 +1,61 @@ | ||||
| 2005-10-28  Bob Wilson  <bob.wilson@acm.org> | ||||
|  | ||||
| 	* libc/misc/unctrl.c: Replace FUNCTION description. | ||||
| 	* libc/signal/signal.c: Remove documentation for raise and  _raise_r. | ||||
| 	* libc/stdio/getdelim.c: Fix spelling errors. | ||||
| 	* libc/stdio/getw.c: Put RETURNS on a separate line.  Fix  punctuation. | ||||
| 	* libc/stdio/putw.c: Likewise. | ||||
| 	* libc/stdlib/a64l.c: Fix formatting, spelling and  punctuation in | ||||
|         documentation. | ||||
| 	* libc/stdlib/assert.c: Do not capitalize FUNCTION description. | ||||
| 	* libc/stdlib/efgcvt.c: Add spaces to FUNCTION description. | ||||
| 	* libc/stdlib/envlock.c: Use em-dash in FUNCTION description. | ||||
| 	* libc/stdlib/mlock.c: Likewise. | ||||
| 	* libc/stdlib/mstats.c: Likewise. | ||||
| 	* libc/time/tzlock.c: Likewise. | ||||
| 	* libc/stdlib/rand.c: Use "multi-threaded" and "thread-safe"  in NOTES. | ||||
| 	* libc/stdlib/rand48.c: Remove extra space in FUNCTION  description | ||||
|         and hyphenate "pseudo-random". | ||||
| 	* libc/string/bcmp.c: Remove extra blank lines in  documentation. | ||||
| 	* libc/string/strncat.c: Likewise. | ||||
| 	* libc/string/memchr.c: Remove extra ">" character in  documentation. | ||||
| 	* libc/string/strcspn.c: Use "characters" instead of "chars". | ||||
| 	* libc/string/strpbrk.c: Likewise. | ||||
| 	* libc/string/strerror_r.c: Capitalize "GNU". | ||||
| 	* libc/string/strnlen.c: Likewise. | ||||
| 	* libc/string/strtok.c: Fix formatting, spelling and  punctuation in | ||||
|         documentation.  Use "multi-threaded" and "thread-safe" in  NOTES. | ||||
| 	* libc/string/wcscat.c: Split PORTABILITY into two paragraphs. | ||||
| 	* libc/string/wcschr.c: Likewise. | ||||
| 	* libc/string/wcscmp.c: Likewise. | ||||
| 	* libc/string/wcscpy.c: Likewise. | ||||
| 	* libc/string/wcscspn.c: Likewise. | ||||
| 	* libc/string/wcslen.c: Likewise. | ||||
| 	* libc/string/wcsncat.c: Likewise. | ||||
| 	* libc/string/wcsncmp.c: Likewise. | ||||
| 	* libc/string/wcsncpy.c: Likewise. | ||||
| 	* libc/string/wcsnlen.c: Likewise. | ||||
| 	* libc/string/wcspbrk.c: Likewise. | ||||
| 	* libc/string/wcsrchr.c: Likewise. | ||||
| 	* libc/string/wcsspn.c: Likewise. | ||||
| 	* libc/string/wmemchr.c: Likewise. | ||||
| 	* libc/string/wmemcmp.c: Likewise. | ||||
| 	* libc/string/wmemcpy.c: Likewise. | ||||
| 	* libc/string/wmemset.c: Likewise. | ||||
| 	* libc/string/wmemmove.c: Likewise.  Also fix FUNCTION  description. | ||||
| 	* libc/string/wcswidth.c: Formatting and punctuation in  documentation. | ||||
| 	* libc/string/wcwidth.c: Likewise. | ||||
| 	* libm/common/s_modf.c: Remove extra period from documentation. | ||||
| 	* libm/math/s_isnan.c: Fix formatting, grammar and  punctuation in | ||||
|         documentation. | ||||
| 	* libm/mathfp/s_isnan.c: Likewise. | ||||
| 	* libm/math/s_ldexp.c: Fix punctuation. | ||||
| 	* libm/mathfp/s_ldexp.c: Likewise. | ||||
| 	* libm/math/w_log.c: Likewise. | ||||
| 	* libm/mathfp/s_logarithm.c: Likewise. | ||||
| 	* libm/math/w_j0.c: Add spaces to FUNCTION description. | ||||
| 	* libm/mathfp/w_jn.c: Likewise.  | ||||
|  | ||||
| 2005-10-26  Shaun Jackman  <sjackman@gmail.com> | ||||
|  | ||||
| 	* libc/posix/scandir.c (scandir): Update the function | ||||
|   | ||||
| @@ -1,6 +1,6 @@ | ||||
| /* | ||||
| FUNCTION | ||||
| 	<<unctrl>>---translate characters to upper case | ||||
| 	<<unctrl>>---get printable representation of a character | ||||
|  | ||||
| INDEX | ||||
| 	unctrl | ||||
|   | ||||
| @@ -6,21 +6,12 @@ INDEX | ||||
| 	signal | ||||
| INDEX | ||||
| 	_signal_r | ||||
| INDEX | ||||
| 	raise | ||||
| INDEX | ||||
| 	_raise_r | ||||
|  | ||||
| ANSI_SYNOPSIS | ||||
| 	#include <signal.h> | ||||
| 	void ( * signal(int <[sig]>, void(*<[func]>)(int)) )(int); | ||||
| 	void (*signal(int <[sig]>, void(*<[func]>)(int))) (int); | ||||
|  | ||||
| 	void ( * _signal_r(void *<[reent]>,  | ||||
|                            int <[sig]>, void(*<[func]>)(int)) )(int); | ||||
|  | ||||
| 	int raise (int <[sig]>); | ||||
|  | ||||
| 	int _raise_r (void *<[reent]>, int <[sig]>); | ||||
| 	void (*_signal_r(void *<[reent]>, int <[sig]>, void(*<[func]>)(int))) (int); | ||||
|  | ||||
| TRAD_SYNOPSIS | ||||
| 	#include <signal.h> | ||||
| @@ -33,15 +24,8 @@ TRAD_SYNOPSIS | ||||
| 	int <[sig]>; | ||||
| 	char ( * <[func]> )(); | ||||
|  | ||||
| 	int raise (<[sig]>)() | ||||
| 	int <[sig]>; | ||||
|  | ||||
| 	int _raise_r (<[reent]>, <[sig]>)() | ||||
| 	char *<[reent]>; | ||||
| 	int <[sig]>; | ||||
|  | ||||
| DESCRIPTION | ||||
| <<signal, raise>> provide a simple signal/raise implementation for embedded | ||||
| <<signal>> provides a simple signal-handling implementation for embedded | ||||
| targets. | ||||
|  | ||||
| <<signal>> allows you to request changed treatment for a particular | ||||
| @@ -52,7 +36,7 @@ that identifies a subroutine in your program as the handler for this signal. | ||||
|  | ||||
| Some of the execution environment for signal handlers is | ||||
| unpredictable; notably, the only library function required to work | ||||
| correctly from within a signal handler is @code{signal} itself, and | ||||
| correctly from within a signal handler is <<signal>> itself, and | ||||
| only when used to redefine the handler for the current signal value. | ||||
|  | ||||
| Static storage is likewise unreliable for signal handlers, with one | ||||
| @@ -66,13 +50,9 @@ where it was when the signal was raised (whether by your program | ||||
| itself, or by an external event).  Signal handlers can also | ||||
| use functions such as <<exit>> and <<abort>> to avoid returning. | ||||
|  | ||||
| <<raise>> sends the signal sig to the executing program.  It returns zero if | ||||
| successful, non-zero if unsuccessful. | ||||
|  | ||||
| The alternate functions <<_signal_r, _raise_r>> are the reentrant versions. | ||||
| The alternate function <<_signal_r>> is the reentrant version. | ||||
| The extra argument <[reent]> is a pointer to a reentrancy structure. | ||||
|  | ||||
|  | ||||
| @c FIXME: do we have setjmp.h and assoc fns? | ||||
|  | ||||
| RETURNS | ||||
| @@ -83,7 +63,7 @@ Otherwise, the result is the previous handler (a function pointer or | ||||
| one of the predefined macros). | ||||
|  | ||||
| PORTABILITY | ||||
| ANSI C requires <<raise>>, <<signal>>. | ||||
| ANSI C requires <<signal>>. | ||||
|  | ||||
| No supporting OS subroutines are required to link with <<signal>>, but | ||||
| it will not have any useful effects, except for software generated signals, | ||||
|   | ||||
| @@ -1,7 +1,7 @@ | ||||
| /* Copyright 2002, Red Hat Inc. - all rights reserved */ | ||||
| /* | ||||
| FUNCTION | ||||
| <<getdelim>>---read a line up to a specified line delimeter | ||||
| <<getdelim>>---read a line up to a specified line delimiter | ||||
|  | ||||
| INDEX | ||||
| 	getdelim | ||||
| @@ -21,16 +21,16 @@ TRAD_SYNOPSIS | ||||
|  | ||||
| DESCRIPTION | ||||
| <<getdelim>> reads a file <[fp]> up to and possibly including a specified | ||||
| delimeter <[delim]>.  The line is read into a buffer pointed to | ||||
| delimiter <[delim]>.  The line is read into a buffer pointed to | ||||
| by <[bufptr]> and designated with size *<[n]>.  If the buffer is | ||||
| not large enough, it will be dynamically grown by <<getdelim>>. | ||||
| As the buffer is grown, the pointer to the size <[n]> will be | ||||
| updated. | ||||
|  | ||||
| RETURNS | ||||
| <<getdelim>> returns <<-1>> if no characters were successfully read, | ||||
| <<getdelim>> returns <<-1>> if no characters were successfully read; | ||||
| otherwise, it returns the number of bytes successfully read. | ||||
| at end of file, the result is nonzero. | ||||
| At end of file, the result is nonzero. | ||||
|  | ||||
| PORTABILITY | ||||
| <<getdelim>> is a glibc extension. | ||||
|   | ||||
| @@ -37,14 +37,15 @@ to get the next word from the file or stream identified by <[fp]>.  As | ||||
| a side effect, <<getw>> advances the file's current position | ||||
| indicator. | ||||
|  | ||||
| RETURNS The next word (read as an <<int>>), unless there is no more | ||||
| data, or the host system reports a read error; in either of these | ||||
| RETURNS | ||||
| The next word (read as an <<int>>), unless there is no more | ||||
| data or the host system reports a read error; in either of these | ||||
| situations, <<getw>> returns <<EOF>>.  Since <<EOF>> is a valid | ||||
| <<int>>, you must use <<ferror>> or <<feof>> to distinguish these | ||||
| situations. | ||||
|  | ||||
| PORTABILITY | ||||
| <<getw>> is a remnant of K&R C, it is not part of any ISO C Standard. | ||||
| <<getw>> is a remnant of K&R C; it is not part of any ISO C Standard. | ||||
| <<fread>> should be used instead.  In fact, this implementation of | ||||
| <<getw>> is based upon <<fread>>. | ||||
|  | ||||
|   | ||||
| @@ -37,10 +37,11 @@ DESCRIPTION | ||||
| to write a word to the file or stream identified by <[fp]>.  As a side | ||||
| effect, <<putw>> advances the file's current position indicator. | ||||
|  | ||||
| RETURNS Zero on success, <<EOF>> on failure. | ||||
| RETURNS | ||||
| Zero on success, <<EOF>> on failure. | ||||
|  | ||||
| PORTABILITY | ||||
| <<putw>> is a remnant of K&R C, it is not part of any ISO C Standard. | ||||
| <<putw>> is a remnant of K&R C; it is not part of any ISO C Standard. | ||||
| <<fwrite>> should be used instead.  In fact, this implementation of | ||||
| <<putw>> is based upon <<fwrite>>. | ||||
|  | ||||
|   | ||||
| @@ -1,6 +1,6 @@ | ||||
| /* | ||||
| FUNCTION | ||||
| <<a64l>>,<<l64a>>---convert between radix-64 ascii string and long | ||||
| <<a64l>>, <<l64a>>---convert between radix-64 ASCII string and long | ||||
|  | ||||
| INDEX | ||||
|         a64l | ||||
| @@ -21,31 +21,36 @@ TRAD_SYNOPSIS | ||||
|         long <[input]>; | ||||
|  | ||||
| DESCRIPTION | ||||
| Conversion is performed between long and radix-64 characters.  The <<l64a>> routine | ||||
| transforms up to 32-bits of input value starting from least significant bits to | ||||
| the most significant bits.  The input value is split up into a maximum of 5 | ||||
| groups of 6-bits and possibly one group of 2 bits (bits 31 and 30). | ||||
| Conversion is performed between long and radix-64 characters.  The | ||||
| <<l64a>> routine transforms up to 32 bits of input value starting from | ||||
| least significant bits to the most significant bits.  The input value | ||||
| is split up into a maximum of 5 groups of 6 bits and possibly one | ||||
| group of 2 bits (bits 31 and 30). | ||||
|  | ||||
| Each group of 6 bits forms a value from 0-63 which is translated into a character | ||||
| as follows: | ||||
| Each group of 6 bits forms a value from 0--63 which is translated into | ||||
| a character as follows: | ||||
|  | ||||
|       0 = '.' | ||||
|       1 = '/' | ||||
|       2-11 = '0' to '9' | ||||
|       12-37 = 'A' to 'Z' | ||||
|       38-63 = 'a' to 'z' | ||||
| O+ | ||||
| o     0 = '.' | ||||
| o     1 = '/' | ||||
| o     2--11 = '0' to '9' | ||||
| o     12--37 = 'A' to 'Z' | ||||
| o     38--63 = 'a' to 'z' | ||||
| O- | ||||
|  | ||||
| When remaining bits are zero or all bits have been translated, a nul terminator | ||||
| is appended to the string.  An input value of 0 results in the empty string. | ||||
| When the remaining bits are zero or all bits have been translated, a | ||||
| null terminator is appended to the string.  An input value of 0 | ||||
| results in the empty string. | ||||
|  | ||||
| The <<a64l>> function performs the reverse translation.  Each | ||||
| character is used to generate a 6-bit value for up to 30 bits and then | ||||
| a 2-bit value to complete a 32-bit result.  The null terminator means | ||||
| that the remaining digits are 0.  An empty input string or NULL string | ||||
| results in 0L.  An invalid string results in undefined behavior.  If | ||||
| the size of a long is greater than 32 bits, the result is sign-extended. | ||||
|  | ||||
| The <<a64l>> performs the reverse translation.  Each character is used to generate | ||||
| a 6-bit value for up to 30 bits and then a 2-bit value to complete a 32-bit result. | ||||
| The nul terminator means that the remaining digits are 0.  An empty input string or  | ||||
| NULL string results in 0L.  An invalid string results in undefined behavior. | ||||
| If the size of a long is > 32 bits, the result is sign-extended. | ||||
|   | ||||
| RETURNS | ||||
| <<l64a>> returns a nul-terminated string of 0 to 6 characters. | ||||
| <<l64a>> returns a null-terminated string of 0 to 6 characters. | ||||
| <<a64l>> returns the 32-bit translated value from the input character string. | ||||
|  | ||||
| PORTABILITY | ||||
|   | ||||
| @@ -1,6 +1,6 @@ | ||||
| /* | ||||
| FUNCTION | ||||
| <<assert>>---Macro for Debugging Diagnostics | ||||
| <<assert>>---macro for debugging diagnostics | ||||
|  | ||||
| INDEX | ||||
| 	assert | ||||
|   | ||||
| @@ -1,6 +1,6 @@ | ||||
| /* | ||||
| FUNCTION | ||||
| <<ecvt>>,<<ecvtf>>,<<fcvt>>,<<fcvtf>>---double or float to string | ||||
| <<ecvt>>, <<ecvtf>>, <<fcvt>>, <<fcvtf>>---double or float to string | ||||
|  | ||||
| INDEX | ||||
| 	ecvt | ||||
|   | ||||
| @@ -1,6 +1,6 @@ | ||||
| /* | ||||
| FUNCTION | ||||
| <<__env_lock>>, <<__env_unlock>>--lock environ variable | ||||
| <<__env_lock>>, <<__env_unlock>>---lock environ variable | ||||
|  | ||||
| INDEX | ||||
| 	__env_lock | ||||
|   | ||||
| @@ -1,7 +1,7 @@ | ||||
| #ifndef MALLOC_PROVIDED | ||||
| /* | ||||
| FUNCTION | ||||
| <<__malloc_lock>>, <<__malloc_unlock>>--lock malloc pool | ||||
| <<__malloc_lock>>, <<__malloc_unlock>>---lock malloc pool | ||||
|  | ||||
| INDEX | ||||
| 	__malloc_lock | ||||
|   | ||||
| @@ -10,7 +10,7 @@ int _dummy_mstats = 1; | ||||
|  | ||||
| /* | ||||
| FUNCTION | ||||
| <<mallinfo>>, <<malloc_stats>>, <<mallopt>>--malloc support | ||||
| <<mallinfo>>, <<malloc_stats>>, <<mallopt>>---malloc support | ||||
|  | ||||
| INDEX | ||||
| 	mallinfo | ||||
|   | ||||
| @@ -51,8 +51,8 @@ number between <<0>> and <<RAND_MAX>> (inclusive). | ||||
| <<srand>> does not return a result. | ||||
|  | ||||
| NOTES | ||||
| <<rand>> and <<srand>> are unsafe for multi-thread applications. | ||||
| <<rand_r>> is MT-Safe and should be used instead. | ||||
| <<rand>> and <<srand>> are unsafe for multi-threaded applications. | ||||
| <<rand_r>> is thread-safe and should be used instead. | ||||
|  | ||||
|  | ||||
| PORTABILITY | ||||
|   | ||||
| @@ -13,7 +13,7 @@ | ||||
|  | ||||
| /* | ||||
| FUNCTION | ||||
|    <<rand48>>, <<drand48>>, <<erand48>>, <<lrand48>>, <<nrand48>>, <<mrand48>>, <<jrand48>>, <<srand48>>, <<seed48>>, <<lcong48>> ---pseudo random number generators and initialization routines | ||||
|    <<rand48>>, <<drand48>>, <<erand48>>, <<lrand48>>, <<nrand48>>, <<mrand48>>, <<jrand48>>, <<srand48>>, <<seed48>>, <<lcong48>>---pseudo-random number generators and initialization routines | ||||
|  | ||||
| INDEX | ||||
|        rand48 | ||||
|   | ||||
| @@ -21,8 +21,6 @@ DESCRIPTION | ||||
| 	object pointed to by <[s1]> with the object pointed to by <[s2]>. | ||||
|  | ||||
| 	This function is identical to <<memcmp>>. | ||||
| 	 | ||||
|  | ||||
|  | ||||
| RETURNS | ||||
| 	The function returns an integer greater than, equal to or | ||||
|   | ||||
| @@ -28,9 +28,9 @@ RETURNS | ||||
| 	<[c]> is not found, then <<NULL>> is returned. | ||||
|  | ||||
| PORTABILITY | ||||
| <<memchr>>> is ANSI C. | ||||
| <<memchr>> is ANSI C. | ||||
|  | ||||
| <<memchr>>  requires no supporting OS subroutines. | ||||
| <<memchr>> requires no supporting OS subroutines. | ||||
|  | ||||
| QUICKREF | ||||
| 	memchr ansi pure | ||||
|   | ||||
| @@ -1,6 +1,6 @@ | ||||
| /* | ||||
| FUNCTION | ||||
| 	<<strcspn>>---count chars not in string | ||||
| 	<<strcspn>>---count characters not in string | ||||
|  | ||||
| INDEX | ||||
| 	strcspn | ||||
|   | ||||
| @@ -30,7 +30,7 @@ This function returns a pointer to a string.  Your application must | ||||
| not modify that string. | ||||
|  | ||||
| PORTABILITY | ||||
| <<strerror_r>> is a gnu extension. | ||||
| <<strerror_r>> is a GNU extension. | ||||
|  | ||||
| <<strerror_r>> requires no supporting OS subroutines. | ||||
|  | ||||
|   | ||||
| @@ -28,7 +28,6 @@ WARNINGS | ||||
| 	Note that a null is always appended, so that if the copy is | ||||
| 	limited by the <[length]> argument, the number of characters | ||||
| 	appended to <[dst]> is <<n + 1>>. | ||||
| 	 | ||||
|  | ||||
| RETURNS | ||||
| 	This function returns the initial value of <[dst]> | ||||
|   | ||||
| @@ -25,7 +25,7 @@ RETURNS | ||||
| 	<<strnlen>> returns the character count or <[n]>. | ||||
|  | ||||
| PORTABILITY | ||||
| <<strnlen>> is a Gnu extension. | ||||
| <<strnlen>> is a GNU extension. | ||||
|  | ||||
| <<strnlen>> requires no supporting OS subroutines. | ||||
|  | ||||
|   | ||||
| @@ -1,6 +1,6 @@ | ||||
| /* | ||||
| FUNCTION | ||||
| 	<<strpbrk>>---find chars in string | ||||
| 	<<strpbrk>>---find characters in string | ||||
|  | ||||
| INDEX | ||||
| 	strpbrk | ||||
|   | ||||
| @@ -1,6 +1,6 @@ | ||||
| /* | ||||
| FUNCTION | ||||
| 	<<strtok>>,<<strtok_r>>,<<strsep>>---get next token from a string | ||||
| 	<<strtok>>, <<strtok_r>>, <<strsep>>---get next token from a string | ||||
|  | ||||
| INDEX | ||||
| 	strtok | ||||
| @@ -40,25 +40,25 @@ DESCRIPTION | ||||
| 	The first time that <<strtok>> is called, <<*<[source]>>> should be | ||||
| 	specified; subsequent calls, wishing to obtain further tokens from | ||||
| 	the same string, should pass a null pointer instead.  The separator | ||||
| 	string, <<*<[delimiters]>>>, must be supplied each time, and may  | ||||
| 	string, <<*<[delimiters]>>>, must be supplied each time and may  | ||||
| 	change between calls. | ||||
|  | ||||
| 	The <<strtok>> function returns a pointer to the beginning of each  | ||||
| 	subsequent token in the string, after replacing the separator  | ||||
| 	character itself with a NUL character.  When no more tokens remain,  | ||||
| 	character itself with a null character.  When no more tokens remain,  | ||||
| 	a null pointer is returned. | ||||
|  | ||||
| 	The <<strtok_r>> function has the same behavior as <<strtok>>, except | ||||
| 	a pointer to placeholder <<*[lasts]>> must be supplied by the caller. | ||||
| 	a pointer to placeholder <<*<[lasts]>>> must be supplied by the caller. | ||||
|  | ||||
| 	The <<strsep>> function is similar in behavior to <<strtok>>, except | ||||
| 	a pointer to the string pointer must be supplied <<[source_ptr]>> and | ||||
| 	the function does not skip leading delimeters.  When the string starts | ||||
| 	with a delimeter, the delimeter is changed to the NUL character and | ||||
| 	a pointer to the string pointer must be supplied <<<[source_ptr]>>> and | ||||
| 	the function does not skip leading delimiters.  When the string starts | ||||
| 	with a delimiter, the delimiter is changed to the null character and | ||||
| 	the empty string is returned.  Like <<strtok_r>> and <<strtok>>, the | ||||
| 	<<*[source_ptr]>> is updated to the next character following the | ||||
| 	last delimeter found or NULL if the end of string is reached with | ||||
| 	no more delimeters. | ||||
| 	<<*<[source_ptr]>>> is updated to the next character following the | ||||
| 	last delimiter found or NULL if the end of string is reached with | ||||
| 	no more delimiters. | ||||
|  | ||||
| RETURNS | ||||
| 	<<strtok>>, <<strtok_r>>, and <<strsep>> all return a pointer to the  | ||||
| @@ -66,13 +66,13 @@ RETURNS | ||||
| 	<<strsep>>, a token may be the empty string. | ||||
|  | ||||
| NOTES | ||||
| 	<<strtok>> is unsafe for multi-thread applications.  <<strtok_r>> | ||||
| 	and <<strsep>> are MT-Safe and should be used instead. | ||||
| 	<<strtok>> is unsafe for multi-threaded applications.  <<strtok_r>> | ||||
| 	and <<strsep>> are thread-safe and should be used instead. | ||||
|  | ||||
| PORTABILITY | ||||
| <<strtok>> is ANSI C. | ||||
| <<strtok_r>> is POSIX. | ||||
| <<strsep>> is a BSD-extension. | ||||
| <<strsep>> is a BSD extension. | ||||
|  | ||||
| <<strtok>>, <<strtok_r>>, and <<strsep>> require no supporting OS subroutines. | ||||
|  | ||||
|   | ||||
| @@ -27,6 +27,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcscat>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -24,6 +24,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcschr>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -26,6 +26,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcscmp>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -23,6 +23,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcscpy>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -23,6 +23,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcscspn>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -21,6 +21,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcslen>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -29,6 +29,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcsncat>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -30,6 +30,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcsncmp>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -30,6 +30,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcsncpy>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -27,7 +27,8 @@ RETURNS | ||||
|         characters. | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcsnlen>> is GNU extension.. | ||||
| <<wcsnlen>> is a GNU extension. | ||||
|  | ||||
| <<wcsnlen>> requires no supporting OS subroutines. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -23,6 +23,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcspbrk>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -27,6 +27,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcsrchr>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -23,6 +23,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcsspn>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -17,22 +17,22 @@ TRAD_SYNOPSIS | ||||
|  | ||||
| DESCRIPTION | ||||
| 	The <<wcswidth>> function shall determine the number of column | ||||
| 	positions required for n wide-character codes (or fewer than n | ||||
| 	positions required for <[n]> wide-character codes (or fewer than <[n]> | ||||
| 	wide-character codes if a null wide-character code is encountered | ||||
| 	before n wide-character codes are exhausted) in the string pointed | ||||
| 	to by pwcs. | ||||
| 	before <[n]> wide-character codes are exhausted) in the string pointed | ||||
| 	to by <[pwcs]>. | ||||
|  | ||||
| RETURNS | ||||
| 	The <<wcswidth>> function either shall return 0 (if pwcs points to a | ||||
| 	The <<wcswidth>> function either shall return 0 (if <[pwcs]> points to a | ||||
| 	null wide-character code), or return the number of column positions | ||||
| 	to be occupied by the wide-character string pointed to by pwcs, or | ||||
| 	return -1 (if any of the first n wide-character codes in the | ||||
| 	wide-character string pointed to by pwcs is not a printable | ||||
| 	to be occupied by the wide-character string pointed to by <[pwcs]>, or | ||||
| 	return -1 (if any of the first <[n]> wide-character codes in the | ||||
| 	wide-character string pointed to by <[pwcs]> is not a printable | ||||
| 	wide-character code). | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcswidth>> has been introduced in the Single UNIX Specification Volume 2 | ||||
| <<wcswidth>> has been marked as extension in Single UNIX Specification Volume 3 | ||||
| <<wcswidth>> has been introduced in the Single UNIX Specification Volume 2. | ||||
| <<wcswidth>> has been marked as an extension in the Single UNIX Specification Volume 3. | ||||
| */ | ||||
|  | ||||
| #include <_ansi.h> | ||||
|   | ||||
| @@ -16,15 +16,15 @@ TRAD_SYNOPSIS | ||||
|  | ||||
| DESCRIPTION | ||||
| 	The <<wcwidth>> function shall determine the number of column | ||||
| 	positions required for the wide character wc. The application | ||||
| 	shall ensure that the value of wc is a character representable | ||||
| 	positions required for the wide character <[wc]>. The application | ||||
| 	shall ensure that the value of <[wc]> is a character representable | ||||
| 	as a wchar_t, and is a wide-character code corresponding to a | ||||
| 	valid character in the current locale. | ||||
|  | ||||
| RETURNS | ||||
| 	The <<wcwidth>> function shall either return 0 (if wc is a null | ||||
| 	The <<wcwidth>> function shall either return 0 (if <[wc]> is a null | ||||
| 	wide-character code), or return the number of column positions to | ||||
| 	be occupied by the wide-character code wc, or return -1 (if wc | ||||
| 	be occupied by the wide-character code <[wc]>, or return -1 (if <[wc]> | ||||
| 	does not correspond to a printable wide-character code). | ||||
|  | ||||
| 	The current implementation of <<wcwidth>> simply sets the width | ||||
| @@ -32,8 +32,8 @@ RETURNS | ||||
| 	tables around. | ||||
|  | ||||
| PORTABILITY | ||||
| <<wcwidth>> has been introduced in the Single UNIX Specification Volume 2 | ||||
| <<wcwidth>> has been marked as extension in Single UNIX Specification Volume 3 | ||||
| <<wcwidth>> has been introduced in the Single UNIX Specification Volume 2. | ||||
| <<wcwidth>> has been marked as an extension in the Single UNIX Specification Volume 3. | ||||
| */ | ||||
|  | ||||
| #include <_ansi.h> | ||||
|   | ||||
| @@ -30,6 +30,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wmemchr>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -30,6 +30,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wmemcmp>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -27,6 +27,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wmemcpy>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -1,6 +1,6 @@ | ||||
| /* | ||||
| FUNCTION | ||||
| 	<<wmemmove>>---wmemmove - copy wide-characters in memory with overlapping areas  | ||||
| 	<<wmemmove>>---copy wide characters in memory with overlapping areas  | ||||
|  | ||||
| ANSI_SYNOPSIS | ||||
| 	#include <wchar.h> | ||||
| @@ -33,6 +33,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wmemmove>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -27,6 +27,7 @@ RETURNS | ||||
|  | ||||
| PORTABILITY | ||||
| <<wmemset>> is ISO/IEC 9899/AMD1:1995 (ISO C). | ||||
|  | ||||
| No supporting OS subroutines are required. | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -1,6 +1,6 @@ | ||||
| /* | ||||
| FUNCTION | ||||
| <<__tz_lock>>, <<__tz_unlock>>--lock time zone global variables | ||||
| <<__tz_lock>>, <<__tz_unlock>>---lock time zone global variables | ||||
|  | ||||
| INDEX | ||||
| 	__tz_lock | ||||
|   | ||||
| @@ -41,7 +41,7 @@ DESCRIPTION | ||||
| 	storing the integer part in <<*<[ipart]>>>.  No rounding | ||||
| 	whatsoever is done; the sum of the integer and fractional | ||||
| 	parts is guaranteed to be exactly  equal to <[val]>.   That | ||||
| 	is, if . <[realpart]> = modf(<[val]>, &<[intpart]>); then | ||||
| 	is, if <[realpart]> = modf(<[val]>, &<[intpart]>); then | ||||
| 	`<<<[realpart]>+<[intpart]>>>' is the same as <[val]>. | ||||
| 	<<modff>> is identical, save that it takes and returns | ||||
| 	<<float>> rather than <<double>> values.  | ||||
|   | ||||
| @@ -13,7 +13,7 @@ | ||||
|  | ||||
| /* | ||||
| FUNCTION | ||||
| 	<<isnan>>,<<isnanf>>,<<isinf>>,<<isinff>>,<<finite>>,<<finitef>>---test for exceptional numbers | ||||
| 	<<isnan>>, <<isnanf>>, <<isinf>>, <<isinff>>, <<finite>>, <<finitef>>---test for exceptional numbers | ||||
|  | ||||
| INDEX | ||||
| 	isnan | ||||
| @@ -58,14 +58,14 @@ DESCRIPTION | ||||
| 	These functions provide information on the floating-point | ||||
| 	argument supplied. | ||||
|  | ||||
| 	There are five major number formats -  | ||||
| 	There are five major number formats: | ||||
| 	o+ | ||||
| 	o zero | ||||
| 	 a number which contains all zero bits. | ||||
| 	  A number which contains all zero bits. | ||||
| 	o subnormal | ||||
| 	 Is used to represent  number with a zero exponent, but a nonzero fraction. | ||||
| 	 o normal | ||||
| 	  A number with an exponent, and a fraction | ||||
| 	  A number with a zero exponent but a nonzero fraction. | ||||
| 	o normal | ||||
| 	  A number with an exponent and a fraction. | ||||
|      	o infinity | ||||
| 	  A number with an all 1's exponent and a zero fraction. | ||||
| 	o NAN | ||||
| @@ -77,7 +77,7 @@ DESCRIPTION | ||||
| 	returns 1 if the argument is infinity.  <<finite>> returns 1 if the | ||||
| 	argument is zero, subnormal or normal. | ||||
| 	 | ||||
| 	The <<isnanf>>, <<isinff>> and <<finitef>> perform the same | ||||
| 	The <<isnanf>>, <<isinff>> and <<finitef>> functions perform the same | ||||
| 	operations as their <<isnan>>, <<isinf>> and <<finite>> | ||||
| 	counterparts, but on single-precision floating-point numbers. | ||||
|  | ||||
|   | ||||
| @@ -56,7 +56,7 @@ On underflow, <<ldexp>> and <<ldexpf>> return 0.0. | ||||
| On overflow, <<ldexp>> returns plus or minus <<HUGE_VAL>>. | ||||
|  | ||||
| PORTABILITY | ||||
| <<ldexp>> is ANSI, <<ldexpf>> is an extension. | ||||
| <<ldexp>> is ANSI. <<ldexpf>> is an extension. | ||||
|                | ||||
| */    | ||||
|  | ||||
|   | ||||
| @@ -13,7 +13,7 @@ | ||||
|  | ||||
| /* | ||||
| FUNCTION | ||||
| <<jN>>,<<jNf>>,<<yN>>,<<yNf>>---Bessel functions  | ||||
| <<jN>>, <<jNf>>, <<yN>>, <<yNf>>---Bessel functions  | ||||
|  | ||||
| INDEX | ||||
| j0 | ||||
|   | ||||
| @@ -49,7 +49,7 @@ When <[x]> is negative, the returned value is <<-HUGE_VAL>> and | ||||
| <<matherr>>. | ||||
|  | ||||
| PORTABILITY | ||||
| <<log>> is ANSI, <<logf>> is an extension. | ||||
| <<log>> is ANSI. <<logf>> is an extension. | ||||
| */ | ||||
|  | ||||
| /* | ||||
|   | ||||
| @@ -3,7 +3,7 @@ | ||||
|  | ||||
| /* | ||||
| FUNCTION | ||||
|         <<isnan>>,<<isnanf>>,<<isinf>>,<<isinff>>,<<finite>>,<<finitef>>---test | ||||
|         <<isnan>>, <<isnanf>>, <<isinf>>, <<isinff>>, <<finite>>, <<finitef>>---test | ||||
| for exceptional numbers | ||||
|  | ||||
| INDEX | ||||
| @@ -49,15 +49,14 @@ DESCRIPTION | ||||
|         These functions provide information on the floating-point | ||||
|         argument supplied. | ||||
|  | ||||
|         There are five major number formats - | ||||
|         There are five major number formats: | ||||
|         o+ | ||||
|         o zero | ||||
|          a number which contains all zero bits. | ||||
|           A number which contains all zero bits. | ||||
|         o subnormal | ||||
|          Is used to represent  number with a zero exponent, but a nonzero fract | ||||
| ion. | ||||
|          o normal | ||||
|           A number with an exponent, and a fraction | ||||
|           A number with a zero exponent but a nonzero fraction. | ||||
|         o normal | ||||
|           A number with an exponent and a fraction. | ||||
|         o infinity | ||||
|           A number with an all 1's exponent and a zero fraction. | ||||
|         o NAN | ||||
| @@ -69,7 +68,7 @@ ion. | ||||
|         returns 1 if the argument is infinity.  <<finite>> returns 1 if the | ||||
|         argument is zero, subnormal or normal. | ||||
|  | ||||
|         The <<isnanf>>, <<isinff>> and <<finitef>> perform the same | ||||
|         The <<isnanf>>, <<isinff>> and <<finitef>> functions perform the same | ||||
|         operations as their <<isnan>>, <<isinf>> and <<finite>> | ||||
|         counterparts, but on single-precision floating-point numbers. | ||||
|  | ||||
|   | ||||
| @@ -45,7 +45,7 @@ On underflow, <<ldexp>> and <<ldexpf>> return 0.0. | ||||
| On overflow, <<ldexp>> returns plus or minus <<HUGE_VAL>>. | ||||
|  | ||||
| PORTABILITY | ||||
| <<ldexp>> is ANSI, <<ldexpf>> is an extension. | ||||
| <<ldexp>> is ANSI. <<ldexpf>> is an extension. | ||||
|  | ||||
| */ | ||||
|  | ||||
|   | ||||
| @@ -56,8 +56,9 @@ When <[x]> is negative, the returned value is <<-HUGE_VAL>> and | ||||
| <<matherr>>. | ||||
|  | ||||
| PORTABILITY | ||||
| <<log>> is ANSI, <<logf>> is an extension. | ||||
| <<log10>> is ANSI, <<log10f>> is an extension. | ||||
| <<log>> is ANSI. <<logf>> is an extension. | ||||
|  | ||||
| <<log10>> is ANSI. <<log10f>> is an extension. | ||||
| */ | ||||
|  | ||||
|  | ||||
|   | ||||
| @@ -13,7 +13,7 @@ | ||||
|  | ||||
| /* | ||||
| FUNCTION | ||||
| <<jN>>,<<jNf>>,<<yN>>,<<yNf>>---Bessel functions | ||||
| <<jN>>, <<jNf>>, <<yN>>, <<yNf>>---Bessel functions | ||||
|  | ||||
| INDEX | ||||
| j0 | ||||
|   | ||||
		Reference in New Issue
	
	Block a user