[Bug 256421] XOpenDisplay: <X11/Xlib.h> is not displayed in the web version of the manpage

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=256421

John Hein <jcfyecrayz@liamekaens.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |jcfyecrayz@liamekaens.com

--- Comment #12 from John Hein <jcfyecrayz@liamekaens.com> ---
FYI, libX11-1.7.1 renders fine on FreeBSD.  Before that it used a roff macro
not supported by FreeBSD's standard man parsing tools.  Before 1.7.1, it did
not render the include file (per the OP) in the man page in the terminal either
(with standard FreeBSD man page rendering tools).

Specifically, upstream stopped using .hN and replaced it with .BR in 1.7.1 and
later.

See the following upstream commit:

https://gitlab.freedesktop.org/xorg/lib/libx11/-/commit/14fb4e535626ba934cad5bc4308f511524cd1103

It replace .hN with .BR due to the committer's version of groff complaining
about .hN

The FreeBSD web site is still (as the time of this writing) rendering a man
page for XOpenDisplay based on libX11-1.6.12
1.7.0 was committed to the main ports tree 20210511.  1.7.1 was committed
20210520.

So the FreeBSD web page is not wrong.  It just does not use tools that support
the .hN macro ("header name").

I briefly tried to search the web for references about the history of .hN, but
I have not yet found much information about where it came from originally and
what macro package allegedly supports/supported it.

But upstream libX11 "fixed" things such that when the freebsd web page man
pages catch up to the latest ports tree version, it should just starting
working.

-- 
You are receiving this mail because:
You are on the CC list for the bug.
You are the assignee for the bug.