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

Re: [ANNOUNCE] GIT preformatted documentation available.

From
ABAdrien Beau <adrienbeau@gmail.com>
Date
Dec 28, 2005, 16:51 UTC
Message-ID
<94fc236b0512280851n797ecbedjecae3f8131b84369@mail.gmail.com>
In-Reply-To
<7vu0cuc4c2.fsf@assigned-by-dhcp.cox.net>
On 12/27/05, Junio C Hamano <junkio@cox.net> wrote:
Show 11 quoted lines
>
> I was asked to provide pre-formatted man pages (and perhaps html
> pages), since the time of kernel developers are better spent on
> what they do best, rather than preparing the xmlto toolchain.
>
> I was planning to do a tarball every time I do a "release", but
> that would mean it is no better than the current way --- you
> could extract manpages out of rpm anyway.
>
> So instead, I'll do independent branches "html" and "man" in
> git.git repository to keep the preformatted documentation.

Having preformatted documentation is a great step forward, but it would be even better if we could have it without installing some weird RPM tool or a local copy of the Git repository -- not all my machines have that.

Besides, it's not very beginner- or newcomer-friendly. Grab the source; discover you need a complex toolchain to have manpages; maybe learn sometime later that "all you had to do" was get an RPM and explode some parts of it -- nah, it just doesn't feel right.

You're already generating five RPMs and two tarballs everytime you release a version, would it be much more taxing to generate a third tarball?

That said, those two new branches are neat. Thanks!
Previous: Junio C Hamano
Message 2 of 2 in “[ANNOUNCE] GIT preformatted documentation available.”
  1. Junio C HamanoDec 27, 2005
  2. Adrien BeauDec 28, 2005

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.