lib/57832: getnameinfo(3) man page fails to document NI_NUMERICSCOPE

[campbell+netbsd%mumble.net@localhost]

>Number:         57832
>Category:       lib
>Synopsis:       getnameinfo(3) man page fails to document NI_NUMERICSCOPE
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    lib-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Jan 09 22:45:00 +0000 2024
>Originator:     Taylor R Campbell
>Release:        current, 10, 9, 8
>Organization:
The NetBSDv6 Foundation
>Environment:
>Description:
POSIX defines a flag NI_NUMERICSCOPE for getnameinfo(3):

   If the flag bit NI_NUMERICSCOPE is set, the numeric form of the scope identifier shall be returned (for example, interface index) instead of its name.  This flag shall be ignored if the sa argument is not an IPv6 address.

   https://pubs.opengroup.org/onlinepubs/9699919799/functions/getnameinfo.html

This is defined in our netdb.h, and a cursory examination of getnameinfo.c turns up code to respect it so it is presumably implemented.

However, it doesn't appear in our getnameinfo(3) man page.
>How-To-Repeat:
man getnameinfo
https://man.NetBSD.org/getnameinfo.3
>Fix:
Yes, please!