[PATCH] Consistently use L<> tag for manpage references within documentation

Marco Sirabella marco at sirabella.org
Tue Apr 25 08:54:00 CEST 2023


This attached patch relies on <https://github.com/rra/podlators/pull/21>
to be featureful, but is pretty much a no-op without that PR merged so
is not blocking.

Additionally, I haven't included the generated file changes in the patch
since some extraneous changes were showing up as well.

The docs use a few different ways to style man refs, this consolidates
those & makes `pod2man`'s man-ref detection heuristic explicit.
Combined with the podlator PR, fixes the wierd half-bolds on man
references `urxvt-extensions(1)` & `urxvtperl(3)`.

This does also modify the styling of the generated html files, by
default it looks like `pod2xhtml` converts man links to `<cite>`s, which
are italicized by default. If this is undesired, there are a few
potential fixes, in order of potential impact:

- modify `pod.css` to bold (or something else) `<cite>` elements
- patch/upstream `pod2xhtml` to do something fancier with man references
- migrate to `pod2html`*

Currently, pod2html auto-links man page references links to
<http://man.he.net/>, which is kind of slick but also 404s on `urxvt`
refs.

Anyways, a further rightup/exploratory log can be found here:
https://sirabella.org/blog/rabbitholes

-- 
Marco Sirabella
-------------- next part --------------
A non-text attachment was scrubbed...
Name: manlinks.patch
Type: text/x-patch
Size: 15500 bytes
Desc: not available
URL: <http://lists.schmorp.de/pipermail/rxvt-unicode/attachments/20230425/52ec8f4e/attachment.bin>


More information about the rxvt-unicode mailing list