Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 28 Jun 2021 23:18:11 +0000
From:      bugzilla-noreply@freebsd.org
To:        doc@FreeBSD.org
Subject:   [Bug 256421] XOpenDisplay: <X11/Xlib.h> is not displayed in the web version of the manpage
Message-ID:  <bug-256421-9-GbKVxgSxzs@https.bugs.freebsd.org/bugzilla/>
In-Reply-To: <bug-256421-9@https.bugs.freebsd.org/bugzilla/>
References:  <bug-256421-9@https.bugs.freebsd.org/bugzilla/>

next in thread | previous in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D256421

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 ei=
ther
(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/14fb4e535626ba934ca=
d5bc4308f511524cd1103

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 supp=
ort
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 a=
nd
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.

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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-256421-9-GbKVxgSxzs>