Changeset 609 for branches/GNU/src/binutils/libiberty/strsignal.c

Timestamp:

Aug 16, 2003, 6:59:22 PM (22 years ago)

Author:

bird

Message:

binutils v2.14 - offical sources.

File:

• branches/GNU/src/binutils/libiberty/strsignal.c (modified) (8 diffs, 1 prop)

branches/GNU/src/binutils/libiberty/strsignal.c

@@ -18 +18 @@
    declare it ourselves.  With luck, this will always work.  */
 #define sys_siglist no_such_symbol
+#define sys_nsig sys_nsig__no_such_symbol
 
 #include <stdio.h>
@@ -39 +40 @@
    found in the system header files.  */
 #undef sys_siglist
+#undef sys_nsig
 
 #ifndef NULL
-#  ifdef __STDC__
+#  ifdef ANSI_PROTOTYPES
 #    define NULL (void *) 0
 #  else
@@ -66 +68 @@
 struct signal_info
 {
-  int value;            /* The numeric value from <signal.h> */
-  const char *name;     /* The equivalent symbolic value */
+  const int value;              /* The numeric value from <signal.h> */
+  const char *const name;       /* The equivalent symbolic value */
 #ifndef HAVE_SYS_SIGLIST
-  const char *msg;      /* Short message about this value */
+  const char *const msg;        /* Short message about this value */
 #endif
 };
@@ -349 +351 @@
 /*
 
-NAME
-
-        signo_max -- return the max signo value
-
-SYNOPSIS
-
-        int signo_max ();
-
-DESCRIPTION
-
-        Returns the maximum signo value for which a corresponding symbolic
-        name or message is available.  Note that in the case where
-        we use the sys_siglist supplied by the system, it is possible for
-        there to be more symbolic names than messages, or vice versa.
-        In fact, the manual page for psignal(3b) explicitly warns that one
-        should check the size of the table (NSIG) before indexing it,
-        since new signal codes may be added to the system before they are
-        added to the table.  Thus NSIG might be smaller than value
-        implied by the largest signo value defined in <signal.h>.
-
-        We return the maximum value that can be used to obtain a meaningful
-        symbolic name or message.
+@deftypefn Extension int signo_max (void)
+
+Returns the maximum signal value for which a corresponding symbolic
+name or message is available.  Note that in the case where we use the
+@code{sys_siglist} supplied by the system, it is possible for there to
+be more symbolic names than messages, or vice versa.  In fact, the
+manual page for @code{psignal(3b)} explicitly warns that one should
+check the size of the table (@code{NSIG}) before indexing it, since
+new signal codes may be added to the system before they are added to
+the table.  Thus @code{NSIG} might be smaller than value implied by
+the largest signo value defined in @code{<signal.h>}.
+
+We return the maximum value that can be used to obtain a meaningful
+symbolic name or message.
+
+@end deftypefn
 
 */
@@ -390 +386 @@
 /*
 
-NAME
-
-        strsignal -- map a signal number to a signal message string
-
-SYNOPSIS
-
-        const char *strsignal (int signo)
-
-DESCRIPTION
-
-        Maps an signal number to an signal message string, the contents of
-        which are implementation defined.  On systems which have the external
-        variable sys_siglist, these strings will be the same as the ones used
-        by psignal().
-
-        If the supplied signal number is within the valid range of indices
-        for the sys_siglist, but no message is available for the particular
-        signal number, then returns the string "Signal NUM", where NUM is the
-        signal number.
-
-        If the supplied signal number is not a valid index into sys_siglist,
-        returns NULL.
-
-        The returned string is only guaranteed to be valid only until the
-        next call to strsignal.
+@deftypefn Supplemental {const char *} strsignal (int @var{signo})
+
+Maps an signal number to an signal message string, the contents of
+which are implementation defined.  On systems which have the external
+variable @code{sys_siglist}, these strings will be the same as the
+ones used by @code{psignal()}.
+
+If the supplied signal number is within the valid range of indices for
+the @code{sys_siglist}, but no message is available for the particular
+signal number, then returns the string @samp{Signal @var{num}}, where
+@var{num} is the signal number.
+
+If the supplied signal number is not a valid index into
+@code{sys_siglist}, returns @code{NULL}.
+
+The returned string is only guaranteed to be valid only until the next
+call to @code{strsignal}.
+
+@end deftypefn
 
 */
@@ -460 +450 @@
 /*
 
-NAME
-
-        strsigno -- map an signal number to a symbolic name string
-
-SYNOPSIS
-
-        const char *strsigno (int signo)
-
-DESCRIPTION
-
-        Given an signal number, returns a pointer to a string containing
-        the symbolic name of that signal number, as found in <signal.h>.
-
-        If the supplied signal number is within the valid range of indices
-        for symbolic names, but no name is available for the particular
-        signal number, then returns the string "Signal NUM", where NUM is
-        the signal number.
-
-        If the supplied signal number is not within the range of valid
-        indices, then returns NULL.
-
-BUGS
-
-        The contents of the location pointed to are only guaranteed to be
-        valid until the next call to strsigno.
+@deftypefn Extension {const char*} strsigno (int @var{signo})
+
+Given an signal number, returns a pointer to a string containing the
+symbolic name of that signal number, as found in @code{<signal.h>}.
+
+If the supplied signal number is within the valid range of indices for
+symbolic names, but no name is available for the particular signal
+number, then returns the string @samp{Signal @var{num}}, where
+@var{num} is the signal number.
+
+If the supplied signal number is not within the range of valid
+indices, then returns @code{NULL}.
+
+The contents of the location pointed to are only guaranteed to be
+valid until the next call to @code{strsigno}.
+
+@end deftypefn
 
 */
@@ -523 +505 @@
 /*
 
-NAME
-
-        strtosigno -- map a symbolic signal name to a numeric value
-
-SYNOPSIS
-
-        int strtosigno (char *name)
-
-DESCRIPTION
-
-        Given the symbolic name of a signal, map it to a signal number.
-        If no translation is found, returns 0.
+@deftypefn Extension int strtosigno (const char *@var{name})
+
+Given the symbolic name of a signal, map it to a signal number.  If no
+translation is found, returns 0.
+
+@end deftypefn
 
 */
@@ -569 +545 @@
 /*
 
-NAME
-
-        psignal -- print message about signal to stderr
-
-SYNOPSIS
-
-        void psignal (unsigned signo, char *message);
-
-DESCRIPTION
-
-        Print to the standard error the message, followed by a colon,
-        followed by the description of the signal specified by signo,
-        followed by a newline.
+@deftypefn Supplemental void psignal (unsigned @var{signo}, char *@var{message})
+
+Print @var{message} to the standard error, followed by a colon,
+followed by the description of the signal specified by @var{signo},
+followed by a newline.
+
+@end deftypefn
+
 */