From mboxrd@z Thu Jan 1 00:00:00 1970 From: Philip Oakley Subject: [PATCH v2 0/5] Git help option to list user guides Date: Sun, 3 Mar 2013 20:21:07 +0000 Message-ID: <1362342072-1412-1-git-send-email-philipoakley@iee.org> To: GitList X-From: git-owner@vger.kernel.org Sun Mar 03 21:21:41 2013 Return-path: Envelope-to: gcvg-git-2@plane.gmane.org Received: from vger.kernel.org ([209.132.180.67]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UCFPg-0001Sf-3n for gcvg-git-2@plane.gmane.org; Sun, 03 Mar 2013 21:21:40 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753438Ab3CCUU6 (ORCPT ); Sun, 3 Mar 2013 15:20:58 -0500 Received: from out1.ip02ir2.opaltelecom.net ([62.24.128.238]:42779 "EHLO out1.ip02ir2.opaltelecom.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753346Ab3CCUU5 (ORCPT ); Sun, 3 Mar 2013 15:20:57 -0500 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AqkIAEauM1FZ8rke/2dsb2JhbABFhWe1cIdwF3OCfDuBAiSIKqZ4oAeSZAOnMoMI X-IronPort-AV: E=Sophos;i="4.84,774,1355097600"; d="scan'208";a="420373179" Received: from host-89-242-185-30.as13285.net (HELO localhost) ([89.242.185.30]) by out1.ip02ir2.opaltelecom.net with ESMTP; 03 Mar 2013 20:20:55 +0000 X-Mailer: git-send-email 1.8.1.msysgit.1 Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: This is the much truncated (was 0/13] and updated series for noting that 'git help' can display the existing guides that are formatted as man pages, and providing a 'git help' option to list a few of the most useful guides. The series is rebased on top of V1.8.2-rc1 Differences relative to V1 numbering Patch 1: Use 'Git' in help messages Dropped. a. the 'git version' string is used in the wild for version checking, in particular Git Gui checks the string is 'git version'. b. a recent patch series fixed on lower case messages for 'usage:', respect that. c. many consider that the 'git' reference was to the 'git ' format rather than (the system) Git's commands. Patch 2 (now 1/5): Show 'git help ' usage, with examples Correct elipsis dots for unterminated list of examples. Patch 2 (now 2/5): Help.c use OPT_COUNTUP Unchanged. Patch 4 (now 3/5): Help.c add --guide option Update commit message to explain the -g|--guide logic. Patch 5 (now 4/5): Help.c: add list_common_guides_help() function Removed the 'build artefact' /* */ comment line. Note that these are just the common guides and used in a usage message. The data was generated by a script variant of generate-cmdlist.sh Patch (new 5/5): Help doc: Include --guide option description Update the documentation/git-help.txt - I had been caught out by the same 'focus on the code' mistake made by many and forgot the documenation ;-) Patch 6 - 13: All dropped. Drop the separate guide list.txt and extraction script, which was copied from the common command list and script. If the guide usage list is useful, extend the command-list.txt and generate-cmdlist.sh at a later date. Drop the rename of user-manual and everyday because they are not formatted as manuals. They can't be started by help's call to 'man' (and possibly other paths) anyway. Philip Oakley (5): Show 'git help ' usage, with examples Help.c use OPT_COUNTUP Help.c add --guide option Help.c: add list_common_guides_help() function Help doc: Include --guide option description Documentation/git-help.txt | 28 +++++++++++++++++++++------- builtin/help.c | 11 ++++++++--- common-guides.h | 11 +++++++++++ git.c | 4 +++- help.c | 18 ++++++++++++++++++ help.h | 1 + 6 files changed, 62 insertions(+), 11 deletions(-) create mode 100644 common-guides.h -- 1.8.1.msysgit.1