From: Rich Felker <dalias@aerifal.cx>
To: musl@lists.openwall.com
Subject: Re: Initial draft of musl documentation/manual
Date: Sun, 1 Sep 2013 12:57:15 -0400 [thread overview]
Message-ID: <20130901165715.GV20515@brightrain.aerifal.cx> (raw)
In-Reply-To: <52230C48.8060502@gentoo.org>
On Sun, Sep 01, 2013 at 11:43:36AM +0200, Luca Barbato wrote:
> On 01/09/13 06:41, Rich Felker wrote:
> > One more thing: the format of the document is presently Markdown
> > (http://daringfireball.net/projects/markdown/). I may switch to
> > something else in the future, but Markdown tends to be my favorite
> > from a standpoint of being fully readable as plain text and also
> > producing decent formatted output in HTML (and other formats, via
> > conversion from HTML). Comments on this bikeshed topic are also
> > welcome, I suppose, unless it gets out of hand...
>
> Markdown to man converters are the best available (e.g. kramdown-man)
> and markdown is usually easy to grok.
Excellent. I'm not sure man format would be terribly useful for the
musl documentation I'm working on now, but it's good to know for
future reference, especially if we do want to provide a few man pages
that could be installed for musl.
For the big doc, HTML and PDF are probably the more interesting output
formats. The big thing I don't see how to do easily is produce a nice
table of contents or index.
Rich
next prev parent reply other threads:[~2013-09-01 16:57 UTC|newest]
Thread overview: 19+ messages / expand[flat|nested] mbox.gz Atom feed top
2013-09-01 4:41 Rich Felker
2013-09-01 9:43 ` Luca Barbato
2013-09-01 16:57 ` Rich Felker [this message]
2013-09-02 0:08 ` Luca Barbato
2013-09-02 7:12 ` Ivan Kanakarakis
2013-09-01 13:45 ` Vasily Kulikov
2013-09-01 16:54 ` Rich Felker
2013-09-02 7:11 ` Christian Wiese
2013-09-06 1:12 ` Second " Rich Felker
2013-09-06 2:41 ` Szabolcs Nagy
2013-09-06 2:57 ` Rich Felker
2013-09-06 4:20 ` Third " Rich Felker
2013-09-06 15:14 ` Szabolcs Nagy
2013-09-06 15:47 ` Rich Felker
2013-09-07 14:50 ` Szabolcs Nagy
2013-09-08 19:22 ` Ivan Kanakarakis
2013-09-09 11:42 ` AW: " Bortis Kevin
2013-09-09 12:09 ` Bortis Kevin
2013-09-09 15:49 ` Rich Felker
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20130901165715.GV20515@brightrain.aerifal.cx \
--to=dalias@aerifal.cx \
--cc=musl@lists.openwall.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.vuxu.org/mirror/musl/
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).