Bug 266403

Summary: man.cgi rendering issue [was: getaddrinfo(3) typo]
Product: Documentation Reporter: Michael Ortmann <ortmann>
Component: WebsiteAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Many People CC: doc, emaste, grahamperrin, maxim, minsoochoo0122
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
Screenshot none

Description Michael Ortmann 2022-09-13 22:13:16 UTC 
freeadrinfo(NULL) should be freeaddrinfo(NULL)

Also looks like there is/are word(s) missing after:

"The behavior of freeadrinfo(NULL) is left unspecified by both  "

The 2 whitespaces there look odd.

This bug is since FreeBSD-11.2-RELEASE.
Comment 1 commit-hook freebsd_committer freebsd_triage 2022-09-14 05:14:41 UTC 
A commit in branch main references this bug:

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

commit acc3f0689af8718d03fa12bbdd512742da02dbbc
Author:     Maxim Konovalov <maxim@FreeBSD.org>
AuthorDate: 2022-09-14 05:08:45 +0000
Commit:     Maxim Konovalov <maxim@FreeBSD.org>
CommitDate: 2022-09-14 05:08:45 +0000

    getaddrinfo(3): A typo fixed

    PR:     266403

 lib/libc/net/getaddrinfo.3 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
Comment 2 Maxim Konovalov freebsd_committer freebsd_triage 2022-09-14 05:22:41 UTC 
Hi,

Thanks for the report.  I've just fixed the freeadrinfo typo.

However, I don't see any issues with the second part of your report. Specifically, I see a complete sentence in my copy of the getaddrinfo.3 man page:

The behavior of freeaddrinfo(NULL) is left unspecified by both Version 4
of the Single UNIX Specification ("SUSv4") and RFC 3493.

%%%

Maxim
Comment 3 Michael Ortmann 2022-09-14 09:27:51 UTC 
Hi Maxim,

somehow the sentence you posted doesn't make it to the rendered html/pdf/ascii version at freebsds webpage:

https://www.freebsd.org/cgi/man.cgi?query=getaddrinfo&apropos=0&sektion=3&manpath=FreeBSD+13.1-RELEASE+and+Ports&arch=default&format=html

where it reads like:

The behavior of freeadrinfo(NULL) is left unspecified by both  and	RFC
     3493.

Kind regards,
Michael
Comment 4 Maxim Konovalov freebsd_committer freebsd_triage 2022-09-14 14:47:38 UTC 
Hi Michael,

Yes, I see, thanks.

It looks like the mandoc -> html convertor has an issue with parsing specific mandoc tags.

Let's keep this ticket open until someone with more knowledge in this area help us with a possible fix.

I also moved this ticket into the "website" category.

Cheers,

Maxim
Comment 5 Graham Perrin freebsd_committer freebsd_triage 2022-09-20 17:40:14 UTC 
Created attachment 236708 [details]
Screenshot

(In reply to Michael Ortmann from comment #0)

> "The behavior of freeadrinfo(NULL) is left unspecified by both  "
> 
> The 2 whitespaces there look odd.

(In reply to Maxim Konovalov from comment #4)

Screenshot attached. 

<https://www.freebsd.org/cgi/man.cgi?query=getaddrinfo&sektion=3&manpath=FreeBSD#IMPLEMENTATION_NOTES>
Comment 7 Maxim Konovalov freebsd_committer freebsd_triage 2024-04-21 01:59:38 UTC 
Indeed.  Closing this one for now.  Thanks.