[docutils:feature-requests] #107 use .MR for references to man-pages

Just a quick note.  You will not need to generate the arguments to the `MR` macro with a leading `\%` escape sequence.  The _groff_man_style_ man page has them here for complicated reasons; the short version is that the _tbl_, _eqn_, and _refer_ programs can be installed with a prefix determined by the builder of _groff_ at compilation time, because _groff_  supports being installed simultaneously with another (usually AT&T or AT&T-descended)  _troff_.   The prefix can be expanded in contexts where hyphenation is _not_ disabled, so a hyphenation control escape sequence is always prepended, even if the prefix is empty.  This is harmless.  I just wanted to point it out so that you don't think you've have to generate these escape sequences in the output you produce.


---

**[feature-requests:#107] use .MR for references to man-pages**

**Status:** open
**Group:** Default
**Labels:** manpage writer 
**Created:** Sun May 12, 2024 03:43 PM UTC by engelbert gruber
**Last Updated:** Sun May 12, 2024 03:44 PM UTC
**Owner:** engelbert gruber


the manpage of groff_man_style 

> See also
>        tbl(1), eqn(1), and refer(1) are preprocessors used with man pages.  man(1)  de‐
>        scribes  the man page librarian on your system.

is written using the .MR macro

~~~
  .SH "See also"
  .
  .MR \%tbl 1 ,
  .MR \%eqn 1 ,
  and
  .MR \%refer 1
  are preprocessors used with man pages.
  .
  .MR man 1
  describes the man page librarian on your system.
~~~

But then the rST input would loo like

~~~
See also
--------

tbl(1), eqn(1), and refer(1) are preprocessors used with man pages.  
man(1)  describes  the man page librarian on your system.
~~~

meaning we need to find the already formatted manpage references , which could be anywhere
in the text (except code . in code man(1) would be calling function man)


---

Sent from sourceforge.net because [email protected] is subscribed to https://sourceforge.net/p/docutils/feature-requests/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/feature-requests/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.