diff options
author | Brandon Casey <drafnel@gmail.com> | 2013-02-19 10:14:13 -0800 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2013-02-19 12:36:06 -0800 |
commit | 46fbf7536404257a68fd4ea5d92a3bcb3f7b5848 (patch) | |
tree | 7afe699031d96fe088576dc40b46fd5f95352577 /Documentation | |
parent | a24a41ea9a928ccde2db074ab0835c4817223c9d (diff) | |
download | git-46fbf7536404257a68fd4ea5d92a3bcb3f7b5848.tar.gz git-46fbf7536404257a68fd4ea5d92a3bcb3f7b5848.tar.xz |
Documentation/git-commit.txt: rework the --cleanup section
Signed-off-by: Brandon Casey <drafnel@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/git-commit.txt | 29 |
1 files changed, 19 insertions, 10 deletions
diff --git a/Documentation/git-commit.txt b/Documentation/git-commit.txt index 0eb79ccdb..24a99ccc9 100644 --- a/Documentation/git-commit.txt +++ b/Documentation/git-commit.txt @@ -172,16 +172,25 @@ OPTIONS linkgit:git-commit-tree[1]. --cleanup=<mode>:: - This option sets how the commit message is cleaned up. - The '<mode>' can be one of 'verbatim', 'whitespace', 'strip', - and 'default'. The 'default' mode will strip leading and - trailing empty lines and #commentary from the commit message - only if the message is to be edited. Otherwise only whitespace - removed. The 'verbatim' mode does not change message at all, - 'whitespace' removes just leading/trailing whitespace lines - and 'strip' removes both whitespace and commentary. The default - can be changed by the 'commit.cleanup' configuration variable - (see linkgit:git-config[1]). + This option determines how the supplied commit message should be + cleaned up before committing. The '<mode>' can be `strip`, + `whitespace`, `verbatim`, or `default`. ++ +-- +strip:: + Strip leading and trailing empty lines, trailing whitespace, and + #commentary and collapse consecutive empty lines. +whitespace:: + Same as `strip` except #commentary is not removed. +verbatim:: + Do not change the message at all. +default:: + Same as `strip` if the message is to be edited. + Otherwise `whitespace`. +-- ++ +The default can be changed by the 'commit.cleanup' configuration +variable (see linkgit:git-config[1]). -e:: --edit:: |