Re: [docutils:feature-requests] Re: #72 rst2man: Show reference targets
Dmitry Shachnev <[email protected]>
| Newsgroups | gmane.text.docutils.devel |
|---|---|
| Message-ID | <[email protected]> |
On Thu, Aug 10, 2023 at 10:41:03AM -0000, Guenter Milde via Docutils-develop wrote:
> On 2023-08-09, Dmitry Shachnev wrote:
> > On Tue, Aug 08, 2023 at 07:58:28AM -0000, Guenter Milde via Docutils-develop wrote:
>
> >> > Another possibility would be using the `.UR` / `.UE` macros to produce
> >> > hyperlinks. They are described in groff_man(7) man page.
> ...
> >> How would this be handled by other (t)roff converters?
>
> > What other implementations do we want to support?
>
> I remember discussions about the BSD versions but don't remember the outcome.
> Engelbert is our specialist for the man writer.
FreeBSD's and OpenBSD's man(7) mention the .UR / .UE macros:
UR Begin a uniform resource identifier block. This is a non-standard
GNU extension. It has the following syntax:
.UR uri
link description to be shown
.UE
Although, they also say "Use the mdoc(7) language, instead", and mdoc(7) does
not mention these macros.
The same for .EX / .EE which we started using recently.
--
Dmitry Shachnev