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

Re: [StGit PATCH 1/3] Auto-generate man pages for all StGit commands

From
CMCatalin Marinas <catalin.marinas@gmail.com>
Date
Sep 10, 2008, 21:56 UTC
Message-ID
<b0943d9e0809101456w3c74b86fm9d311fb2594bcf4f@mail.gmail.com>
In-Reply-To
<20080908210758.1957.664.stgit@yoghurt>
On 08/09/2008, Karl Hasselström <kha@treskal.com> wrote:
> Auto-generate man pages based on the docs that are in each
>  stgit/commands/<cmd>.py file. That doc format is extended in order to
>  support both brief command help output and manpage text.
Really great stuff. Thanks.

I can see a slight difference in behaviour but I don't have any issue with it - previously "stg help <cmd>" showed the full description while "stg <cmd> --help" only the short one.

An additional point on naming - should we use StGIT or StGit? The original name was StGIT since GIT looked like an acronym. It looks like now more people name it Git hence our tool moved slowly into StGit but not everywhere. I personally like StGIT but the last 3 letters should really be the same as the official git (Git, GIT).

-- 
Catalin
Previous: Karl HasselströmNext: Karl Hasselström
Message 6 of 7 in “Auto-generate man pages and command list”
  1. 0/3 Auto-generate man pages and command listKarl Hasselström, Sep 8, 2008
  2. 2/3 asciidoc.conf: Steal updates from gitKarl Hasselström, Sep 8, 2008
  3. 3/3 Generate command lists automaticallyKarl Hasselström, Sep 8, 2008
  4. Fixes for auto-generation of man pagesDaniel White, Sep 9, 2008
  5. Karl HasselströmSep 10, 2008
  6. Catalin MarinasSep 10, 2008
  7. Karl HasselströmSep 11, 2008

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.