From mboxrd@z Thu Jan 1 00:00:00 1970 From: Christian Couder Subject: [PATCH 8/8] Documentation/revert: describe passing more than one commit Date: Mon, 31 May 2010 21:42:39 +0200 Message-ID: <20100531194240.28729.15284.chriscool@tuxfamily.org> References: <20100531193359.28729.55562.chriscool@tuxfamily.org> Cc: git@vger.kernel.org, Johannes Schindelin , Sverre Rabbelier , Ramkumar Ramachandra , Jonathan Nieder To: Junio C Hamano X-From: git-owner@vger.kernel.org Tue Jun 01 05:05:08 2010 connect(): No such file or directory Return-path: Envelope-to: gcvg-git-2@lo.gmane.org Received: from vger.kernel.org ([209.132.180.67]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OJHmt-0000pF-0l for gcvg-git-2@lo.gmane.org; Tue, 01 Jun 2010 05:05:07 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754040Ab0FADEo (ORCPT ); Mon, 31 May 2010 23:04:44 -0400 Received: from smtp3-g21.free.fr ([212.27.42.3]:42096 "EHLO smtp3-g21.free.fr" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753795Ab0FADEl (ORCPT ); Mon, 31 May 2010 23:04:41 -0400 Received: from style.boubyland (gre92-7-82-243-130-161.fbx.proxad.net [82.243.130.161]) by smtp3-g21.free.fr (Postfix) with ESMTP id 6BD8481804E; Tue, 1 Jun 2010 05:04:33 +0200 (CEST) X-git-sha1: c18110a4eebb1397e5027e3991826aa7d0758be5 X-Mailer: git-mail-commits v0.5.2 In-Reply-To: <20100531193359.28729.55562.chriscool@tuxfamily.org> Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: And while at it, add an "Examples" section. Signed-off-by: Christian Couder --- Documentation/git-revert.txt | 52 ++++++++++++++++++++++++++++------------- 1 files changed, 35 insertions(+), 17 deletions(-) diff --git a/Documentation/git-revert.txt b/Documentation/git-revert.txt index c66bf80..5740f37 100644 --- a/Documentation/git-revert.txt +++ b/Documentation/git-revert.txt @@ -3,20 +3,22 @@ git-revert(1) NAME ---- -git-revert - Revert an existing commit +git-revert - Revert some existing commits SYNOPSIS -------- -'git revert' [--edit | --no-edit] [-n] [-m parent-number] [-s] +'git revert' [--edit | --no-edit] [-n] [-m parent-number] [-s] ... DESCRIPTION ----------- -Given one existing commit, revert the change the patch introduces, and record a -new commit that records it. This requires your working tree to be clean (no -modifications from the HEAD commit). -Note: 'git revert' is used to record a new commit to reverse the -effect of an earlier commit (often a faulty one). If you want to +Given one or more existing commits, revert the changes that the +related patches introduce, and record some new commits that record +them. This requires your working tree to be clean (no modifications +from the HEAD commit). + +Note: 'git revert' is used to record some new commits to reverse the +effect of some earlier commits (often only a faulty one). If you want to throw away all uncommitted changes in your working directory, you should see linkgit:git-reset[1], particularly the '--hard' option. If you want to extract specific files as they were in another commit, you @@ -26,10 +28,13 @@ both will discard uncommitted changes in your working directory. OPTIONS ------- -:: - Commit to revert. +...:: + Commits to revert. For a more complete list of ways to spell commit names, see "SPECIFYING REVISIONS" section in linkgit:git-rev-parse[1]. + Sets of commits can also be given but no traversal is done by + default, see linkgit:git-rev-list[1] and its '--no-walk' + option. -e:: --edit:: @@ -59,14 +64,13 @@ more details. -n:: --no-commit:: - Usually the command automatically creates a commit with - a commit log message stating which commit was - reverted. This flag applies the change necessary - to revert the named commit to your working tree - and the index, but does not make the commit. In addition, - when this option is used, your index does not have to match - the HEAD commit. The revert is done against the - beginning state of your index. + Usually the command automatically creates some commits with + commit log messages stating which commits were reverted. This + flag applies the changes necessary to revert the named commits + to your working tree and the index, but does not make the + commits. In addition, when this option is used, your index + does not have to match the HEAD commit. The revert is done + against the beginning state of your index. + This is useful when reverting more than one commits' effect to your index in a row. @@ -75,6 +79,20 @@ effect to your index in a row. --signoff:: Add Signed-off-by line at the end of the commit message. +Examples +-------- +git revert HEAD~3:: + + Revert the changes specified by the fourth last commit in HEAD + and create a new commit with the reverted changes. + +git revert -n master\~5..master~2:: + + Revert the changes done by commits from the fiveth last commit + in master (included) to the third last commit in master + (included), but do not create any commit with the reverted + changes. The revert only modifies the working tree and the + index. Author ------ -- 1.7.1.361.g42de.dirty