Bug 260519 - man.cgi representations of URLs within manual pages should not break any URL
Summary: man.cgi representations of URLs within manual pages should not break any URL
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-doc (Nobody)
URL: https://www.freebsd.org/cgi/man.cgi
Keywords:
: 268600 (view as bug list)
Depends on:
Blocks:
 
Reported: 2021-12-18 16:02 UTC by Graham Perrin
Modified: 2023-10-12 05:46 UTC (History)
4 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 2021-12-18 16:02:09 UTC 
<https://github.com/freebsd/pkg/blob/72f34beab88da0876885ff503ee799f1688828ed/docs/pkg.conf.5#L39>, for example: 

> please visit the official UCL website - http://github.com/vstakhov/libucl.


<https://www.freebsd.org/cgi/man.cgi?query=pkg.conf&sektion=5&manpath=Ports#DESCRIPTION> misrepresents the phrase: 

>      please visit the official UCL website - http://github.com/vs-
>      takhov/libucl.

– with reference to non-existent <http://github.com/vs->
Comment 1 Fernando Apesteguía freebsd_committer freebsd_triage 2022-05-18 11:10:57 UTC 
This only happens with html and ascii renderers. PDF is fine. bc(1) is another example where this occurs. man.cgi is black magic to me. Perl is not my cup of tea. wosch@ in CC to see if he can have a look at it.
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2022-12-27 19:32:51 UTC 
*** Bug 268600 has been marked as a duplicate of this bug. ***
Comment 3 Graham Perrin freebsd_committer freebsd_triage 2022-12-27 19:35:21 UTC 
(Apologies for the duplication.)
Comment 4 Wolfram Schneider freebsd_committer freebsd_triage 2023-10-12 05:46:28 UTC 
To render an URL with mdoc, you have to use the .Lk macro

https://man.freebsd.org/cgi/man.cgi?mdoc

       Lk uri [display_name]
	    Format a hyperlink.

	    Examples:
		  .Lk https://bsd.lv "The BSD.lv Project"
		  .Lk https://bsd.lv