From 9746f0ddf302645234d16fd54c26a7f0bde243ad Mon Sep 17 00:00:00 2001 From: jjohnstn Date: Fri, 28 Oct 2005 21:33:21 +0000 Subject: [PATCH] 2005-10-28 Bob Wilson * libc/ctype/ctype.tex: Use hyphens as appropriate, but not otherwise. * libc/ctype/islower.c: Likewise. * libc/ctype/isupper.c: Likewise. * libc/ctype/iswalnum.c: Likewise. * libc/ctype/iswalpha.c: Likewise. * libc/ctype/iswblank.c: Likewise. * libc/ctype/iswcntrl.c: Likewise. * libc/ctype/iswdigit.c: Likewise. * libc/ctype/iswgraph.c: Likewise. * libc/ctype/iswlower.c: Likewise. * libc/ctype/iswprint.c: Likewise. * libc/ctype/iswpunct.c: Likewise. * libc/ctype/iswspace.c: Likewise. * libc/ctype/iswupper.c: Likewise. * libc/ctype/iswxdigit.c: Likewise. * libc/ctype/tolower.c: Likewise. * libc/ctype/toupper.c: Likewise. * libc/ctype/towctrans.c: Likewise. * libc/ctype/towlower.c: Likewise. * libc/ctype/towupper.c: Likewise. * libc/string/strcasecmp.c: Likewise. * libc/string/strcoll.c: Likewise. * libc/string/strings.tex: Likewise. * libc/string/strlwr.c: Likewise. * libc/string/strncasecmp.c: Likewise. * libc/string/strupr.c: Likewise. * libc/string/wcscoll.c: Likewise. * libc/string/wcslcat.c: Likewise. * libc/string/wcslcpy.c: Likewise. * libc/string/wcsnlen.c: Likewise. * libc/string/wcsstr.c: Likewise. * libc/string/wcstrings.tex: Likewise. * libc/string/wmemchr.c: Likewise. * libc/string/wmemcmp.c: Likewise. * libc/string/wmemcpy.c: Likewise. * libc/string/wmemmove.c: Likewise. * libc/string/wmemset.c: Likewise. --- newlib/ChangeLog | 40 ++++++++++++++++++++++++++++++++++++++++ newlib/libc/ctype/ctype.tex | 36 ++++++++++++++++++------------------ newlib/libc/ctype/islower.c | 6 +++--- newlib/libc/ctype/isupper.c | 4 ++-- newlib/libc/ctype/iswalnum.c | 6 +++--- newlib/libc/ctype/iswalpha.c | 4 ++-- newlib/libc/ctype/iswblank.c | 4 ++-- newlib/libc/ctype/iswcntrl.c | 6 +++--- newlib/libc/ctype/iswdigit.c | 4 ++-- newlib/libc/ctype/iswgraph.c | 4 ++-- newlib/libc/ctype/iswlower.c | 6 +++--- newlib/libc/ctype/iswprint.c | 4 ++-- newlib/libc/ctype/iswpunct.c | 4 ++-- newlib/libc/ctype/iswspace.c | 6 +++--- newlib/libc/ctype/iswupper.c | 6 +++--- newlib/libc/ctype/iswxdigit.c | 6 +++--- newlib/libc/ctype/tolower.c | 10 +++++----- newlib/libc/ctype/toupper.c | 10 +++++----- newlib/libc/ctype/towctrans.c | 4 ++-- newlib/libc/ctype/towlower.c | 10 +++++----- newlib/libc/ctype/towupper.c | 10 +++++----- newlib/libc/string/strcasecmp.c | 4 ++-- newlib/libc/string/strcoll.c | 2 +- newlib/libc/string/strings.tex | 4 ++-- newlib/libc/string/strlwr.c | 6 +++--- newlib/libc/string/strncasecmp.c | 4 ++-- newlib/libc/string/strupr.c | 4 ++-- newlib/libc/string/wcscoll.c | 2 +- newlib/libc/string/wcslcat.c | 12 ++++++------ newlib/libc/string/wcslcpy.c | 8 ++++---- newlib/libc/string/wcsnlen.c | 6 +++--- newlib/libc/string/wcsstr.c | 2 +- newlib/libc/string/wcstrings.tex | 16 ++++++++-------- newlib/libc/string/wmemchr.c | 8 ++++---- newlib/libc/string/wmemcmp.c | 8 ++++---- newlib/libc/string/wmemcpy.c | 8 ++++---- newlib/libc/string/wmemmove.c | 12 ++++++------ newlib/libc/string/wmemset.c | 10 +++++----- 38 files changed, 173 insertions(+), 133 deletions(-) diff --git a/newlib/ChangeLog b/newlib/ChangeLog index 7bae151d5f..467033bc86 100644 --- a/newlib/ChangeLog +++ b/newlib/ChangeLog @@ -1,5 +1,45 @@ 2005-10-28 Bob Wilson + * libc/ctype/ctype.tex: Use hyphens as appropriate, but not otherwise. + * libc/ctype/islower.c: Likewise. + * libc/ctype/isupper.c: Likewise. + * libc/ctype/iswalnum.c: Likewise. + * libc/ctype/iswalpha.c: Likewise. + * libc/ctype/iswblank.c: Likewise. + * libc/ctype/iswcntrl.c: Likewise. + * libc/ctype/iswdigit.c: Likewise. + * libc/ctype/iswgraph.c: Likewise. + * libc/ctype/iswlower.c: Likewise. + * libc/ctype/iswprint.c: Likewise. + * libc/ctype/iswpunct.c: Likewise. + * libc/ctype/iswspace.c: Likewise. + * libc/ctype/iswupper.c: Likewise. + * libc/ctype/iswxdigit.c: Likewise. + * libc/ctype/tolower.c: Likewise. + * libc/ctype/toupper.c: Likewise. + * libc/ctype/towctrans.c: Likewise. + * libc/ctype/towlower.c: Likewise. + * libc/ctype/towupper.c: Likewise. + * libc/string/strcasecmp.c: Likewise. + * libc/string/strcoll.c: Likewise. + * libc/string/strings.tex: Likewise. + * libc/string/strlwr.c: Likewise. + * libc/string/strncasecmp.c: Likewise. + * libc/string/strupr.c: Likewise. + * libc/string/wcscoll.c: Likewise. + * libc/string/wcslcat.c: Likewise. + * libc/string/wcslcpy.c: Likewise. + * libc/string/wcsnlen.c: Likewise. + * libc/string/wcsstr.c: Likewise. + * libc/string/wcstrings.tex: Likewise. + * libc/string/wmemchr.c: Likewise. + * libc/string/wmemcmp.c: Likewise. + * libc/string/wmemcpy.c: Likewise. + * libc/string/wmemmove.c: Likewise. + * libc/string/wmemset.c: Likewise. + +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. diff --git a/newlib/libc/ctype/ctype.tex b/newlib/libc/ctype/ctype.tex index bfdc929f7e..d15e86b30e 100644 --- a/newlib/libc/ctype/ctype.tex +++ b/newlib/libc/ctype/ctype.tex @@ -12,32 +12,32 @@ The header file @file{ctype.h} defines the macros. * isascii:: ASCII character predicate * iscntrl:: Control character predicate * isdigit:: Decimal digit predicate -* islower:: Lower-case character predicate +* islower:: Lowercase character predicate * isprint:: Printable character predicates (isprint, isgraph) * ispunct:: Punctuation character predicate * isspace:: Whitespace character predicate * isupper:: Uppercase character predicate * isxdigit:: Hexadecimal digit predicate * toascii:: Force integers to ASCII range -* tolower:: Translate characters to lower case -* toupper:: Translate characters to upper case -* iswalnum:: Alphanumeric wide-character predicate -* iswalpha:: Alphabetic wide-character predicate -* iswblank:: Blank wide-character predicate -* iswcntrl:: Control wide-character predicate -* iswdigit:: Decimal digit wide-character predicate -* iswgraph:: Graphic wide-character predicate -* iswlower:: Lower-case wide-character predicate -* iswprint:: Printable wide-character predicate -* iswpunct:: Punctuation wide-character predicate -* iswspace:: Whitespace wide-character predicate -* iswupper:: Uppercase wide-character predicate -* iswxdigit:: Hexadecimal digit wide-character predicate +* tolower:: Translate characters to lowercase +* toupper:: Translate characters to uppercase +* iswalnum:: Alphanumeric wide character predicate +* iswalpha:: Alphabetic wide character predicate +* iswblank:: Blank wide character predicate +* iswcntrl:: Control wide character predicate +* iswdigit:: Decimal digit wide character predicate +* iswgraph:: Graphic wide character predicate +* iswlower:: Lowercase wide character predicate +* iswprint:: Printable wide character predicate +* iswpunct:: Punctuation wide character predicate +* iswspace:: Whitespace wide character predicate +* iswupper:: Uppercase wide character predicate +* iswxdigit:: Hexadecimal digit wide character predicate * iswctype:: Extensible wide-character test * wctype:: Compute wide-character test type -* towlower:: Translate wide-characters to lower case -* towupper:: Translate wide-characters to upper case -* towctrans:: Extensible wide-character case mapping +* towlower:: Translate wide characters to lowercase +* towupper:: Translate wide characters to uppercase +* towctrans:: Extensible wide-character translation * wctrans:: Compute wide-character translation type @end menu diff --git a/newlib/libc/ctype/islower.c b/newlib/libc/ctype/islower.c index 81ad0bb276..cda484367c 100644 --- a/newlib/libc/ctype/islower.c +++ b/newlib/libc/ctype/islower.c @@ -1,7 +1,7 @@ /* FUNCTION -<>---lower-case character predicate +<>---lowercase character predicate INDEX islower @@ -17,14 +17,14 @@ int islower(<[c]>); DESCRIPTION <> is a macro which classifies ASCII integer values by table lookup. It is a predicate returning non-zero for minuscules -(lower-case alphabetic characters), and 0 for other characters. +(lowercase alphabetic characters), and 0 for other characters. It is defined only when <>(<[c]>) is true or <[c]> is EOF. You can use a compiled subroutine instead of the macro definition by undefining the macro using `<<#undef islower>>'. RETURNS -<> returns non-zero if <[c]> is a lower case letter (<>--<>). +<> returns non-zero if <[c]> is a lowercase letter (<>--<>). PORTABILITY <> is ANSI C. diff --git a/newlib/libc/ctype/isupper.c b/newlib/libc/ctype/isupper.c index 8127e25dab..4cf9e9a2de 100644 --- a/newlib/libc/ctype/isupper.c +++ b/newlib/libc/ctype/isupper.c @@ -16,7 +16,7 @@ int isupper(<[c]>); DESCRIPTION <> is a macro which classifies ASCII integer values by table -lookup. It is a predicate returning non-zero for upper-case letters +lookup. It is a predicate returning non-zero for uppercase letters (<>--<>), and 0 for other characters. It is defined only when <>(<[c]>) is true or <[c]> is EOF. @@ -24,7 +24,7 @@ You can use a compiled subroutine instead of the macro definition by undefining the macro using `<<#undef isupper>>'. RETURNS -<> returns non-zero if <[c]> is a upper case letter (A-Z). +<> returns non-zero if <[c]> is a uppercase letter (A-Z). PORTABILITY <> is ANSI C. diff --git a/newlib/libc/ctype/iswalnum.c b/newlib/libc/ctype/iswalnum.c index 12613c7a1c..c417cb31e4 100644 --- a/newlib/libc/ctype/iswalnum.c +++ b/newlib/libc/ctype/iswalnum.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---alpha-numeric wide-character test + <>---alphanumeric wide character test INDEX iswalnum @@ -16,10 +16,10 @@ TRAD_SYNOPSIS DESCRIPTION <> is a function which classifies wide-character values that -are alpha-numeric. +are alphanumeric. RETURNS -<> returns non-zero if <[c]> is a alpha-numeric wide-character. +<> returns non-zero if <[c]> is a alphanumeric wide character. PORTABILITY <> is C99. diff --git a/newlib/libc/ctype/iswalpha.c b/newlib/libc/ctype/iswalpha.c index 0e987a9926..7f8de8e59c 100644 --- a/newlib/libc/ctype/iswalpha.c +++ b/newlib/libc/ctype/iswalpha.c @@ -29,7 +29,7 @@ /* FUNCTION - <>---alphabetic wide-character test + <>---alphabetic wide character test INDEX iswalpha @@ -48,7 +48,7 @@ DESCRIPTION are alphabetic. RETURNS -<> returns non-zero if <[c]> is an alphabetic wide-character. +<> returns non-zero if <[c]> is an alphabetic wide character. PORTABILITY <> is C99. diff --git a/newlib/libc/ctype/iswblank.c b/newlib/libc/ctype/iswblank.c index b10756d5e1..48205bb178 100644 --- a/newlib/libc/ctype/iswblank.c +++ b/newlib/libc/ctype/iswblank.c @@ -29,7 +29,7 @@ /* FUNCTION - <>---wide-character blank test + <>---blank wide character test INDEX iswblank @@ -48,7 +48,7 @@ DESCRIPTION are categorized as blank. RETURNS -<> returns non-zero if <[c]> is a blank wide-character. +<> returns non-zero if <[c]> is a blank wide character. PORTABILITY <> is C99. diff --git a/newlib/libc/ctype/iswcntrl.c b/newlib/libc/ctype/iswcntrl.c index d09295225a..15ff1fa67f 100644 --- a/newlib/libc/ctype/iswcntrl.c +++ b/newlib/libc/ctype/iswcntrl.c @@ -29,7 +29,7 @@ /* FUNCTION - <>---wide-character cntrl test + <>---control wide character test INDEX iswcntrl @@ -45,10 +45,10 @@ TRAD_SYNOPSIS DESCRIPTION <> is a function which classifies wide-character values that -are categorized as a control character. +are categorized as control characters. RETURNS -<> returns non-zero if <[c]> is a control wide-character. +<> returns non-zero if <[c]> is a control wide character. PORTABILITY <> is C99. diff --git a/newlib/libc/ctype/iswdigit.c b/newlib/libc/ctype/iswdigit.c index 94c74ae9cf..8ba5d5f0e9 100644 --- a/newlib/libc/ctype/iswdigit.c +++ b/newlib/libc/ctype/iswdigit.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---decimal digit wide-character test + <>---decimal digit wide character test INDEX iswdigit @@ -19,7 +19,7 @@ DESCRIPTION are decimal digits. RETURNS -<> returns non-zero if <[c]> is a decimal digit wide-character. +<> returns non-zero if <[c]> is a decimal digit wide character. PORTABILITY <> is C99. diff --git a/newlib/libc/ctype/iswgraph.c b/newlib/libc/ctype/iswgraph.c index 880c66478b..bb1e519f12 100644 --- a/newlib/libc/ctype/iswgraph.c +++ b/newlib/libc/ctype/iswgraph.c @@ -29,7 +29,7 @@ /* FUNCTION - <>---graphic wide-character test + <>---graphic wide character test INDEX iswgraph @@ -48,7 +48,7 @@ DESCRIPTION are graphic. RETURNS -<> returns non-zero if <[c]> is a graphic wide-character. +<> returns non-zero if <[c]> is a graphic wide character. PORTABILITY <> is C99. diff --git a/newlib/libc/ctype/iswlower.c b/newlib/libc/ctype/iswlower.c index d320486a97..683a9cbb05 100644 --- a/newlib/libc/ctype/iswlower.c +++ b/newlib/libc/ctype/iswlower.c @@ -1,7 +1,7 @@ /* FUNCTION - <>---lower-case wide-character test + <>---lowercase wide character test INDEX iswlower @@ -17,10 +17,10 @@ TRAD_SYNOPSIS DESCRIPTION <> is a function which classifies wide-character values that -have an upper-case translation. +have uppercase translations. RETURNS -<> returns non-zero if <[c]> is a lower-case wide-character. +<> returns non-zero if <[c]> is a lowercase wide character. PORTABILITY <> is C99. diff --git a/newlib/libc/ctype/iswprint.c b/newlib/libc/ctype/iswprint.c index f4ec087529..6c0cc553d8 100644 --- a/newlib/libc/ctype/iswprint.c +++ b/newlib/libc/ctype/iswprint.c @@ -29,7 +29,7 @@ /* FUNCTION - <>---printable wide-character test + <>---printable wide character test INDEX iswprint @@ -48,7 +48,7 @@ DESCRIPTION are printable. RETURNS -<> returns non-zero if <[c]> is a printable wide-character. +<> returns non-zero if <[c]> is a printable wide character. PORTABILITY <> is C99. diff --git a/newlib/libc/ctype/iswpunct.c b/newlib/libc/ctype/iswpunct.c index 88442b6ca9..c6a4eda831 100644 --- a/newlib/libc/ctype/iswpunct.c +++ b/newlib/libc/ctype/iswpunct.c @@ -29,7 +29,7 @@ /* FUNCTION - <>---punctuation wide-character test + <>---punctuation wide character test INDEX iswpunct @@ -48,7 +48,7 @@ DESCRIPTION are punctuation. RETURNS -<> returns non-zero if <[c]> is a punctuation wide-character. +<> returns non-zero if <[c]> is a punctuation wide character. PORTABILITY <> is C99. diff --git a/newlib/libc/ctype/iswspace.c b/newlib/libc/ctype/iswspace.c index f4d0a0b917..e10a35df67 100644 --- a/newlib/libc/ctype/iswspace.c +++ b/newlib/libc/ctype/iswspace.c @@ -29,7 +29,7 @@ /* FUNCTION - <>---wide-character space test + <>---whitespace wide character test INDEX iswspace @@ -45,10 +45,10 @@ TRAD_SYNOPSIS DESCRIPTION <> is a function which classifies wide-character values that -are categorized as white-space. +are categorized as whitespace. RETURNS -<> returns non-zero if <[c]> is a white-space wide-character. +<> returns non-zero if <[c]> is a whitespace wide character. PORTABILITY <> is C99. diff --git a/newlib/libc/ctype/iswupper.c b/newlib/libc/ctype/iswupper.c index 872475da22..424d65240d 100644 --- a/newlib/libc/ctype/iswupper.c +++ b/newlib/libc/ctype/iswupper.c @@ -1,7 +1,7 @@ /* FUNCTION - <>---upper-case wide-character test + <>---uppercase wide character test INDEX iswupper @@ -17,10 +17,10 @@ TRAD_SYNOPSIS DESCRIPTION <> is a function which classifies wide-character values that -have an upper-case translation. +have uppercase translations. RETURNS -<> returns non-zero if <[c]> is a upper-case wide-character. +<> returns non-zero if <[c]> is a uppercase wide character. PORTABILITY <> is C99. diff --git a/newlib/libc/ctype/iswxdigit.c b/newlib/libc/ctype/iswxdigit.c index 73d8fa4450..4cf76fa256 100644 --- a/newlib/libc/ctype/iswxdigit.c +++ b/newlib/libc/ctype/iswxdigit.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---hexadecimal digit wide-character test + <>---hexadecimal digit wide character test INDEX iswxdigit @@ -15,11 +15,11 @@ TRAD_SYNOPSIS wint_t <[c]>; DESCRIPTION -<> is a function which classifies wide-character values that +<> is a function which classifies wide character values that are hexadecimal digits. RETURNS -<> returns non-zero if <[c]> is a hexadecimal digit wide-character. +<> returns non-zero if <[c]> is a hexadecimal digit wide character. PORTABILITY <> is C99. diff --git a/newlib/libc/ctype/tolower.c b/newlib/libc/ctype/tolower.c index e43fa6c9d1..bdd22bfc58 100644 --- a/newlib/libc/ctype/tolower.c +++ b/newlib/libc/ctype/tolower.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---translate characters to lower case + <>---translate characters to lowercase INDEX tolower @@ -19,8 +19,8 @@ TRAD_SYNOPSIS DESCRIPTION -<> is a macro which converts upper-case characters to lower -case, leaving all other characters unchanged. It is only defined when +<> is a macro which converts uppercase characters to lowercase, +leaving all other characters unchanged. It is only defined when <[c]> is an integer in the range <> to <<255>>. You can use a compiled subroutine instead of the macro definition by @@ -30,10 +30,10 @@ undefining this macro using `<<#undef tolower>>'. only be used when <[c]> is known to be an uppercase character (<>--<>). RETURNS -<> returns the lower-case equivalent of <[c]> when it is a +<> returns the lowercase equivalent of <[c]> when it is a character between <> and <>, and <[c]> otherwise. -<<_tolower>> returns the lower-case equivalent of <[c]> when it is a +<<_tolower>> returns the lowercase equivalent of <[c]> when it is a character between <> and <>. If <[c]> is not one of these characters, the behaviour of <<_tolower>> is undefined. diff --git a/newlib/libc/ctype/toupper.c b/newlib/libc/ctype/toupper.c index 7977beb79d..26f64b6dc5 100644 --- a/newlib/libc/ctype/toupper.c +++ b/newlib/libc/ctype/toupper.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---translate characters to upper case + <>---translate characters to uppercase INDEX toupper @@ -19,8 +19,8 @@ TRAD_SYNOPSIS DESCRIPTION -<> is a macro which converts lower-case characters to upper -case, leaving all other characters unchanged. It is only defined when +<> is a macro which converts lowercase characters to uppercase, +leaving all other characters unchanged. It is only defined when <[c]> is an integer in the range <> to <<255>>. You can use a compiled subroutine instead of the macro definition by @@ -30,10 +30,10 @@ undefining this macro using `<<#undef toupper>>'. only be used when <[c]> is known to be a lowercase character (<>--<>). RETURNS -<> returns the upper-case equivalent of <[c]> when it is a +<> returns the uppercase equivalent of <[c]> when it is a character between <> and <>, and <[c]> otherwise. -<<_toupper>> returns the upper-case equivalent of <[c]> when it is a +<<_toupper>> returns the uppercase equivalent of <[c]> when it is a character between <> and <>. If <[c]> is not one of these characters, the behaviour of <<_toupper>> is undefined. diff --git a/newlib/libc/ctype/towctrans.c b/newlib/libc/ctype/towctrans.c index cf21626703..416a491d33 100644 --- a/newlib/libc/ctype/towctrans.c +++ b/newlib/libc/ctype/towctrans.c @@ -29,7 +29,7 @@ /* FUNCTION - <>---extensible wide-character case mapping + <>---extensible wide-character translation INDEX towctrans @@ -46,7 +46,7 @@ TRAD_SYNOPSIS DESCRIPTION -<> is a function which converts wide-characters based on +<> is a function which converts wide characters based on a specified translation type <[w]>. If the translation type is invalid or cannot be applied to the current character, no change to the character is made. diff --git a/newlib/libc/ctype/towlower.c b/newlib/libc/ctype/towlower.c index 5c36a31a6b..89873c2f1e 100644 --- a/newlib/libc/ctype/towlower.c +++ b/newlib/libc/ctype/towlower.c @@ -29,7 +29,7 @@ /* FUNCTION - <>---translate wide-characters to lower case + <>---translate wide characters to lowercase INDEX towlower @@ -45,12 +45,12 @@ TRAD_SYNOPSIS DESCRIPTION -<> is a function which converts upper-case wide-characters to lower -case, leaving all other characters unchanged. +<> is a function which converts uppercase wide characters to +lowercase, leaving all other characters unchanged. RETURNS -<> returns the lower-case equivalent of <[c]> when it is a -upper-case wide-character, otherwise, it returns the input character. +<> returns the lowercase equivalent of <[c]> when it is a +uppercase wide character; otherwise, it returns the input character. PORTABILITY <> is C99. diff --git a/newlib/libc/ctype/towupper.c b/newlib/libc/ctype/towupper.c index 530aebf3a4..ec6c4ffa43 100644 --- a/newlib/libc/ctype/towupper.c +++ b/newlib/libc/ctype/towupper.c @@ -29,7 +29,7 @@ /* FUNCTION - <>---translate wide-characters to upper case + <>---translate wide characters to uppercase INDEX towupper @@ -45,12 +45,12 @@ TRAD_SYNOPSIS DESCRIPTION -<> is a function which converts lower-case wide-characters to upper -case, leaving all other characters unchanged. +<> is a function which converts lowercase wide characters to +uppercase, leaving all other characters unchanged. RETURNS -<> returns the upper-case equivalent of <[c]> when it is a -lower-case wide-character, otherwise, it returns the input character. +<> returns the uppercase equivalent of <[c]> when it is a +lowercase wide character, otherwise, it returns the input character. PORTABILITY <> is C99. diff --git a/newlib/libc/string/strcasecmp.c b/newlib/libc/string/strcasecmp.c index 4dcfc784a9..f96f7f5c97 100644 --- a/newlib/libc/string/strcasecmp.c +++ b/newlib/libc/string/strcasecmp.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---case insensitive character string compare + <>---case-insensitive character string compare INDEX strcasecmp @@ -22,7 +22,7 @@ DESCRIPTION RETURNS If <<*<[a]>>> sorts lexicographically after <<*<[b]>>> (after - both are converted to upper case), <> returns a + both are converted to uppercase), <> returns a number greater than zero. If the two strings match, <> returns zero. If <<*<[a]>>> sorts lexicographically before <<*<[b]>>>, <> returns a diff --git a/newlib/libc/string/strcoll.c b/newlib/libc/string/strcoll.c index 8760b2217b..65dc38037d 100644 --- a/newlib/libc/string/strcoll.c +++ b/newlib/libc/string/strcoll.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---locale specific character string compare + <>---locale-specific character string compare INDEX strcoll diff --git a/newlib/libc/string/strings.tex b/newlib/libc/string/strings.tex index 4e1a2cd16e..3ca732f796 100644 --- a/newlib/libc/string/strings.tex +++ b/newlib/libc/string/strings.tex @@ -22,13 +22,13 @@ managing areas of memory. The corresponding declarations are in * strcat:: Concatenate strings * strchr:: Search for character in string * strcmp:: Character string compare -* strcoll:: Locale specific character string compare +* strcoll:: Locale-specific character string compare * strcpy:: Copy string * strcspn:: Count chars not in string * strerror:: Convert error number to string * strerror_r:: Convert error number to string * strlen:: Character string length -* strlwr:: Convert string to lower case +* strlwr:: Convert string to lowercase * strncasecmp:: Compare strings ignoring case * strncat:: Concatenate strings * strncmp:: Character string compare diff --git a/newlib/libc/string/strlwr.c b/newlib/libc/string/strlwr.c index cf0d45f715..47096d4301 100644 --- a/newlib/libc/string/strlwr.c +++ b/newlib/libc/string/strlwr.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---force string to lower case + <>---force string to lowercase INDEX strlwr @@ -15,8 +15,8 @@ TRAD_SYNOPSIS char *<[a]>; DESCRIPTION - <> converts each characters in the string at <[a]> to - lower case. + <> converts each character in the string at <[a]> to + lowercase. RETURNS <> returns its argument, <[a]>. diff --git a/newlib/libc/string/strncasecmp.c b/newlib/libc/string/strncasecmp.c index 28c6cc44f1..c877ba53cd 100644 --- a/newlib/libc/string/strncasecmp.c +++ b/newlib/libc/string/strncasecmp.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---case insensitive character string compare + <>---case-insensitive character string compare INDEX strncasecmp @@ -24,7 +24,7 @@ DESCRIPTION RETURNS If <<*<[a]>>> sorts lexicographically after <<*<[b]>>> (after - both are converted to upper case), <> returns a + both are converted to uppercase), <> returns a number greater than zero. If the two strings are equivalent, <> returns zero. If <<*<[a]>>> sorts lexicographically before <<*<[b]>>>, <> returns a diff --git a/newlib/libc/string/strupr.c b/newlib/libc/string/strupr.c index d7f7c129d5..3f346b8407 100644 --- a/newlib/libc/string/strupr.c +++ b/newlib/libc/string/strupr.c @@ -15,8 +15,8 @@ TRAD_SYNOPSIS char *<[a]>; DESCRIPTION - <> converts each characters in the string at <[a]> to - upper case. + <> converts each character in the string at <[a]> to + uppercase. RETURNS <> returns its argument, <[a]>. diff --git a/newlib/libc/string/wcscoll.c b/newlib/libc/string/wcscoll.c index 9287af38cd..0f0513a58a 100644 --- a/newlib/libc/string/wcscoll.c +++ b/newlib/libc/string/wcscoll.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---locale specific wide-character string compare + <>---locale-specific wide-character string compare INDEX wcscoll diff --git a/newlib/libc/string/wcslcat.c b/newlib/libc/string/wcslcat.c index adf683ad56..75c085b5b8 100644 --- a/newlib/libc/string/wcslcat.c +++ b/newlib/libc/string/wcslcat.c @@ -14,12 +14,12 @@ TRAD_SYNOPSIS size_t <[siz]>; DESCRIPTION - The <> function appends wide-characters from <[src]> to + The <> function appends wide characters from <[src]> to end of the <[dst]> wide-character string so that the resultant - wide-character string is not more than <[siz]> wide-characters - including terminating null wide-character code. A terminating - null wide-character is always added unless <[siz]> is 0. Thus, - the maximum number of wide-characters that can be appended from + wide-character string is not more than <[siz]> wide characters + including the terminating null wide-character code. A terminating + null wide character is always added unless <[siz]> is 0. Thus, + the maximum number of wide characters that can be appended from <[src]> is <[siz]> - 1. If copying takes place between objects that overlap, the behaviour is undefined. @@ -28,7 +28,7 @@ RETURNS wide-character string length of <[src]> (does not include terminating null wide-characters). If the return value is greater than or equal to <[siz]>, then truncation occurred and - not all wide-characters from <[src]> were appended. + not all wide characters from <[src]> were appended. PORTABILITY No supporting OS subroutines are required. diff --git a/newlib/libc/string/wcslcpy.c b/newlib/libc/string/wcslcpy.c index ac7d01863f..21c030b386 100644 --- a/newlib/libc/string/wcslcpy.c +++ b/newlib/libc/string/wcslcpy.c @@ -14,16 +14,16 @@ TRAD_SYNOPSIS size_t <[siz]>; DESCRIPTION - <> copies wide-characters from <[src]> to <[dst]> + <> copies wide characters from <[src]> to <[dst]> such that up to <[siz]> - 1 characters are copied. A terminating null is appended to the result, unless <[siz]> is zero. RETURNS - <> returns the number of wide-characters in <[src]>, - not including the terminating null wide-character. If the + <> returns the number of wide characters in <[src]>, + not including the terminating null wide character. If the return value is greater than or equal to <[siz]>, then - not all wide-characters were copied from <[src]> and truncation + not all wide characters were copied from <[src]> and truncation occurred. PORTABILITY diff --git a/newlib/libc/string/wcsnlen.c b/newlib/libc/string/wcsnlen.c index 3804bdf904..9d680d603f 100644 --- a/newlib/libc/string/wcsnlen.c +++ b/newlib/libc/string/wcsnlen.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---get fixed-size wide character string length + <>---get fixed-size wide-character string length INDEX wcsnlen @@ -16,8 +16,8 @@ TRAD_SYNOPSIS size_t <[maxlen]>; DESCRIPTION - The <> function computes the number of wide character codes - in the wide character string pointed to by <[s]> not including the + The <> function computes the number of wide-character codes + in the wide-character string pointed to by <[s]> not including the terminating L'\0' wide character but at most <[maxlen]> wide characters. diff --git a/newlib/libc/string/wcsstr.c b/newlib/libc/string/wcsstr.c index 30fc4631f2..0b00396ead 100644 --- a/newlib/libc/string/wcsstr.c +++ b/newlib/libc/string/wcsstr.c @@ -14,7 +14,7 @@ TRAD_SYNOPSIS DESCRIPTION The <> function locates the first occurrence in the wide-character string pointed to by <[big]> of the sequence of - wide-characters (excluding the terminating null wide-character) in the + wide characters (excluding the terminating null wide character) in the wide-character string pointed to by <[little]>. RETURNS diff --git a/newlib/libc/string/wcstrings.tex b/newlib/libc/string/wcstrings.tex index ad0a607885..df6edc47c8 100644 --- a/newlib/libc/string/wcstrings.tex +++ b/newlib/libc/string/wcstrings.tex @@ -2,21 +2,21 @@ @chapter Wide Character Strings (@file{wchar.h}) This chapter describes wide-character string-handling functions and -managing areas of memory containing wide-characters. The corresponding +managing areas of memory containing wide characters. The corresponding declarations are in @file{wchar.h}. @menu -* wmemchr:: Find wide-character in memory +* wmemchr:: Find wide character in memory * wmemcmp:: Compare two wide-character memory areas * wmemcpy:: Copy wide-character memory regions * wmemmove:: Move possibly overlapping wide-character memory -* wmemset:: Set an area of memory to a specified wide-character +* wmemset:: Set an area of memory to a specified wide character * wcscat:: Concatenate wide-character strings -* wcschr:: Search for wide-character in string +* wcschr:: Search for wide character in string * wcscmp:: Wide-character string compare -* wcscoll:: Locale specific Wide-character string compare +* wcscoll:: Locale-specific wide-character string compare * wcscpy:: Copy wide-character string -* wcscspn:: Count wide-chars not in string +* wcscspn:: Count wide characters not in string * wcslcat:: Concatenate wide-character strings to specified length * wcslcpy:: Copy wide-character string to specified length * wcslen:: Wide-character string length @@ -24,8 +24,8 @@ declarations are in @file{wchar.h}. * wcsncmp:: Wide-character string compare * wcsncpy:: Counted copy wide-character string * wcsnlen:: Wide-character string length with maximum limit -* wcspbrk:: Find wide-chars in string -* wcsrchr:: Reverse search for wide-character in string +* wcspbrk:: Find wide characters in string +* wcsrchr:: Reverse search for wide character in string * wcsspn:: Find initial match in wide-character string * wcsstr:: Find wide-character string segment * wcswidth:: Number of column positions of a wide-character string diff --git a/newlib/libc/string/wmemchr.c b/newlib/libc/string/wmemchr.c index ca1427be04..b582b89485 100644 --- a/newlib/libc/string/wmemchr.c +++ b/newlib/libc/string/wmemchr.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---find a wide-character in memory + <>---find a wide character in memory ANSI_SYNOPSIS @@ -15,9 +15,9 @@ TRAD_SYNOPSIS DESCRIPTION The <> function locates the first occurrence of <[c]> in the - initial <[n]> wide-characters of the object pointed to be <[s]>. This + initial <[n]> wide characters of the object pointed to be <[s]>. This function is not affected by locale and all wchar_t values are treated - identically. The null wide-character and wchar_t values not + identically. The null wide character and wchar_t values not corresponding to valid characters are not treated specially. If <[n]> is zero, <[s]> must be a valid pointer and the function @@ -25,7 +25,7 @@ DESCRIPTION RETURNS The <> function returns a pointer to the located - wide-character, or a null pointer if the wide-character does not occur + wide character, or a null pointer if the wide character does not occur in the object. PORTABILITY diff --git a/newlib/libc/string/wmemcmp.c b/newlib/libc/string/wmemcmp.c index 96c2b765c0..af9ee32074 100644 --- a/newlib/libc/string/wmemcmp.c +++ b/newlib/libc/string/wmemcmp.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---compare wide-characters in memory + <>---compare wide characters in memory ANSI_SYNOPSIS #include @@ -13,10 +13,10 @@ TRAD_SYNOPSIS size_t <[n]>; DESCRIPTION - The <> function compares the first <[n]> wide-characters of the - object pointed to by <[s1]> to the first <[n]> wide-characters of the + The <> function compares the first <[n]> wide characters of the + object pointed to by <[s1]> to the first <[n]> wide characters of the object pointed to by <[s2]>. This function is not affected by locale - and all wchar_t values are treated identically. The null wide-character + and all wchar_t values are treated identically. The null wide character and wchar_t values not corresponding to valid characters are not treated specially. diff --git a/newlib/libc/string/wmemcpy.c b/newlib/libc/string/wmemcpy.c index 24de8856b8..748e8e1967 100644 --- a/newlib/libc/string/wmemcpy.c +++ b/newlib/libc/string/wmemcpy.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---copy wide-characters in memory + <>---copy wide characters in memory ANSI_SYNOPSIS #include @@ -13,14 +13,14 @@ TRAD_SYNOPSIS size_t <[n]>; DESCRIPTION - The <> function copies <[n]> wide-characters from the object + The <> function copies <[n]> wide characters from the object pointed to by <[s]> to the object pointed to be <[d]>. This function is not affected by locale and all wchar_t values are treated - identically. The null wide-character and wchar_t values not + identically. The null wide character and wchar_t values not corresponding to valid characters are not treated specially. If <[n]> is zero, <[d]> and <[s]> must be a valid pointers, and the - function copies zero wide-characters. + function copies zero wide characters. RETURNS The <> function returns the value of <[d]>. diff --git a/newlib/libc/string/wmemmove.c b/newlib/libc/string/wmemmove.c index 6986fde22d..e20a26ae9b 100644 --- a/newlib/libc/string/wmemmove.c +++ b/newlib/libc/string/wmemmove.c @@ -13,20 +13,20 @@ TRAD_SYNOPSIS size_t <[n]>; DESCRIPTION - The <> function copies <[n]> wide-characters from the object + The <> function copies <[n]> wide characters from the object pointed to by <[s]> to the object pointed to by <[d]>. Copying takes - place as if the <[n]> wide-characters from the object pointed to by - <[s]> are first copied into a temporary array of <[n]> wide-characters + place as if the <[n]> wide characters from the object pointed to by + <[s]> are first copied into a temporary array of <[n]> wide characters that does not overlap the objects pointed to by <[d]> or <[s]>, and then - the <[n]> wide-characters from the temporary array are copied into the + the <[n]> wide characters from the temporary array are copied into the object pointed to by <[d]>. This function is not affected by locale and all wchar_t values are - treated identically. The null wide-character and wchar_t values not + treated identically. The null wide character and wchar_t values not corresponding to valid characters are not treated specially. If <[n]> is zero, <[d]> and <[s]> must be a valid pointers, and the - function copies zero wide-characters. + function copies zero wide characters. RETURNS The <> function returns the value of <[d]>. diff --git a/newlib/libc/string/wmemset.c b/newlib/libc/string/wmemset.c index b426f56824..0af6f91d50 100644 --- a/newlib/libc/string/wmemset.c +++ b/newlib/libc/string/wmemset.c @@ -1,6 +1,6 @@ /* FUNCTION - <>---set wide-characters in memory + <>---set wide characters in memory ANSI_SYNOPSIS #include @@ -14,16 +14,16 @@ TRAD_SYNOPSIS DESCRIPTION The <> function copies the value of <[c]> into each of the - first <[n]> wide-characters of the object pointed to by <[s]>. This + first <[n]> wide characters of the object pointed to by <[s]>. This function is not affected by locale and all wchar_t values are treated - identically. The null wide-character and wchar_t values not + identically. The null wide character and wchar_t values not corresponding to valid characters are not treated specially. If <[n]> is zero, <[s]> must be a valid pointer and the function - copies zero wide-characters. + copies zero wide characters. RETURNS - The <> functions returns the value of <[s]>. + The <> function returns the value of <[s]>. PORTABILITY <> is ISO/IEC 9899/AMD1:1995 (ISO C). -- 2.11.0