git: b0091036f724 - main - psignal(3): document return values of sig2str() and str2sig

The branch main has been updated by glebius:

URL: https://cgit.FreeBSD.org/src/commit/?id=b0091036f7240ab244e86a087b18459185a260de

commit b0091036f7240ab244e86a087b18459185a260de
Author:     Gleb Smirnoff <glebius@FreeBSD.org>
AuthorDate: 2025-09-25 08:19:46 +0000
Commit:     Gleb Smirnoff <glebius@FreeBSD.org>
CommitDate: 2025-09-25 08:19:46 +0000

    psignal(3): document return values of sig2str() and str2sig
    
    Reviewed by:            bcr
    Differential Revision:  https://reviews.freebsd.org/D52698
---
 lib/libc/gen/psignal.3 | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/lib/libc/gen/psignal.3 b/lib/libc/gen/psignal.3
index 098b7b02a9b9..bf6a99b4b113 100644
--- a/lib/libc/gen/psignal.3
+++ b/lib/libc/gen/psignal.3
@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd May 10, 2025
+.Dd September 23, 2025
 .Dt PSIGNAL 3
 .Os
 .Sh NAME
@@ -141,6 +141,13 @@ The name in
 can be either the name of the signal, with or without the
 .Dq SIG
 prefix, or a decimal number.
+.Sh RETURN VALUES
+The
+.Fn sig2str
+and
+.Fn str2sig
+return 0 on success and -1 on translation failure.
+In the latter case the memory to store the translation result is left intact.
 .Sh SEE ALSO
 .Xr sigaction 2 ,
 .Xr perror 3 ,