Follow @Openwall on Twitter for new release announcements and other news
[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Date: Sun, 1 Sep 2013 12:57:15 -0400
From: Rich Felker <dalias@...ifal.cx>
To: musl@...ts.openwall.com
Subject: Re: Initial draft of musl documentation/manual

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

Powered by blists - more mailing lists

Confused about mailing lists and their use? Read about mailing lists on Wikipedia and check out these guidelines on proper formatting of your messages.