From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.org/gmane.linux.lib.musl.general/4002 Path: news.gmane.org!not-for-mail From: Christian Wiese Newsgroups: gmane.linux.lib.musl.general Subject: Re: Initial draft of musl documentation/manual Date: Mon, 02 Sep 2013 08:11:39 +0100 Message-ID: <26b8c482b3f030bdf2bfc710959abd20@10.1.1.2> References: <20130901044106.GA29630@brightrain.aerifal.cx> Reply-To: musl@lists.openwall.com NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Trace: ger.gmane.org 1378105845 21845 80.91.229.3 (2 Sep 2013 07:10:45 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 2 Sep 2013 07:10:45 +0000 (UTC) To: Original-X-From: musl-return-4006-gllmg-musl=m.gmane.org@lists.openwall.com Mon Sep 02 09:10:49 2013 Return-path: Envelope-to: gllmg-musl@plane.gmane.org Original-Received: from mother.openwall.net ([195.42.179.200]) by plane.gmane.org with smtp (Exim 4.69) (envelope-from ) id 1VGOHf-0006lk-Vy for gllmg-musl@plane.gmane.org; Mon, 02 Sep 2013 09:10:48 +0200 Original-Received: (qmail 30227 invoked by uid 550); 2 Sep 2013 07:10:42 -0000 Mailing-List: contact musl-help@lists.openwall.com; run by ezmlm Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: Original-Received: (qmail 30213 invoked from network); 2 Sep 2013 07:10:40 -0000 X-Mail-Scanner: Scanned by qSheff-II-2.1-r3 (http://www.enderunix.org/qsheff/) In-Reply-To: <20130901044106.GA29630@brightrain.aerifal.cx> X-Sender: chris@opensde.net User-Agent: RoundCube Webmail/0.3-trunk Xref: news.gmane.org gmane.linux.lib.musl.general:4002 Archived-At: Hi, On Sun, 1 Sep 2013 00:41:06 -0400, 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... > 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 like. Cheers, Chris [1] http://asciidoc.org/ [2] http://asciidoc.org/index.txt