Re: rst man pages

On Tue, Sep 17, 2024 at 02:10:19PM +0200, [email protected] wrote:
> In the Xorg sources, there are "man" pages provided as rst
> (ReStructured Text) files that have to be processed to give a man
> page.
> 
> In current (src and xsrc), external/mit/xorg/share/man/man[37] expect
> the *.[37] files.

[Blushing] The addition of the missing man pages in the Makefile was my 
doing... So the compilation stumbling was stumbling on something
I added in my git version...

So it's not a NetBSD vanilla problem.

But one (tool) question remains: there are some xorg man pages provided
as rst text. Processing them is dragging python and the hell in the
compilation process.

Does somebody know of a POSIX.2 script utility able to take a rst file
and translate it to a "good enough" mdoc man page? I was unable to
find some.

Or, in such a case, is it customary to add a translated version to the
sources to avoid supplementary tools?

And BTW: Xorg is trying to switch to meson, and some modules have
already dropped the autotools files. I'm trying to translate things
using my RISK framework (only a subset of POSIX.2 utilities) that
may be more easily translated to BSD Makefiles afterwards (a
meson.build is more easy to read that the auto* maze of files, but
not easy to translate), but with the DRMKMS business on one side,
and the state of Xorg on the other, makes a frightening picture...

-- 
        Thierry Laronde <tlaronde +AT+ kergis +dot+ com>
                     http://www.kergis.com/
                    http://kertex.kergis.com/
Key fingerprint = 0FF7 E906 FBAF FE95 FD89  250D 52B1 AE95 6006 F40C