git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: Where do I stick development documentation?

From
Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Date
Aug 12, 2010, 20:08 UTC
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:
Show 7 quoted lines
> 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.

Previous: Michael WittenNext: Jonathan Nieder
Message 8 of 11 in “Where do I stick development documentation?”
  1. Ævar Arnfjörð BjarmasonAug 11, 2010
  2. Jonathan NiederAug 12, 2010
  3. Ævar Arnfjörð BjarmasonAug 12, 2010
  4. Low-level repository inspection (Re: Where do I stick development documentation?)Jonathan Nieder, Aug 12, 2010
  5. Ævar Arnfjörð BjarmasonAug 12, 2010
  6. Jonathan NiederAug 12, 2010
  7. Michael WittenAug 12, 2010
  8. Ævar Arnfjörð BjarmasonAug 12, 2010
  9. Jonathan NiederAug 12, 2010
  10. Jonathan NiederAug 12, 2010
  11. Ævar Arnfjörð BjarmasonAug 12, 2010

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.