Bug 271479

Summary:	An underscore character _ within a URL seems to be misinterpreted as a delimiter, causing link breakage
Product:	Documentation	Reporter:	Graham Perrin <grahamperrin>
Component:	Manual Pages	Assignee:	Wolfram Schneider <wosch>
Status:	Closed Unable to Reproduce
Severity:	Affects Some People	CC:	doc, jlduran, pat, wosch
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://man.freebsd.org/cgi/man.cgi?query=mdoc&sektion=7&manpath=freebsd-release#MACRO_REFERENCE
See Also:	https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=114487 https://github.com/churchers/vm-bhyve/pull/513#issuecomment-1552478053 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=275480

Description Graham Perrin freebsd_committer

2023-05-18 06:10:05 UTC

Under <https://man.freebsd.org/cgi/man.cgi?query=vm&sektion=8&manpath=freebsd-ports#GUEST_CONFIGURATION_FORMAT>: 

> 			Please see https://wiki.freebsd.org/bhyve/pci_passthru
> 			for more details on how	this works.

The link is misinterpreted as non-existent: 

    <https://wiki.freebsd.org/bhyve/pci>

Comment 1 Graham Perrin freebsd_committer

2023-05-18 06:32:44 UTC

<https://github.com/churchers/vm-bhyve/blob/635e5abad5d77f609aaed78dfca97e0e725af14d/vm.8#L1414>


Similarly broken, the link within this line: 

>      rently be obtained from https://people.freebsd.org/~grehan/bhyve_uefi/

<https://github.com/churchers/vm-bhyve/blob/635e5abad5d77f609aaed78dfca97e0e725af14d/vm.8#L381>

Comment 2 Jose Luis Duran 2023-12-28 07:48:34 UTC

I want to extend the title of this bug report to also include cross-references. Any manual that is cross-referenced, and contains an underscore is also broken.

Comment 3 Graham Perrin 2024-03-10 16:06:10 UTC

(In reply to Graham Perrin from comment #0)

No longer reproducible. 

(In reply to Jose Luis Duran from comment #2)

wosch@ would you like a separate bug for this? 

Five links currently broken under <https://man.freebsd.org/cgi/man.cgi?query=loader&sektion=8&manpath=freebsd-release#BUILTIN%09COMMANDS>, for example.

Comment 4 Graham Perrin 2024-03-10 16:07:48 UTC

(In reply to Jose Luis Duran from comment #2)

Ah, that is probably bug 275000.

Comment 5 Jose Luis Duran 2024-03-10 16:09:15 UTC

(In reply to Graham Perrin from comment #4)

I'll start tracking that one. Thank you!