Hi,
I was wondering why scdoc is used? I am not too familiar with the tool,
but the output seems sub-standard and is not commonly available.
Wouldn't using mdoc (https://manpages.bsd.lv/) be more idiomatic,
provide better results and be more widely usable?
On Tuesday, October 25th, 2022 at 19:32, Philip Kaludercic <philipk@posteo.net> wrote:
> I was wondering why scdoc is used? I am not too familiar with the tool,> but the output seems sub-standard and is not commonly available.
Nope, sorry, I'm not switching to something else. scdoc is small,
portable and widely available.
Simon Ser <contact@emersion.fr> writes:
> On Tuesday, October 25th, 2022 at 19:32, Philip Kaludercic <philipk@posteo.net> wrote:>>> I was wondering why scdoc is used? I am not too familiar with the tool,>> but the output seems sub-standard and is not commonly available.>> Nope, sorry, I'm not switching to something else. scdoc is small,> portable and widely available.
"Something else" sounds wrong, as I am just suggesting providing a
regular man page, written in regular troff, using the "mdoc" macro set
(or the traditional "man" macros if you prefer that). This is
inherently more smaller and more portable, as there is one component
less that can fail. (E.g. even though I had installed scdoc on my
system, the resulting man page was empty. I haven't had the time to
debug the issue, but it was an annoyance).
If there is any interest, I can take care of converting the
documentation myself.