From mboxrd@z Thu Jan 1 00:00:00 1970 From: Junio C Hamano Subject: [PATCH 1/6] Documentation/git-commit.txt: describe --dry-run Date: Sat, 15 Aug 2009 03:06:38 -0700 Message-ID: <1250330803-22171-2-git-send-email-gitster@pobox.com> References: <1250330803-22171-1-git-send-email-gitster@pobox.com> Cc: Jeff King To: git@vger.kernel.org X-From: git-owner@vger.kernel.org Sat Aug 15 12:07:16 2009 Return-path: Envelope-to: gcvg-git-2@gmane.org Received: from vger.kernel.org ([209.132.176.167]) by lo.gmane.org with esmtp (Exim 4.50) id 1McGAM-00053t-8d for gcvg-git-2@gmane.org; Sat, 15 Aug 2009 12:07:14 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751880AbZHOKGx (ORCPT ); Sat, 15 Aug 2009 06:06:53 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1751785AbZHOKGv (ORCPT ); Sat, 15 Aug 2009 06:06:51 -0400 Received: from a-pb-sasl-sd.pobox.com ([64.74.157.62]:36324 "EHLO sasl.smtp.pobox.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751625AbZHOKGu (ORCPT ); Sat, 15 Aug 2009 06:06:50 -0400 Received: from localhost.localdomain (unknown [127.0.0.1]) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTP id 757AC2ABCA; Sat, 15 Aug 2009 06:06:51 -0400 (EDT) Received: from pobox.com (unknown [68.225.240.211]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTPSA id 99C4B2ABC9; Sat, 15 Aug 2009 06:06:47 -0400 (EDT) X-Mailer: git-send-email 1.6.4.224.g3be84 In-Reply-To: <1250330803-22171-1-git-send-email-gitster@pobox.com> X-Pobox-Relay-ID: 5A2FC5A0-8983-11DE-A199-AEF1826986A2-77302942!a-pb-sasl-sd.pobox.com Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: Signed-off-by: Junio C Hamano --- * The --dry-run option is already in 'next', but haven't been described. Documentation/git-commit.txt | 13 +++++++++---- 1 files changed, 9 insertions(+), 4 deletions(-) diff --git a/Documentation/git-commit.txt b/Documentation/git-commit.txt index d01ff5a..64f94cf 100644 --- a/Documentation/git-commit.txt +++ b/Documentation/git-commit.txt @@ -9,7 +9,7 @@ SYNOPSIS -------- [verse] 'git commit' [-a | --interactive] [-s] [-v] [-u] [--amend] [--dry-run] - [(-c | -C) ] [-F | -m ] + [(-c | -C) ] [-F | -m ] [--dry-run] [--allow-empty] [--no-verify] [-e] [--author=] [--cleanup=] [--] [[-i | -o ]...] @@ -42,10 +42,9 @@ The content to be added can be specified in several ways: by one which files should be part of the commit, before finalizing the operation. Currently, this is done by invoking 'git-add --interactive'. -The 'git-status' command can be used to obtain a +The `--dry-run` option can be used to obtain a summary of what is included by any of the above for the next -commit by giving the same set of parameters you would give to -this command. +commit by giving the same set of parameters (options and paths). If you make a commit and then find a mistake immediately after that, you can recover from it with 'git-reset'. @@ -70,6 +69,12 @@ OPTIONS Like '-C', but with '-c' the editor is invoked, so that the user can further edit the commit message. +--dry-run:: + Do not actually make a commit, but show the list of paths + with updates in the index, paths with changes in the work tree, + and paths that are untracked, similar to the one that is given + in the commit log editor. + -F :: --file=:: Take the commit message from the given file. Use '-' to -- 1.6.4.224.g3be84