Bug 266336

Summary:

Angle brackets < and > misrepresented as underscore characters in online manual pages

Product:

Documentation

Reporter:

Graham Perrin <grahamperrin>

Component:

Manual Pages

Assignee:

Wolfram Schneider <wosch>

Status:

Closed FIXED

Severity:

Affects Many People

CC:

doc, grahamperrin, wosch

Priority:

---

Version:

Latest

Hardware:

Any

OS:

Any

See Also:

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

Bug Depends on:

Bug Blocks:

271134

Attachments:

Description	Flags
Screenshot: the COPYRIGHT section of ntpd(8)	none

Description Graham Perrin freebsd_committer

2022-09-10 11:53:43 UTC

First observed at <https://www.freebsd.org/cgi/man.cgi?query=xorg.conf&sektion=5&manpath=FreeBSD-Ports#DRI_SECTION> and <https://www.freebsd.org/cgi/man.cgi?query=xorg.conf&sektion=5&manpath=FreeBSD-Ports#AUTHORS>. 

Then at <https://www.freebsd.org/cgi/man.cgi?query=Xorg&sektion=1&manpath=FreeBSD-Ports#SEE_ALSO>, <https://www.freebsd.org/cgi/man.cgi?query=Xorg&sektion=1&manpath=FreeBSD-Ports#AUTHORS>, ...


Reference
=========

RFC 3986 on use of angle brackets: <https://datatracker.ietf.org/doc/html/rfc3986#appendix-C>

Comment 1 Graham Perrin 2023-08-05 10:22:29 UTC

Created attachment 243859 [details]
Screenshot: the COPYRIGHT section of ntpd(8)

The three examples in comment 0 were from the ports tree. 

From the src tree, under <https://man.freebsd.org/cgi/man.cgi?query=ntpd&sektion=8&manpath=freebsd-release#COPYRIGHT>: 

- neither < nor > is misrepresented as an underscore.

(There's a separate bug, in that > is not recognised as a delimiter.)

Comment 2 Graham Perrin freebsd_committer

2024-02-24 12:52:42 UTC

<https://man.freebsd.org/cgi/man.cgi?query=hier&sektion=7&manpath=freebsd-release> for /usr/local/ includes the following line: 

> 				 share/doc/_port_/),	 and	/usr/local/etc

<https://github.com/freebsd/freebsd-src/blob/61b88a230bac766f55984d8d33b98845d2b0d1a9/share/man/man7/hier.7#L277>: 

> .Pa share/doc/<port>/ Ns Pc ,

Comment 3 commit-hook freebsd_committer

2024-04-28 18:22:36 UTC

A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=e4d3f14695b1e2a23143ca940e3b73df224dcb43

commit e4d3f14695b1e2a23143ca940e3b73df224dcb43
Author:     Wolfram Schneider <wosch@FreeBSD.org>
AuthorDate: 2024-04-28 18:19:51 +0000
Commit:     Wolfram Schneider <wosch@FreeBSD.org>
CommitDate: 2024-04-28 18:19:51 +0000

    improve URL matching

    for trailing '>', comma and other characters

    PR: 266336

 website/content/en/cgi/man.cgi | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)