From: Philip Kaludercic <philipk@posteo.net>
To: Simon Ser <contact@emersion.fr>
Cc: ~emersion/soju-dev@lists.sr.ht
Subject: Re: Switching to a regular Man page?
In-Reply-To: <7LMqiDvJBGYp5y-K1DvwLQX3mK8yTwb6SBpu6c74w11q6CQnDhaTOQTs0VCNctiKuyawHlAzWzgeG3V412pZjpXZXA197YNDR27wxCrQAOU=@emersion.fr>
	(Simon Ser's message of "Tue, 25 Oct 2022 21:28:42 +0000")
References: <87ilk7kdws.fsf@posteo.net>
	<7LMqiDvJBGYp5y-K1DvwLQX3mK8yTwb6SBpu6c74w11q6CQnDhaTOQTs0VCNctiKuyawHlAzWzgeG3V412pZjpXZXA197YNDR27wxCrQAOU=@emersion.fr>
Autocrypt: addr=philipk@posteo.net; prefer-encrypt=nopreference; keydata=
 mDMEYHHqUhYJKwYBBAHaRw8BAQdAp3GdmYJ6tm5McweY6dEvIYIiry+Oz9rU4MH6NHWK0Ee0QlBo
 aWxpcCBLYWx1ZGVyY2ljIChnZW5lcmF0ZWQgYnkgYXV0b2NyeXB0LmVsKSA8cGhpbGlwa0Bwb3N0
 ZW8ubmV0PoiQBBMWCAA4FiEEDM2H44ZoPt9Ms0eHtVrAHPRh1FwFAmBx6lICGwMFCwkIBwIGFQoJ
 CAsCBBYCAwECHgECF4AACgkQtVrAHPRh1FyTkgEAjlbGPxFchvMbxzAES3r8QLuZgCxeAXunM9gh
 io0ePtUBALVhh9G6wIoZhl0gUCbQpoN/UJHI08Gm1qDob5zDxnIHuDgEYHHqUhIKKwYBBAGXVQEF
 AQEHQNcRB+MUimTMqoxxMMUERpOR+Q4b1KgncDZkhrO2ql1tAwEIB4h4BBgWCAAgFiEEDM2H44Zo
 Pt9Ms0eHtVrAHPRh1FwFAmBx6lICGwwACgkQtVrAHPRh1Fw1JwD/Qo7kvtib8jy7puyWrSv0MeTS
 g8qIxgoRWJE/KKdkCLEA/jb9b9/g8nnX+UcwHf/4VfKsjExlnND3FrBviXUW6NcB
Date: Wed, 26 Oct 2022 06:41:06 +0000
Message-ID: <87h6zrrssd.fsf@posteo.net>
MIME-Version: 1.0
Content-Type: text/plain

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.