Mail archive
alpine-devel

Re: [alpine-devel] Improving Alpine Linux documentation

From: A. Wilcox <awilfox_at_adelielinux.org>
Date: Tue, 12 Dec 2017 15:40:50 -0600

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

On 12/12/17 14:34, Consus wrote:
> On 15:31 Tue 12 Dec, Drew DeVault wrote:
>> On 2017-12-12 11:26 PM, Consus wrote:
>>> Try http://mdocml.bsd.lv. It is used by the OpenBSD project. I
>>> was writing man pages using it myself, it's pretty okay.
>>
>> mdocml is basically roff with lipstick on, I don't like it much
>> more than I liked roff. There are other man page generators,
>> too, but they're almost all written in high level languages and
>> require some kind of runtime (god forbid, XSLT). The new tool I'm
>> working on is a small POSIX C99 tool with no dependencies. Its
>> syntax is much easier to write, read, and maintain than mdoc.
>
> True. But this is more about the high-level documentation, not the
> tool's synopsis.


(Haha, I didn't even read this part of the thread before sending my
last mail.)

- --
A. Wilcox (awilfox)
Project Lead, Adélie Linux
http://adelielinux.org
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iQIcBAEBCAAGBQJaMEziAAoJEMspy1GSK50UcF4QALF4Qog6HvqKI24iT0CXuGQm
MJkIH+RyB2WApGaQdnVQiCkKZ/0rTEnmK/8nKtTrzykAA6hbztsI3k4avNRBxQs8
DzjfuP0klc6NapDSiHm2JxI6oUPXv2IbGf8IDJl1mxquKi+YxM7u137xXO3VReBp
cf6bwHf1R9b7fWWYyOJn0D0W+c0Eo6ZCzepsUaARq85eJNEBHvL9knZkEgsoNaGT
T1gqsFklF4GitYEz84qVPEkLtZQbAGml+tq8GZywxCi6aPWMKWlZZUV7DSA7Khtp
UG3caRR1LNR3Fjitt5k7LbXI+HGtX4a9G5kpPcIU/3AKzx9k6sZOVQk8dX2dQBZR
8JulGiJHIaD3oclxYEQZL0aQOJQvPBWtjTlXW4UIkKjojso3+Pw9s1iMmemV3WBH
6gN+rbJi7h5Yki2/HZycfMhAcN7sC1OH8dYkNVg3ELr+5XIBURFfdLLvQ3cIkpAm
kJ2f50g67qKASbq/wm3dKISlXzc5x/Vs7KgbXgoAbEZKkiTCTbsqeBIvXScOLZR+
b7hUat2YwlSWCjZi2I5HsqnqvSxV24qTCUFLDxRbhYeiKPKrvn30JB92BzqXycEn
ILtzATHPqR+wStw302isIglwswE96FdlgL42A4KAM2gXwLeBE9NKtSABrtHjsyFu
Fsg09H55B7mv1YHrhAzW
=hjIB
-----END PGP SIGNATURE-----


---
Unsubscribe:  alpine-devel+unsubscribe_at_lists.alpinelinux.org
Help:         alpine-devel+help_at_lists.alpinelinux.org
---
Received on Tue Dec 12 2017 - 15:40:50 GMT