From mboxrd@z Thu Jan  1 00:00:00 1970
Message-ID: <502829B2.7000509@grinta.net>
Date: Mon, 13 Aug 2012 00:09:54 +0200
From: Daniele Nicolodi <daniele@grinta.net>
MIME-Version: 1.0
References: <50260DCB.90401@xenomai.org>
In-Reply-To: <50260DCB.90401@xenomai.org>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Subject: Re: [Xenomai] Using asciidoc for README.INSTALL
List-Id: Discussions about the Xenomai project <xenomai.xenomai.org>
List-Unsubscribe: <http://www.xenomai.org/mailman/options/xenomai>,
	<mailto:xenomai-request@xenomai.org?subject=unsubscribe>
List-Archive: <http://www.xenomai.org/pipermail/xenomai>
List-Post: <mailto:xenomai@xenomai.org>
List-Help: <mailto:xenomai-request@xenomai.org?subject=help>
List-Subscribe: <http://www.xenomai.org/mailman/listinfo/xenomai>,
	<mailto:xenomai-request@xenomai.org?subject=subscribe>
To: xenomai@xenomai.org

On 11/08/2012 09:46, Gilles Chanteperdrix wrote:
> So, maybe we could use an asciidoc version.

> pros:
> - nice online html version
> - online one source file to maintain
> cons:
> - need to learn asciidoc syntax to maintain the doc
> - a slightly less readable plain text version

For what it is worth, I find reStructuredText [1] much more readable in
its "raw" format that asciidoc. reStructuredText is the nowadays
standard for Python documentation.

[1] http://docutils.sourceforge.net/rst.html

Cheers,
Daniele