~emersion/soju-dev

4 2

Switching to a regular Man page?

Details
Message ID
<87ilk7kdws.fsf@posteo.net>
DKIM signature
pass
Download raw message
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?
Details
Message ID
<7LMqiDvJBGYp5y-K1DvwLQX3mK8yTwb6SBpu6c74w11q6CQnDhaTOQTs0VCNctiKuyawHlAzWzgeG3V412pZjpXZXA197YNDR27wxCrQAOU=@emersion.fr>
In-Reply-To
<87ilk7kdws.fsf@posteo.net> (view parent)
DKIM signature
pass
Download raw message
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.
Details
Message ID
<87h6zrrssd.fsf@posteo.net>
In-Reply-To
<7LMqiDvJBGYp5y-K1DvwLQX3mK8yTwb6SBpu6c74w11q6CQnDhaTOQTs0VCNctiKuyawHlAzWzgeG3V412pZjpXZXA197YNDR27wxCrQAOU=@emersion.fr> (view parent)
DKIM signature
pass
Download raw message
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.
Details
Message ID
<TQ6xA9Iaad8Mb3h7A9ovB9T4szjv-7oU77jR4UndcL9LS7lcaTLkxomaSTsN3AZMDhNMDOJ4iDhGzx9l3TV4xIqEaXOLjyLBPHxWxScdYwM=@emersion.fr>
In-Reply-To
<87h6zrrssd.fsf@posteo.net> (view parent)
DKIM signature
pass
Download raw message
There is no interest, the answer is no.
Details
Message ID
<87a65jq90b.fsf@posteo.net>
In-Reply-To
<TQ6xA9Iaad8Mb3h7A9ovB9T4szjv-7oU77jR4UndcL9LS7lcaTLkxomaSTsN3AZMDhNMDOJ4iDhGzx9l3TV4xIqEaXOLjyLBPHxWxScdYwM=@emersion.fr> (view parent)
DKIM signature
pass
Download raw message
Simon Ser <contact@emersion.fr> writes:

> There is no interest, the answer is no.

OK then, thank you anyway.
Reply to thread Export thread (mbox)