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

[PATCH 0/5] git help: group common commands by theme

From
Sébastien Guimmara <sebastien.guimmara@gmail.com>
Date
May 14, 2015, 12:59 UTC
Message-ID
<1431608351-9413-1-git-send-email-sebastien.guimmara@gmail.com>

This v6 is very similar in content to the v5 [1], except minor formatting adjustments in 'git help' output and recommendations from Eric.

The major change is in the patch series itself. Commits have been reordered and adjusted so that each 'apply' doesn't break the build, and preserve bisectability.

Summary: make 'git help' outputs a more usable and friendlier
list of commands, grouped by theme according to the typical Git workflow:
[...]
The typical Git workflow includes:
start a working area (see also: git help tutorial):
   clone      Clone a repository into a new directory
   init       Create an empty Git repository or reinitialize an existing one
work on the current change (see also: git help everyday):
   add        Add file contents to the index
   mv         Move or rename a file, a directory, or a symlink
   reset      Reset current HEAD to the specified state
   rm         Remove files from the working tree and from the index
[...]
Many thanks to Eric Sunshine for the detailed help and advice !
[1]: http://thread.gmane.org/gmane.comp.version-control.git/268701
Eric Sunshine (1):
  generate-cmdlist: parse common group commands
Sébastien Guimmara (4):
  command-list.txt: prepare with [commands] header
  command-list.txt: add with [common] block
  command-list.txt: drop the common- prefix
  help.c: output the typical Git workflow
 Documentation/cmd-list.perl         |  4 +++
 Documentation/howto/new-command.txt |  4 ++-
 Makefile                            |  7 ++---
 command-list.txt                    | 53 ++++++++++++++++++++++---------------
 generate-cmdlist.awk                | 39 +++++++++++++++++++++++++++
 generate-cmdlist.sh                 | 23 ----------------
 help.c                              | 24 ++++++++++++++++-
 7 files changed, 105 insertions(+), 49 deletions(-)
 create mode 100644 generate-cmdlist.awk
 delete mode 100755 generate-cmdlist.sh
-- 
2.4.0
Next: Sébastien Guimmara
Message 1 of 12 in “git help: group common commands by theme”
  1. 0/5 git help: group common commands by themeSébastien Guimmara, May 14, 2015
  2. 1/5 command-list.txt: prepare with [commands] headerSébastien Guimmara, May 14, 2015
  3. 2/5 command-list.txt: add with [common] blockSébastien Guimmara, May 14, 2015
  4. 3/5 generate-cmdlist: parse common group commandsSébastien Guimmara, May 14, 2015
  5. Junio C HamanoMay 14, 2015
  6. Eric SunshineMay 14, 2015
  7. Sébastien GuimmaraMay 15, 2015
  8. 4/5 command-list.txt: drop the common- prefixSébastien Guimmara, May 14, 2015
  9. 5/5 help.c: output the typical Git workflowSébastien Guimmara, May 14, 2015
  10. 5/5 help.c: output the typical Git workflowSébastien Guimmara, May 14, 2015
  11. Junio C HamanoMay 14, 2015
  12. Sébastien GuimmaraMay 15, 2015

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.