Re: [PATCH 2/4] strbuf.h: drop asciidoc list formatting from API docs

From: Junio C Hamano <gitster@pobox.com>
Date: Dec 12, 2014, 22:19 UTC
Message-ID: <xmqqk31weckr.fsf@gitster.dls.corp.google.com>
In-Reply-To: <20141212212820.GB27451@peff.net>

Jeff King <peff@peff.net> writes:

> Using a hanging indent is much more readable. This means we
> won't format as asciidoc anymore, but since we don't have a
> working system for extracting these comments anyway, it's
> probably more important to just make the source readable.

Yeah.

Those who want to strip the leading " * " to turn it into AsciiDoc would need to also parse out the hanging indent and format into AsciiDoc, which is not entirely an unreasonable thing to ask.

$ 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.