Re: [docutils:feature-requests] Re: #72 rst2man: Show reference targets

On Wed, 16 Aug 2023 at 05:38, G. Branden Robinson <
[email protected]> wrote:

> Hi Engelbert,
>
> At 2023-08-14T10:41:58+0200, engelbert gruber wrote:
> > On man 7 man (AFAIR) is a list of safe statements .sp asf
>
> Yes.  The man(7) page from the Linux man-pages project does have a list
> of "safe" formatter requests.  Long story short, the current Linux
> man-pages maintainer would like to withdraw the page and has invited me
> to submit (the equivalent of) a merge request to do so.[1]  mandoc
> maintainer Ingo Schwarze and I take a pretty different approach to the
> problem; we agree that minimal use of formatter requests, and sticking
> to the existing sets of package macros (plus a few escape sequences) is
> the most reliable route to portable man page rendering.
>



>
> That "minimal" approach also means that people writing man(7) documents
> or tools to generate them have to master much less material.
>
>
>
> For those whose systems don't have 1.23.0 installed yet, the
> groff_man_style(7) document can be read in PDF; go to page 253.
>
> https://www.gnu.org/software/groff/manual/groff-man-pages.pdf


did put it on my list :-)


>
>
> [1] "I want to kill that page"
>

take him by his word  submit a minimal page pointing to the macros

actually in my understanding man 7 man should be the man macros
groff_man or man_roff or man _groff should container formatter requests

cheers


>
> https://lore.kernel.org/linux-man/[email protected]/T/#m124e9719a24560c8ed5526e7464d4a4c311008a7
> _______________________________________________
> Docutils-develop mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/docutils-develop
>
> Please use "Reply All" to reply to the list.
>