Re: Documentation

[Emmanuele Bassi <ebassi gmail com>]

hi;

On 1 February 2014 15:19, Colin Walters <walters verbum org> wrote:
> On Sat, Feb 1, 2014 at 10:08 AM, Matthias Clasen <matthias clasen gmail com>
> wrote:
>
>
> - Make the doc comments more readable by moving from clunky docbook markup
>   to markdown. This will help both for reading and updating the
> documentation in
>   the sources, and for limiting the scope of whar our
> documentation-generating
>   tools need to parse when generating online docs.
>
>
> Interesting.  I'm in favor of Markdown.  But does gtk-doc understand it at
> all?

yes, it does parse Markdown, and has for a while (it's also under
regression testing).

I've been meaning to port the documentation of the libraries I
maintain from docbook to markdown for a while, but haven't come around
doing it — always something else getting bumped up in the priority
queue. :-)

ciao,
 Emmanuele.

-- 
W: http://www.emmanuelebassi.name
B: http://blogs.gnome.org/ebassi/