"Jeanette C." <julien@mail.upb.de> writes:
> I'd like to write a manpage for a small program that I have and I'd
> also like to practise. So I've been wondering what the real developers
> use.
>
> Are you writing your manpages straight in (G)ROFF or is there a
> "modern" pre-preprocessor that is widely used?
Straight groff isn't too bad, though I'm an old-school LaTeX fan.
Anyway, man(7) provides usable documentation. I'd expect CMake to
support it, but I've got Automake experience only.
I also use pod2man, mostly for scripts which can easily embed their
documentation. This helps with not forgetting to update the manpage,
but isn't standard and somewhat limiting with fancy stuff.
For API documentation (not for now) there is doxygen2man.
-- Feri _______________________________________________ Linux-audio-user mailing list Linux-audio-user@lists.linuxaudio.org https://lists.linuxaudio.org/listinfo/linux-audio-userReceived on Fri Apr 24 04:15:02 2020
This archive was generated by hypermail 2.1.8 : Fri Apr 24 2020 - 04:15:02 EEST