From 8e031611295a3f0c7ceee1ecc7e915e216009cdb Mon Sep 17 00:00:00 2001 From: Junio C Hamano Date: Tue, 24 Jul 2007 08:10:29 +0000 Subject: [PATCH] Autogenerated manpages for v1.5.3-rc2-37-g1cff --- man1/git-filter-branch.1 | 31 +++++++++++++++++-------------- man1/git-fsck.1 | 4 ++-- man1/git-rev-list.1 | 9 ++++++++- 3 files changed, 27 insertions(+), 17 deletions(-) diff --git a/man1/git-filter-branch.1 b/man1/git-filter-branch.1 index 657999df6..e3859e2a8 100644 --- a/man1/git-filter-branch.1 +++ b/man1/git-filter-branch.1 @@ -2,7 +2,7 @@ .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). .\" Instead of manually editing it, you probably should edit the DocBook XML .\" source for it and then use the DocBook XSL Stylesheets to regenerate it. -.TH "GIT\-FILTER\-BRANCH" "1" "07/19/2007" "Git 1.5.3.rc2.19.gc4fba" "Git Manual" +.TH "GIT\-FILTER\-BRANCH" "1" "07/24/2007" "Git 1.5.3.rc2.37.g1cff" "Git Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -16,16 +16,16 @@ git\-filter\-branch \- Rewrite branches [\-\-index\-filter ] [\-\-parent\-filter ] [\-\-msg\-filter ] [\-\-commit\-filter ] [\-\-tag\-name\-filter ] [\-\-subdirectory\-filter ] - [\-d ] [\&...] + [\-d ] [\-f | \-\-force] [\&...] .fi .SH "DESCRIPTION" Lets you rewrite git revision history by creating a new branch from your current branch, 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. -The command takes the new branch name as a mandatory argument and the filters as optional arguments. If you specify no filters, the commits will be recommitted without any changes, which would normally have no effect and result in the new branch pointing to the same branch as your current branch. Nevertheless, this may be useful in the future for compensating for some git bugs or such, therefore such a usage is permitted. +The command takes the new branch name as a mandatory argument and the filters as optional arguments. 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. \fBWARNING\fR! The rewritten history will have different object names for all the objects and will not converge with the original branch. You will not be able to easily push and distribute the rewritten branch on top of the original branch. Please do not use this command if you do not know the full implications, and avoid using it anyway, if a simple single commit would suffice to fix your problem. -Always verify that the rewritten version is correct before disposing the original branch. +Always verify that the rewritten version is correct: The original refs, if different from the rewritten ones, will be stored in the namespace \fIrefs/original/\fR. Note that since this operation is extensively I/O expensive, it might be a good idea to redirect the temporary directory off\-disk, e.g. on tmpfs. Reportedly the speedup is very noticeable. .SS "Filters" @@ -67,6 +67,9 @@ Only look at the history which touches the given subdirectory. The result will c \-d Use this option to set the path to the temporary directory used for rewriting. When applying a tree filter, the command needs to temporary checkout the tree to some directory, which may consume considerable space in case of large projects. By default it does this in the \fI.git\-rewrite/\fR directory but you can override that choice by this parameter. .TP +\-f\\|\-\-force +git filter\-branch refuses to start with an existing temporary directory or when there are already refs starting with \fIrefs/original/\fR, unless forced. +.TP When options are given after the new branch name, they will be passed to \fBgit\-rev\-list\fR(1). Only commits in the resulting output will be filtered, although the filtered commits can still reference parents which are outside of that set. .SH "EXAMPLES" @@ -74,7 +77,7 @@ Suppose you want to remove a file (containing confidential information or copyri .sp .nf .ft C -git filter\-branch \-\-tree\-filter 'rm filename' newbranch +git filter\-branch \-\-tree\-filter 'rm filename' HEAD .ft .fi @@ -82,7 +85,7 @@ A significantly faster version: .sp .nf .ft C -git filter\-branch \-\-index\-filter 'git update\-index \-\-remove filename' newbranch +git filter\-branch \-\-index\-filter 'git update\-index \-\-remove filename' HEAD .ft .fi @@ -92,7 +95,7 @@ To set a commit (which typically is at the tip of another history) to be the par .sp .nf .ft C -git filter\-branch \-\-parent\-filter 'sed "s/^\\$/\-p /"' newbranch +git filter\-branch \-\-parent\-filter 'sed "s/^\\$/\-p /"' HEAD .ft .fi @@ -101,7 +104,7 @@ git filter\-branch \-\-parent\-filter 'sed "s/^\\$/\-p /"' newbranch .nf .ft C git filter\-branch \-\-parent\-filter \\ - 'cat; test $GIT_COMMIT = && echo "\-p "' newbranch + 'cat; test $GIT_COMMIT = && echo "\-p "' HEAD .ft .fi @@ -110,7 +113,7 @@ or even simpler: .nf .ft C echo "$commit\-id $graft\-id" >> .git/info/grafts -git filter\-branch newbranch $graft\-id.. +git filter\-branch $graft\-id..HEAD .ft .fi @@ -130,7 +133,7 @@ git filter\-branch \-\-commit\-filter ' done; else git commit\-tree "$@"; - fi' newbranch + fi' HEAD .ft .fi @@ -154,7 +157,7 @@ To rewrite only commits D,E,F,G,H, but leave A, B and C alone, use: .sp .nf .ft C -git filter\-branch ... new\-H C..H +git filter\-branch ... C..H .ft .fi @@ -162,8 +165,8 @@ To rewrite commits E,F,G,H, use one of these: .sp .nf .ft C -git filter\-branch ... new\-H C..H \-\-not D -git filter\-branch ... new\-H D..H \-\-not C +git filter\-branch ... C..H \-\-not D +git filter\-branch ... D..H \-\-not C .ft .fi @@ -175,7 +178,7 @@ git filter\-branch \-\-index\-filter \\ 'git ls\-files \-s | sed "s\-\\t\-&newsubdir/\-" | GIT_INDEX_FILE=$GIT_INDEX_FILE.new \\ git update\-index \-\-index\-info && - mv $GIT_INDEX_FILE.new $GIT_INDEX_FILE' directorymoved + mv $GIT_INDEX_FILE.new $GIT_INDEX_FILE' HEAD .ft .fi diff --git a/man1/git-fsck.1 b/man1/git-fsck.1 index c9e79a147..81536ec15 100644 --- a/man1/git-fsck.1 +++ b/man1/git-fsck.1 @@ -2,7 +2,7 @@ .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). .\" Instead of manually editing it, you probably should edit the DocBook XML .\" source for it and then use the DocBook XSL Stylesheets to regenerate it. -.TH "GIT\-FSCK" "1" "07/19/2007" "Git 1.5.3.rc2.19.gc4fba" "Git Manual" +.TH "GIT\-FSCK" "1" "07/24/2007" "Git 1.5.3.rc2.37.g1cff" "Git Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -49,7 +49,7 @@ Enable more strict checking, namely to catch a file mode recorded with g+w bit s Be chatty. .TP \-\-lost\-found -Write dangling refs into .git/lost\-found/commit/ or .git/lost\-found/other/, depending on type. +Write dangling objects into .git/lost\-found/commit/ or .git/lost\-found/other/, depending on type. If the object is a blob, the contents are written into the file, rather than its object name. It tests SHA1 and general object sanity, and it does full tracking of the resulting reachability and everything else. It prints out any corruption it finds (missing or bad objects), and if you use the \fI\-\-unreachable\fR flag it will also print out objects that exist but that aren't readable from any of the specified head nodes. diff --git a/man1/git-rev-list.1 b/man1/git-rev-list.1 index 1a71ae05b..c4bb30d92 100644 --- a/man1/git-rev-list.1 +++ b/man1/git-rev-list.1 @@ -2,7 +2,7 @@ .\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). .\" Instead of manually editing it, you probably should edit the DocBook XML .\" source for it and then use the DocBook XSL Stylesheets to regenerate it. -.TH "GIT\-REV\-LIST" "1" "07/22/2007" "Git 1.5.3.rc2.29.gc4640" "Git Manual" +.TH "GIT\-REV\-LIST" "1" "07/24/2007" "Git 1.5.3.rc2.37.g1cff" "Git Manual" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -40,6 +40,7 @@ git\-rev\-list \- Lists commit objects in reverse chronological order [ \-\-merge ] [ \-\-reverse ] [ \-\-walk\-reflogs ] + [ \-\-no\-walk ] [ \-\-do\-walk ] \&... [ \-\- \&... ] .fi .SH "DESCRIPTION" @@ -269,6 +270,12 @@ Similar to \fI\-\-objects\fR, but also print the IDs of excluded commits prefixe .TP \-\-unpacked Only useful with \fI\-\-objects\fR; print the object IDs that are not in packs. +.TP +\-\-no\-walk +Only show the given revs, but do not traverse their ancestors. +.TP +\-\-do\-walk +Overrides a previous \-\-no\-walk. .SH "PRETTY FORMATS" If the commit is a merge, and if the pretty\-format is not \fIoneline\fR, \fIemail\fR or \fIraw\fR, an additional line is inserted before the \fIAuthor:\fR line. This line begins with "Merge: " and the sha1s of ancestral commits are printed, separated by spaces. Note that the listed commits may not necessarily be the list of the \fBdirect\fR parent commits if you have limited your view of history: for example, if you are only interested in changes related to a certain directory or file. -- 2.26.2