Date: Tue, 12 Dec 2017 23:34:56 +0300
From: Consus <consus@ftml.net>
To: alpine-devel@lists.alpinelinux.org
Subject: Re: [alpine-devel] Improving Alpine Linux documentation
Message-ID: <20171212203455.GC9334@eddy>
Mail-Followup-To: alpine-devel@lists.alpinelinux.org
References: <20171212201302.GA9334@eddy>
 <20171212202301.GA26329@miku>
 <20171212202626.GB9334@eddy>
 <20171212203147.GA27466@miku>
Precedence: list
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20171212203147.GA27466@miku>

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.


---
Unsubscribe:  alpine-devel+unsubscribe@lists.alpinelinux.org
Help:         alpine-devel+help@lists.alpinelinux.org
---