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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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

--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]