From 239c2bf93e32e147dab3e6cde99078d1ad5a1ef5 Mon Sep 17 00:00:00 2001 From: Jeff Johnston Date: Fri, 28 Oct 2005 21:21:08 +0000 Subject: 2005-10-28 Bob Wilson * 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. --- newlib/libc/misc/unctrl.c | 2 +- newlib/libc/signal/signal.c | 32 +++++------------------- newlib/libc/stdio/getdelim.c | 8 +++--- newlib/libc/stdio/getw.c | 7 +++--- newlib/libc/stdio/putw.c | 5 ++-- newlib/libc/stdlib/a64l.c | 55 ++++++++++++++++++++++------------------- newlib/libc/stdlib/assert.c | 2 +- newlib/libc/stdlib/efgcvt.c | 2 +- newlib/libc/stdlib/envlock.c | 2 +- newlib/libc/stdlib/mlock.c | 2 +- newlib/libc/stdlib/mstats.c | 2 +- newlib/libc/stdlib/rand.c | 4 +-- newlib/libc/stdlib/rand48.c | 2 +- newlib/libc/string/bcmp.c | 2 -- newlib/libc/string/memchr.c | 4 +-- newlib/libc/string/strcspn.c | 2 +- newlib/libc/string/strerror_r.c | 2 +- newlib/libc/string/strncat.c | 1 - newlib/libc/string/strnlen.c | 2 +- newlib/libc/string/strpbrk.c | 2 +- newlib/libc/string/strtok.c | 26 +++++++++---------- newlib/libc/string/wcscat.c | 1 + newlib/libc/string/wcschr.c | 1 + newlib/libc/string/wcscmp.c | 1 + newlib/libc/string/wcscpy.c | 1 + newlib/libc/string/wcscspn.c | 1 + newlib/libc/string/wcslen.c | 1 + newlib/libc/string/wcsncat.c | 1 + newlib/libc/string/wcsncmp.c | 1 + newlib/libc/string/wcsncpy.c | 1 + newlib/libc/string/wcsnlen.c | 3 ++- newlib/libc/string/wcspbrk.c | 1 + newlib/libc/string/wcsrchr.c | 1 + newlib/libc/string/wcsspn.c | 1 + newlib/libc/string/wcswidth.c | 18 +++++++------- newlib/libc/string/wcwidth.c | 12 ++++----- newlib/libc/string/wmemchr.c | 1 + newlib/libc/string/wmemcmp.c | 1 + newlib/libc/string/wmemcpy.c | 1 + newlib/libc/string/wmemmove.c | 3 ++- newlib/libc/string/wmemset.c | 1 + newlib/libc/time/tzlock.c | 2 +- 42 files changed, 111 insertions(+), 109 deletions(-) (limited to 'newlib/libc') diff --git a/newlib/libc/misc/unctrl.c b/newlib/libc/misc/unctrl.c index 710bf16..fa0b90f 100644 --- a/newlib/libc/misc/unctrl.c +++ b/newlib/libc/misc/unctrl.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---translate characters to upper case + <>---get printable representation of a character INDEX unctrl diff --git a/newlib/libc/signal/signal.c b/newlib/libc/signal/signal.c index 20e919e..bfb85e6 100644 --- a/newlib/libc/signal/signal.c +++ b/newlib/libc/signal/signal.c @@ -6,21 +6,12 @@ INDEX signal INDEX _signal_r -INDEX - raise -INDEX - _raise_r ANSI_SYNOPSIS #include - void ( * signal(int <[sig]>, void(*<[func]>)(int)) )(int); - - void ( * _signal_r(void *<[reent]>, - int <[sig]>, void(*<[func]>)(int)) )(int); + void (*signal(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 @@ -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 -<> provide a simple signal/raise implementation for embedded +<> provides a simple signal-handling implementation for embedded targets. <> 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 <> 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 <> and <> to avoid returning. -<> 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 <>, <>. +ANSI C requires <>. No supporting OS subroutines are required to link with <>, but it will not have any useful effects, except for software generated signals, diff --git a/newlib/libc/stdio/getdelim.c b/newlib/libc/stdio/getdelim.c index dad8fee..0fdfb3a 100644 --- a/newlib/libc/stdio/getdelim.c +++ b/newlib/libc/stdio/getdelim.c @@ -1,7 +1,7 @@ /* Copyright 2002, Red Hat Inc. - all rights reserved */ /* FUNCTION -<>---read a line up to a specified line delimeter +<>---read a line up to a specified line delimiter INDEX getdelim @@ -21,16 +21,16 @@ TRAD_SYNOPSIS DESCRIPTION <> 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 <>. As the buffer is grown, the pointer to the size <[n]> will be updated. RETURNS -<> returns <<-1>> if no characters were successfully read, +<> 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 <> is a glibc extension. diff --git a/newlib/libc/stdio/getw.c b/newlib/libc/stdio/getw.c index b5065bd..210c593 100644 --- a/newlib/libc/stdio/getw.c +++ b/newlib/libc/stdio/getw.c @@ -37,14 +37,15 @@ to get the next word from the file or stream identified by <[fp]>. As a side effect, <> advances the file's current position indicator. -RETURNS The next word (read as an <>), 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 <>), unless there is no more +data or the host system reports a read error; in either of these situations, <> returns <>. Since <> is a valid <>, you must use <> or <> to distinguish these situations. PORTABILITY -<> is a remnant of K&R C, it is not part of any ISO C Standard. +<> is a remnant of K&R C; it is not part of any ISO C Standard. <> should be used instead. In fact, this implementation of <> is based upon <>. diff --git a/newlib/libc/stdio/putw.c b/newlib/libc/stdio/putw.c index 78406ee..682015c 100644 --- a/newlib/libc/stdio/putw.c +++ b/newlib/libc/stdio/putw.c @@ -37,10 +37,11 @@ DESCRIPTION to write a word to the file or stream identified by <[fp]>. As a side effect, <> advances the file's current position indicator. -RETURNS Zero on success, <> on failure. +RETURNS +Zero on success, <> on failure. PORTABILITY -<> is a remnant of K&R C, it is not part of any ISO C Standard. +<> is a remnant of K&R C; it is not part of any ISO C Standard. <> should be used instead. In fact, this implementation of <> is based upon <>. diff --git a/newlib/libc/stdlib/a64l.c b/newlib/libc/stdlib/a64l.c index 93c8e83..42fc2d2 100644 --- a/newlib/libc/stdlib/a64l.c +++ b/newlib/libc/stdlib/a64l.c @@ -1,6 +1,6 @@ /* FUNCTION -<>,<>---convert between radix-64 ascii string and long +<>, <>---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 <> 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: - - 0 = '.' - 1 = '/' - 2-11 = '0' to '9' - 12-37 = 'A' to 'Z' - 38-63 = 'a' to 'z' - -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. - -The <> 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. - +Conversion is performed between long and radix-64 characters. The +<> 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: + +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 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 <> 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. + RETURNS -<> returns a nul-terminated string of 0 to 6 characters. +<> returns a null-terminated string of 0 to 6 characters. <> returns the 32-bit translated value from the input character string. PORTABILITY diff --git a/newlib/libc/stdlib/assert.c b/newlib/libc/stdlib/assert.c index 5b08bba..c9887da 100644 --- a/newlib/libc/stdlib/assert.c +++ b/newlib/libc/stdlib/assert.c @@ -1,6 +1,6 @@ /* FUNCTION -<>---Macro for Debugging Diagnostics +<>---macro for debugging diagnostics INDEX assert diff --git a/newlib/libc/stdlib/efgcvt.c b/newlib/libc/stdlib/efgcvt.c index 556d224..9aa3b2f 100644 --- a/newlib/libc/stdlib/efgcvt.c +++ b/newlib/libc/stdlib/efgcvt.c @@ -1,6 +1,6 @@ /* FUNCTION -<>,<>,<>,<>---double or float to string +<>, <>, <>, <>---double or float to string INDEX ecvt diff --git a/newlib/libc/stdlib/envlock.c b/newlib/libc/stdlib/envlock.c index 24d0083..74c85a8 100644 --- a/newlib/libc/stdlib/envlock.c +++ b/newlib/libc/stdlib/envlock.c @@ -1,6 +1,6 @@ /* FUNCTION -<<__env_lock>>, <<__env_unlock>>--lock environ variable +<<__env_lock>>, <<__env_unlock>>---lock environ variable INDEX __env_lock diff --git a/newlib/libc/stdlib/mlock.c b/newlib/libc/stdlib/mlock.c index 378b4e6..888c986 100644 --- a/newlib/libc/stdlib/mlock.c +++ b/newlib/libc/stdlib/mlock.c @@ -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 diff --git a/newlib/libc/stdlib/mstats.c b/newlib/libc/stdlib/mstats.c index 42b5db2..ba89f49 100644 --- a/newlib/libc/stdlib/mstats.c +++ b/newlib/libc/stdlib/mstats.c @@ -10,7 +10,7 @@ int _dummy_mstats = 1; /* FUNCTION -<>, <>, <>--malloc support +<>, <>, <>---malloc support INDEX mallinfo diff --git a/newlib/libc/stdlib/rand.c b/newlib/libc/stdlib/rand.c index 4f5a607..6a46aa8 100644 --- a/newlib/libc/stdlib/rand.c +++ b/newlib/libc/stdlib/rand.c @@ -51,8 +51,8 @@ number between <<0>> and <> (inclusive). <> does not return a result. NOTES -<> and <> are unsafe for multi-thread applications. -<> is MT-Safe and should be used instead. +<> and <> are unsafe for multi-threaded applications. +<> is thread-safe and should be used instead. PORTABILITY diff --git a/newlib/libc/stdlib/rand48.c b/newlib/libc/stdlib/rand48.c index 17fd04e..af2be3c 100644 --- a/newlib/libc/stdlib/rand48.c +++ b/newlib/libc/stdlib/rand48.c @@ -13,7 +13,7 @@ /* FUNCTION - <>, <>, <>, <>, <>, <>, <>, <>, <>, <> ---pseudo random number generators and initialization routines + <>, <>, <>, <>, <>, <>, <>, <>, <>, <>---pseudo-random number generators and initialization routines INDEX rand48 diff --git a/newlib/libc/string/bcmp.c b/newlib/libc/string/bcmp.c index 23e7c26..e8d0573 100644 --- a/newlib/libc/string/bcmp.c +++ b/newlib/libc/string/bcmp.c @@ -21,8 +21,6 @@ DESCRIPTION object pointed to by <[s1]> with the object pointed to by <[s2]>. This function is identical to <>. - - RETURNS The function returns an integer greater than, equal to or diff --git a/newlib/libc/string/memchr.c b/newlib/libc/string/memchr.c index 2fd3c86..7c1a584 100644 --- a/newlib/libc/string/memchr.c +++ b/newlib/libc/string/memchr.c @@ -28,9 +28,9 @@ RETURNS <[c]> is not found, then <> is returned. PORTABILITY -<>> is ANSI C. +<> is ANSI C. -<> requires no supporting OS subroutines. +<> requires no supporting OS subroutines. QUICKREF memchr ansi pure diff --git a/newlib/libc/string/strcspn.c b/newlib/libc/string/strcspn.c index fe68b8f..403330c 100644 --- a/newlib/libc/string/strcspn.c +++ b/newlib/libc/string/strcspn.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---count chars not in string + <>---count characters not in string INDEX strcspn diff --git a/newlib/libc/string/strerror_r.c b/newlib/libc/string/strerror_r.c index 956a1f4..be5358f 100644 --- a/newlib/libc/string/strerror_r.c +++ b/newlib/libc/string/strerror_r.c @@ -30,7 +30,7 @@ This function returns a pointer to a string. Your application must not modify that string. PORTABILITY -<> is a gnu extension. +<> is a GNU extension. <> requires no supporting OS subroutines. diff --git a/newlib/libc/string/strncat.c b/newlib/libc/string/strncat.c index 57ca068..0f29247 100644 --- a/newlib/libc/string/strncat.c +++ b/newlib/libc/string/strncat.c @@ -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 <>. - RETURNS This function returns the initial value of <[dst]> diff --git a/newlib/libc/string/strnlen.c b/newlib/libc/string/strnlen.c index b9a3b5e..92826ee 100644 --- a/newlib/libc/string/strnlen.c +++ b/newlib/libc/string/strnlen.c @@ -25,7 +25,7 @@ RETURNS <> returns the character count or <[n]>. PORTABILITY -<> is a Gnu extension. +<> is a GNU extension. <> requires no supporting OS subroutines. diff --git a/newlib/libc/string/strpbrk.c b/newlib/libc/string/strpbrk.c index e7f2dd2..5668db3 100644 --- a/newlib/libc/string/strpbrk.c +++ b/newlib/libc/string/strpbrk.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---find chars in string + <>---find characters in string INDEX strpbrk diff --git a/newlib/libc/string/strtok.c b/newlib/libc/string/strtok.c index 8d53290..7640fb7 100644 --- a/newlib/libc/string/strtok.c +++ b/newlib/libc/string/strtok.c @@ -1,6 +1,6 @@ /* FUNCTION - <>,<>,<>---get next token from a string + <>, <>, <>---get next token from a string INDEX strtok @@ -40,25 +40,25 @@ DESCRIPTION The first time that <> 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 <> 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 <> function has the same behavior as <>, except - a pointer to placeholder <<*[lasts]>> must be supplied by the caller. + a pointer to placeholder <<*<[lasts]>>> must be supplied by the caller. The <> function is similar in behavior to <>, 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 <> and <>, 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 <>, <>, and <> all return a pointer to the @@ -66,13 +66,13 @@ RETURNS <>, a token may be the empty string. NOTES - <> is unsafe for multi-thread applications. <> - and <> are MT-Safe and should be used instead. + <> is unsafe for multi-threaded applications. <> + and <> are thread-safe and should be used instead. PORTABILITY <> is ANSI C. <> is POSIX. -<> is a BSD-extension. +<> is a BSD extension. <>, <>, and <> require no supporting OS subroutines. diff --git a/newlib/libc/string/wcscat.c b/newlib/libc/string/wcscat.c index b3a3bd9..54c0b50 100644 --- a/newlib/libc/string/wcscat.c +++ b/newlib/libc/string/wcscat.c @@ -27,6 +27,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wcschr.c b/newlib/libc/string/wcschr.c index acc07a5..fb35d1f 100644 --- a/newlib/libc/string/wcschr.c +++ b/newlib/libc/string/wcschr.c @@ -24,6 +24,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wcscmp.c b/newlib/libc/string/wcscmp.c index 279f3a9..0308962 100644 --- a/newlib/libc/string/wcscmp.c +++ b/newlib/libc/string/wcscmp.c @@ -26,6 +26,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wcscpy.c b/newlib/libc/string/wcscpy.c index 5a72338..ede693d 100644 --- a/newlib/libc/string/wcscpy.c +++ b/newlib/libc/string/wcscpy.c @@ -23,6 +23,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wcscspn.c b/newlib/libc/string/wcscspn.c index 7e53cc1..5ab9656 100644 --- a/newlib/libc/string/wcscspn.c +++ b/newlib/libc/string/wcscspn.c @@ -23,6 +23,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wcslen.c b/newlib/libc/string/wcslen.c index d68f00a..d671551 100644 --- a/newlib/libc/string/wcslen.c +++ b/newlib/libc/string/wcslen.c @@ -21,6 +21,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wcsncat.c b/newlib/libc/string/wcsncat.c index 2ba2934..fd77c0c 100644 --- a/newlib/libc/string/wcsncat.c +++ b/newlib/libc/string/wcsncat.c @@ -29,6 +29,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wcsncmp.c b/newlib/libc/string/wcsncmp.c index 48cb96c..1897f5c 100644 --- a/newlib/libc/string/wcsncmp.c +++ b/newlib/libc/string/wcsncmp.c @@ -30,6 +30,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wcsncpy.c b/newlib/libc/string/wcsncpy.c index afe75a2..b53e9c3 100644 --- a/newlib/libc/string/wcsncpy.c +++ b/newlib/libc/string/wcsncpy.c @@ -30,6 +30,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wcsnlen.c b/newlib/libc/string/wcsnlen.c index e84342d..3804bdf 100644 --- a/newlib/libc/string/wcsnlen.c +++ b/newlib/libc/string/wcsnlen.c @@ -27,7 +27,8 @@ RETURNS characters. PORTABILITY -<> is GNU extension.. +<> is a GNU extension. + <> requires no supporting OS subroutines. */ diff --git a/newlib/libc/string/wcspbrk.c b/newlib/libc/string/wcspbrk.c index bfe793b..fbdf9e4 100644 --- a/newlib/libc/string/wcspbrk.c +++ b/newlib/libc/string/wcspbrk.c @@ -23,6 +23,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wcsrchr.c b/newlib/libc/string/wcsrchr.c index d3dc743..495d95a 100644 --- a/newlib/libc/string/wcsrchr.c +++ b/newlib/libc/string/wcsrchr.c @@ -27,6 +27,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wcsspn.c b/newlib/libc/string/wcsspn.c index b54804c..e83f42f 100644 --- a/newlib/libc/string/wcsspn.c +++ b/newlib/libc/string/wcsspn.c @@ -23,6 +23,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wcswidth.c b/newlib/libc/string/wcswidth.c index bd3d9bb..8a9670e 100644 --- a/newlib/libc/string/wcswidth.c +++ b/newlib/libc/string/wcswidth.c @@ -17,22 +17,22 @@ TRAD_SYNOPSIS DESCRIPTION The <> 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 <> function either shall return 0 (if pwcs points to a + The <> 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 -<> has been introduced in the Single UNIX Specification Volume 2 -<> has been marked as extension in Single UNIX Specification Volume 3 +<> has been introduced in the Single UNIX Specification Volume 2. +<> has been marked as an extension in the Single UNIX Specification Volume 3. */ #include <_ansi.h> diff --git a/newlib/libc/string/wcwidth.c b/newlib/libc/string/wcwidth.c index 2cbd59e..d886b4a 100644 --- a/newlib/libc/string/wcwidth.c +++ b/newlib/libc/string/wcwidth.c @@ -16,15 +16,15 @@ TRAD_SYNOPSIS DESCRIPTION The <> 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 <> function shall either return 0 (if wc is a null + The <> 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 <> simply sets the width @@ -32,8 +32,8 @@ RETURNS tables around. PORTABILITY -<> has been introduced in the Single UNIX Specification Volume 2 -<> has been marked as extension in Single UNIX Specification Volume 3 +<> has been introduced in the Single UNIX Specification Volume 2. +<> has been marked as an extension in the Single UNIX Specification Volume 3. */ #include <_ansi.h> diff --git a/newlib/libc/string/wmemchr.c b/newlib/libc/string/wmemchr.c index e999913..ca1427b 100644 --- a/newlib/libc/string/wmemchr.c +++ b/newlib/libc/string/wmemchr.c @@ -30,6 +30,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wmemcmp.c b/newlib/libc/string/wmemcmp.c index 5107294..96c2b76 100644 --- a/newlib/libc/string/wmemcmp.c +++ b/newlib/libc/string/wmemcmp.c @@ -30,6 +30,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wmemcpy.c b/newlib/libc/string/wmemcpy.c index c3a96a3..24de885 100644 --- a/newlib/libc/string/wmemcpy.c +++ b/newlib/libc/string/wmemcpy.c @@ -27,6 +27,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wmemmove.c b/newlib/libc/string/wmemmove.c index f49e359..6986fde 100644 --- a/newlib/libc/string/wmemmove.c +++ b/newlib/libc/string/wmemmove.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---wmemmove - copy wide-characters in memory with overlapping areas + <>---copy wide characters in memory with overlapping areas ANSI_SYNOPSIS #include @@ -33,6 +33,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/string/wmemset.c b/newlib/libc/string/wmemset.c index 4e05b93..b426f56 100644 --- a/newlib/libc/string/wmemset.c +++ b/newlib/libc/string/wmemset.c @@ -27,6 +27,7 @@ RETURNS PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). + No supporting OS subroutines are required. */ diff --git a/newlib/libc/time/tzlock.c b/newlib/libc/time/tzlock.c index f3c2896..ccfef78 100644 --- a/newlib/libc/time/tzlock.c +++ b/newlib/libc/time/tzlock.c @@ -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 -- cgit v1.1