Follow @Openwall on Twitter for new release announcements and other news
[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Date: Mon, 02 Sep 2013 08:11:39 +0100
From: Christian Wiese <>
To: <>
Subject: Re: Initial draft of musl documentation/manual


On Sun, 1 Sep 2013 00:41:06 -0400, Rich Felker <> wrote:
> One more thing: the format of the document is presently 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...
in my opinion the "being fully readable as plain text" is a good thing
and should be preserved. I don't know much about markdown and its
capabilities, and how easily or non-easily it is done to generate
high-quality documents in different output formats from it.

Asciidoc [1] for example fulfils this criteria, by being fully readable
as plain text, and providing the capability to generate different kinds
of output formats in a high quality.

"The asciidoc(1) command translates AsciiDoc files to HTML, XHTML and
DocBook markups. DocBook can be post-processed to presentation formats
such as HTML, PDF, EPUB, DVI, LaTeX, roff, and Postscript using readily
available Open Source tools."

You can take a look at the asciidoc source file of the index page the
asciddoc website is rendered from to get a slight overview how it looks



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.