Summary: | strlen.3 HISTORY section is truncated | ||
---|---|---|---|
Product: | Documentation | Reporter: | John F. Carr <jfc> |
Component: | Manual Pages | Assignee: | David E. O'Brien <obrien> |
Status: | In Progress --- | ||
Severity: | Affects Only Me | CC: | Christopher.davidson, concussious.bugzilla, doc, obrien, wosch |
Priority: | --- | ||
Version: | Latest | ||
Hardware: | Any | ||
OS: | Any | ||
URL: | https://cgit.freebsd.org/src/commit/?id=c4ff9276a969a3a691ee1f336ce4ed6c0c9b0b99 |
Description
John F. Carr
2023-09-09 22:39:50 UTC
man.openbsd.org/strlen.3 says strlen was in version 6 AT&T unix, but I didn't see it on man.cat-v.org for v6 or v7. Netbsd and Linux manual pages were not informative on the matter. strnlen was added to FreeBSD in 69099ba2ec8b01fe51a5c69b98990cde406c5ab8 in 2009. The online version of 4.3 Reno at https://github.com/dank101/4.3BSD-Reno does not have strnlen. It does have strncpy, strncmp, and strncat. From https://pubs.opengroup.org/onlinepubs/9699919799/functions/strlen.html: "The strnlen() function is added from The Open Group Technical Standard, 2006, Extended API Set Part 1." From OpenBSD: "The strnlen() function appeared in glibc 2.0 and was reimplemented for OpenBSD 4.8." I am not familiar with this topic. The other pages say .At v7 and use a semicolon. How do you feel about this? .Sh HISTORY The .Fn strlen function first appeared in the Programmer's Workbench (PWB/UNIX) and was ported to .At v7 ; the .Fn strnlen function first appeared in .At v7 and was reimplemented for .Fx 8 . I looked into this more, specifically the commit id mentioned in the original submission: git show 4b7f35db44cbf901e994fc9a4bcd4c98ebe8c4a1 This looks to also appear in -CURRENT, looking through previous versions of the manual page, before the commit id above this is what I was able to find. https://man.freebsd.org/cgi/man.cgi?query=strnlen&apropos=0&sektion=0&manpath=FreeBSD+13.1-RELEASE&arch=default&format=html This release does not go into the details of where it came from, the history section is not available. My question would be: Is there anything mandating the HISTORY section? My recommendation would be to remove the HISTORY stuff, until more information could be found. The fix c4ff9276a969a3a691ee1f336ce4ed6c0c9b0b99 needs to be merged to stable/13 and stable/14 as well. (In reply to Wolfram Schneider from comment #5) @obrien: can we merge the fix to stable/13 and stable/14? Thanks! |