From: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Date: Thu, 12 Aug 2010 20:08:41 GMT
Subject: Re: Where do I stick development documentation?
Message-ID: <AANLkTinT9ev0MWNP_Z4vnFGoMN6jSSPPPK4KiZzyLQhS@mail.gmail.com>
In-Reply-To: <AANLkTikTX5_qchqDuxiz=dGeTG0gB7_iRt=mpR9vJH5J@mail.gmail.com>

On Thu, Aug 12, 2010 at 20:00, Michael Witten <mfwitten@gmail.com> wrote:
> On Wed, Aug 11, 2010 at 22:11, Ævar Arnfjörð Bjarmason <avarab@gmail.com> wrote:
>>
>> That would totally screw with my secret mission to turn everything
>> into manpages, though :)
>
> Frankly, it sounds like you want something more expressive and
> interlinked, such as Texinfo documentation.

I'd like TexInfo, but I don't think Git is switching to that anytime
soon.

However ASCIIDOC is also fine for my purposes, which is just that
these docs will be compiled as part of the manpage compilation, so
they'll be there with man(1), info(1) and on the web with the HTML
export.