Re: [PATCH v1 0/1] Document strnul(3)

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 2185 bytes --]

On 2026-02-21T16:04:24+0100, Alejandro Colomar wrote:
> On 2026-02-21T16:02:49+0100, Alejandro Colomar wrote:
> > Hi!
> > 
> > gnulib has added strnul(3).  I hope libc implementation eventually pick
> > up this API.  Let's document it in a manual page.
> 
> Here's how the page looks like:
> 
> $ MANWIDTH=72 diffman-git HEAD
> fatal: path 'man/man3/strnul.3' exists on disk, but not in 'HEAD^'
> --- HEAD^:man/man3/strnul.3
> +++ HEAD:man/man3/strnul.3
> @@ -0,0 +1,39 @@
> +strnul(3)               Library Functions Manual              strnul(3)
> +
> +NAME
> +     strnul - string null‐terminator
> +
> +LIBRARY
> +     gnulib - The GNU Portability Library
> +
> +SYNOPSIS
> +     #include <string.h>
> +
> +     char *streq(const char *s);

Oops; s/streq/strnul/.  Fixed.

> +
> +DESCRIPTION
> +     strnul() returns a pointer to the terminating null byte in the
> +     string s.
> +
> +RETURN VALUE
> +     s+strlen(s).
> +
> +ATTRIBUTES
> +     For an explanation of the terms used in this section, see attrib‐
> +     utes(7).
> +     ┌──────────────────────────────────────┬───────────────┬─────────┐
> +     │ Interface                            │ Attribute     │ Value   │
> +     ├──────────────────────────────────────┼───────────────┼─────────┤
> +     │ strnul()                             │ Thread safety │ MT‐Safe │
> +     └──────────────────────────────────────┴───────────────┴─────────┘
> +
> +STANDARDS
> +     GNU.
> +
> +HISTORY
> +     gnulib 202607.
> +
> +SEE ALSO
> +     strlen(3), strchr(3), string(3)
> +
> +Linux man‐pages (unreleased)     (date)                       strnul(3)
> 
> -- 
> <https://www.alejandro-colomar.es>



-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]