Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Optional printing of target URLs in groff output #30

Open
Code7R opened this issue Apr 4, 2024 · 1 comment
Open

Optional printing of target URLs in groff output #30

Code7R opened this issue Apr 4, 2024 · 1 comment

Comments

@Code7R
Copy link

Code7R commented Apr 4, 2024

Hi all,

we use pod2man to maintain a big portion of icewm documentation. For plain convenience, I would like to have the hyperlink rendering also add the pointed URL to the nroff version. Maybe it could also allow to specify characters which surround it.

Idea:

--printlink=surroundings
append the link target to the link name surrounded by two characters specied as surroundings

With that, --printlink=<> would convert -L<foo|http://bar> to foo <http://bar>.

Opinions? Is there a good existing way to do that? Patches wanted?

@Code7R Code7R changed the title Optional printing of target URLs win roff output Optional printing of target URLs in groff output Apr 4, 2024
@rra
Copy link
Owner

rra commented Apr 4, 2024

This is the default behavior, so I'm not sure why you're not seeing it already.

 % cat foo.pod 
=head1 Test

L<foo|https://example.com/>
% pod2man ./foo.pod | nroff -man -
FOO(1)                User Contributed Perl Documentation               FOO(1)

Test
       foo <https://example.com/>

perl v5.38.2                      2024-04-04                            FOO(1)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants