Re: [ANNOUNCE] GIT 1.5.3-rc4

From: Linus Torvalds <torvalds@linux-foundation.org>
Date: Aug 4, 2007, 16:59 UTC
Message-ID: <alpine.LFD.0.999.0708040954320.5037@woody.linux-foundation.org>
In-Reply-To: <85zm17h4pn.fsf@lola.goethe.zz>

On Sat, 4 Aug 2007, David Kastrup wrote:

> 
> A system such as info, in contrast, is hierarchical, and organized
> with indexes and cross references making it much easier to find
> things.

You must be kidding. Texinfo is the worst documentation format EVER. And the readers universally suck too, unless you're a total GNU emacs fan and have been for a decade, and have problems understanding people who don't like the all-in-one mentality.

There are absolutely _zero_ advantages in Texinfo over AsciiDoc. It has all the same disadvantages, except the source files are *also* unreadable (which is the one really nice feature of AsciiDoc - you can ignore everything else, and just read the original .txt file).

			Linus

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