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

[PATCH v8 0/5] group common commands by theme

From
Sébastien Guimmara <sebastien.guimmara@gmail.com>
Date
May 18, 2015, 19:18 UTC
Message-ID
<1431976697-26288-1-git-send-email-sebastien.guimmara@gmail.com>

No major improvement over v7 [1], this v8 drops the [common] and [commands] headers, instead relying on commented headers "### command list" and "### common groups." to avoid ulgy looking sed/awk parsing.

generate-cmdlist.awk: slight modification to allow parsing of those headers.

git help: the colon at the end of each group is dropped.
Summary: to help unfamiliar users grok the Git workflow, rework the 
output of 'git help' by grouping the commands by theme:
   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 [...]
   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
   [...]

This series depends on bf990a2 (command-list: fix whitespace inconsistency)[2]

[1] http://thread.gmane.org/gmane.comp.version-control.git/269167 [2] http://thread.gmane.org/gmane.comp.version-control.git/268649

Eric Sunshine (2):
  command-list: prepare machinery for upcoming "common groups" section
  generate-cmdlist: parse common group commands
Sébastien Guimmara (3):
  command-list.txt: add the common groups block
  command-list.txt: drop the "common" tag
  help: respect new common command grouping
 Documentation/cmd-list.perl |  4 ++++
 Makefile                    |  9 ++++----
 command-list.txt            | 53 +++++++++++++++++++++++++++------------------
 generate-cmdlist.awk        | 39 +++++++++++++++++++++++++++++++++
 generate-cmdlist.sh         | 23 --------------------
 help.c                      | 24 +++++++++++++++++++-
 6 files changed, 103 insertions(+), 49 deletions(-)
 create mode 100644 generate-cmdlist.awk
 delete mode 100755 generate-cmdlist.sh
-- 
2.4.0.GIT
Next: Sébastien Guimmara
Message 1 of 12 in “group common commands by theme”
  1. 0/5 group common commands by themeSébastien Guimmara, May 18, 2015
  2. 1/5 command-list: prepare machinery for upcoming "common groups" sectionSébastien Guimmara, May 18, 2015
  3. 2/5 command-list.txt: add the common groups blockSébastien Guimmara, May 18, 2015
  4. 3/5 generate-cmdlist: parse common group commandsSébastien Guimmara, May 18, 2015
  5. 4/5 command-list.txt: drop the "common" tagSébastien Guimmara, May 18, 2015
  6. 5/5 help: respect new common command groupingSébastien Guimmara, May 18, 2015
  7. Junio C HamanoMay 18, 2015
  8. Eric SunshineMay 19, 2015
  9. Junio C HamanoMay 19, 2015
  10. Eric SunshineMay 19, 2015
  11. Junio C HamanoMay 19, 2015
  12. Sébastien GuimmaraMay 19, 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.