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.

1 files changed, 6 insertions, 26 deletions

diff --git a/newlib/libc/signal/signal.c b/newlib/libc/signal/signal.c
index 20e919e74..bfb85e66a 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 <signal.h>
-	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 <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,