diff options
Diffstat (limited to 'man1/git-filter-branch.1')
-rw-r--r-- | man1/git-filter-branch.1 | 12 |
1 files changed, 6 insertions, 6 deletions
diff --git a/man1/git-filter-branch.1 b/man1/git-filter-branch.1 index f998a750a..14eb2d31d 100644 --- a/man1/git-filter-branch.1 +++ b/man1/git-filter-branch.1 @@ -2,12 +2,12 @@ .\" Title: git-filter-branch .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 2024-02-06 +.\" Date: 2024-02-08 .\" Manual: Git Manual -.\" Source: Git 2.43.0.561.g235986be82 +.\" Source: Git 2.43.0.581.g5216f8f5c4 .\" Language: English .\" -.TH "GIT\-FILTER\-BRANCH" "1" "2024\-02\-06" "Git 2\&.43\&.0\&.561\&.g235986" "Git Manual" +.TH "GIT\-FILTER\-BRANCH" "1" "2024\-02\-08" "Git 2\&.43\&.0\&.581\&.g5216f8" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -38,7 +38,7 @@ git-filter-branch \- Rewrite branches [\-\-msg\-filter <command>] [\-\-commit\-filter <command>] [\-\-tag\-name\-filter <command>] [\-\-prune\-empty] [\-\-original <namespace>] [\-d <directory>] [\-f | \-\-force] - [\-\-state\-branch <branch>] [\-\-] [<rev\-list options>\&...] + [\-\-state\-branch <branch>] [\-\-] [<rev\-list\-options>\&...] .fi .sp .SH "WARNING" @@ -46,7 +46,7 @@ git-filter-branch \- Rewrite branches \fIgit filter\-branch\fR has a plethora of pitfalls that can produce non\-obvious manglings of the intended history rewrite (and can leave you with little time to investigate such problems since it has such abysmal performance)\&. These safety and performance issues cannot be backward compatibly fixed and as such, its use is not recommended\&. Please use an alternative history filtering tool such as \m[blue]\fBgit filter\-repo\fR\m[]\&\s-2\u[1]\d\s+2\&. If you still need to use \fIgit filter\-branch\fR, please carefully read the section called \(lqSAFETY\(rq (and the section called \(lqPERFORMANCE\(rq) to learn about the land mines of filter\-branch, and then vigilantly avoid as many of the hazards listed there as reasonably possible\&. .SH "DESCRIPTION" .sp -Lets you rewrite Git revision history by rewriting the branches mentioned in the <rev\-list options>, applying custom filters on each revision\&. Those filters can modify each tree (e\&.g\&. removing a file or running a perl rewrite on all files) or information about each commit\&. Otherwise, all information (including original commit times or merge information) will be preserved\&. +Lets you rewrite Git revision history by rewriting the branches mentioned in the <rev\-list\-options>, applying custom filters on each revision\&. Those filters can modify each tree (e\&.g\&. removing a file or running a perl rewrite on all files) or information about each commit\&. Otherwise, all information (including original commit times or merge information) will be preserved\&. .sp The command will only rewrite the \fIpositive\fR refs mentioned in the command line (e\&.g\&. if you pass \fIa\&.\&.b\fR, only \fIb\fR will be rewritten)\&. If you specify no filters, the commits will be recommitted without any changes, which would normally have no effect\&. Nevertheless, this may be useful in the future for compensating for some Git bugs or such, therefore such a usage is permitted\&. .sp @@ -772,7 +772,7 @@ Someone can do a history rewrite, realize they messed up, restore from the backu .sp -1 .IP \(bu 2.3 .\} -Running git\-filter\-branch with either \-\-tags or \-\-all in your <rev\-list options>\&. In order to retain annotated tags as annotated, you must use \-\-tag\-name\-filter (and must not have restored from refs/original/ in a previously botched rewrite)\&. +Running git\-filter\-branch with either \-\-tags or \-\-all in your <rev\-list\-options>\&. In order to retain annotated tags as annotated, you must use \-\-tag\-name\-filter (and must not have restored from refs/original/ in a previously botched rewrite)\&. .RE .RE .sp |