From: Alejandro Colomar <alx@kernel.org>
To: linux-man@vger.kernel.org
Cc: Alejandro Colomar <alx@kernel.org>,
bug-gnulib@gnu.org,
"G. Branden Robinson" <g.branden.robinson@gmail.com>,
Simon Josefsson <simon@josefsson.org>,
Joseph Myers <josmyers@redhat.com>
Subject: [PATCH v2 0/1] Document strnul(3)
Date: Sat, 21 Feb 2026 21:53:51 +0100 [thread overview]
Message-ID: <cover.1771707141.git.alx@kernel.org> (raw)
In-Reply-To: <cover.1771686088.git.alx@kernel.org>
Hi,
gnulib has added strnul(3). I hope libc implementations eventually pick
up this API. Let's document it in a manual page.
This v2 changes a typo, and the wording of DESCRIPTION and RETURN VALUE.
Have a lovely night!
Alex
Alejandro Colomar (1):
man/man3/strnul.3: New page
man/man3/strnul.3 | 48 +++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 48 insertions(+)
create mode 100644 man/man3/strnul.3
Range-diff against v1:
1: 7b2c4b363f65 ! 1: 2b86d10abfc3 man/man3/strnul.3: New page
@@ man/man3/strnul.3 (new)
+.nf
+.B #include <string.h>
+.P
-+.BI char\~*streq(const\~char\~* s );
++.BI char\~*strnul(const\~char\~* s );
+.fi
+.SH DESCRIPTION
+.BR strnul ()
-+returns a pointer to the terminating null byte in the string
++calculates the position of the terminating null byte (\[aq]\[rs]0\[aq])
++in the string pointed to by
+.IR s .
+.SH RETURN VALUE
-+.IR s+strlen(s) .
++.BR strnul ()
++returns a pointer to the terminating null byte
++in the string pointed to by
++.IR s .
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
--
2.51.0
next prev parent reply other threads:[~2026-02-21 20:53 UTC|newest]
Thread overview: 18+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-02-21 15:02 [PATCH v1 0/1] Document strnul(3) Alejandro Colomar
2026-02-21 15:02 ` [PATCH v1 1/1] man/man3/strnul.3: New page Alejandro Colomar
2026-02-21 17:41 ` G. Branden Robinson
2026-02-21 19:56 ` Alejandro Colomar
2026-02-21 20:02 ` Simon Josefsson
2026-02-21 20:45 ` Alejandro Colomar
2026-02-21 20:05 ` G. Branden Robinson
2026-02-21 20:55 ` Alejandro Colomar
2026-02-22 1:48 ` Paul Eggert
2026-02-22 11:21 ` Alejandro Colomar
2026-02-22 13:46 ` Alejandro Colomar
2026-02-22 14:10 ` Bruno Haible
2026-02-22 14:19 ` Alejandro Colomar
2026-02-22 14:21 ` Alejandro Colomar
2026-02-21 15:04 ` [PATCH v1 0/1] Document strnul(3) Alejandro Colomar
2026-02-21 15:09 ` Alejandro Colomar
2026-02-21 20:53 ` Alejandro Colomar [this message]
2026-02-21 20:53 ` [PATCH v2 1/1] man/man3/strnul.3: New page Alejandro Colomar
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=cover.1771707141.git.alx@kernel.org \
--to=alx@kernel.org \
--cc=bug-gnulib@gnu.org \
--cc=g.branden.robinson@gmail.com \
--cc=josmyers@redhat.com \
--cc=linux-man@vger.kernel.org \
--cc=simon@josefsson.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.