kernel/git - git - PowerEL Git System

Go to file

Thomas Rast d0268de6d7 Documentation: pruning recipe for destructive filter-branch Add a section about how to shrink a repository's size after running git-filter-branch to remove large blobs from history. This comes up every week or so on IRC, and the commands required to handle every case are not very newbie-friendly, so hopefully writing them down somewhere leads to fewer questions. It may seem contradictory to document fallbacks for older Gits in newer docs, but we want to point people at this as a FAQ answer, and they will frequently not have the newest version installed. Thanks to Björn Steinbrink and Junio C Hamano for comments and corrections. Signed-off-by: Thomas Rast <trast@student.ethz.ch> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2009-02-14 21:18:54 -08:00
Documentation	Documentation: pruning recipe for destructive filter-branch	2009-02-14 21:18:54 -08:00
arm	…
compat	Windows: Fix signal numbers	2009-01-21 22:46:52 -08:00
contrib	bash-completion: Complete the values of color.interactive, color.ui, color.pager	2009-02-13 09:55:45 -08:00
git-gui	…
gitk-git	Merge git://git.kernel.org/pub/scm/gitk/gitk	2008-12-21 18:31:12 -08:00
gitweb	Merge branch 'maint'	2009-02-08 22:07:53 -08:00
mozilla-sha1	…
perl	Merge branch 'pb/maint-git-pm-false-dir' into maint	2009-01-23 19:02:41 -08:00
ppc	…
t	symbolic-ref: allow refs/<whatever> in HEAD	2009-02-13 18:20:44 -08:00
templates	…
xdiff	Merge branch 'kc/maint-diff-bwi-fix' into maint	2009-02-05 17:52:22 -08:00
.gitattributes	…
.gitignore	Revert "Merge branch 'js/notes'"	2009-02-10 21:32:10 -08:00
.mailmap	…
COPYING	…
GIT-VERSION-GEN	GIT 1.6.1.3	2009-02-07 00:51:47 -08:00
INSTALL	…
Makefile	Fix the installation path for html documentation	2009-02-10 22:25:54 -08:00
README	README: tutorial.txt is now called gittutorial.txt	2009-01-06 22:12:07 -08:00
RelNotes	Prepare for 1.6.1.4.	2009-02-11 18:44:03 -08:00
abspath.c	…
alias.c	…
alloc.c	…
archive-tar.c	…
archive-zip.c	…
archive.c	tree.c: allow read_tree_recursive() to traverse gitlink entries	2009-02-07 12:14:34 -08:00
archive.h	…
attr.c	…
attr.h	…
base85.c	…
blob.c	…
blob.h	…
branch.c	…
branch.h	…
builtin-add.c	git add: do not add files from a submodule	2009-01-05 10:48:32 -08:00
builtin-annotate.c	…
builtin-apply.c	Merge branch 'jc/maint-apply-fix' into maint	2009-02-05 18:06:11 -08:00
builtin-archive.c	…
builtin-blame.c	builtin-blame.c: Use utf8_strwidth for author's names	2009-02-04 16:30:45 -08:00
builtin-branch.c	Make has_commit() non-static	2009-01-28 11:33:03 -08:00
builtin-bundle.c	…
builtin-cat-file.c	remove trailing LF in die() messages	2009-01-05 13:01:01 -08:00
builtin-check-attr.c	…
builtin-check-ref-format.c	…
builtin-checkout-index.c	…
builtin-checkout.c	Merge branch 'tr/previous-branch'	2009-01-28 15:00:27 -08:00
builtin-clean.c	…
builtin-clone.c	Install the default "master" branch configuration after cloning a void	2009-02-12 22:37:35 -08:00
builtin-commit-tree.c	…
builtin-commit.c	Generalize and libify index_is_dirty() to index_differs_from(...)	2009-02-10 22:25:39 -08:00
builtin-config.c	…
builtin-count-objects.c	add is_dot_or_dotdot inline function	2009-01-11 13:21:57 -08:00
builtin-describe.c	Merge branch 'sp/maint-describe-all-tag-warning' into maint	2008-12-27 14:21:15 -08:00
builtin-diff-files.c	…
builtin-diff-index.c	…
builtin-diff-tree.c	…
builtin-diff.c	…
builtin-fast-export.c	Merge branch 'maint-1.6.0' into maint	2009-02-11 18:32:37 -08:00
builtin-fetch--tool.c	refactor signal handling for cleanup functions	2009-01-21 22:46:53 -08:00
builtin-fetch-pack.c	…
builtin-fetch.c	refactor signal handling for cleanup functions	2009-01-21 22:46:53 -08:00
builtin-fmt-merge-msg.c	…
builtin-for-each-ref.c	…
builtin-fsck.c	fsck: check loose objects from alternate object stores by default	2009-01-30 19:23:22 -08:00
builtin-gc.c	Move run_hook() from builtin-commit.c into run-command.c (libgit)	2009-01-17 17:16:24 -08:00
builtin-grep.c	Merge branch 'maint-1.6.0' into maint	2009-02-03 00:32:29 -08:00
builtin-help.c	Move computation of absolute paths from Makefile to runtime (in preparation for RUNTIME_PREFIX)	2009-01-26 00:26:05 -08:00
builtin-http-fetch.c	…
builtin-init-db.c	remove trailing LF in die() messages	2009-01-05 13:01:01 -08:00
builtin-log.c	Merge branch 'jc/maint-format-patch-o-relative' into maint	2009-01-28 23:56:13 -08:00
builtin-ls-files.c	Let ls-files strip trailing slashes in submodules' paths	2009-02-07 12:49:50 -08:00
builtin-ls-remote.c	…
builtin-ls-tree.c	tree.c: allow read_tree_recursive() to traverse gitlink entries	2009-02-07 12:14:34 -08:00
builtin-mailinfo.c	mailinfo: cleanup extra spaces for complex 'From:'	2009-02-01 12:11:15 -08:00
builtin-mailsplit.c	…
builtin-merge-base.c	…
builtin-merge-file.c	merge-file: handle freopen() failure	2008-12-26 19:10:02 -08:00
builtin-merge-ours.c	…
builtin-merge-recursive.c	remove trailing LF in die() messages	2009-01-05 13:01:01 -08:00
builtin-merge.c	Replace deprecated dashed git commands in usage	2009-02-04 15:08:49 -08:00
builtin-mv.c	builtin-mv.c: check for unversionned files before looking at the destination.	2009-02-04 11:07:42 -08:00
builtin-name-rev.c	…
builtin-pack-objects.c	Merge branch 'lt/maint-wrap-zlib' into maint	2009-02-05 18:01:00 -08:00
builtin-pack-refs.c	…
builtin-prune-packed.c	…
builtin-prune.c	add is_dot_or_dotdot inline function	2009-01-11 13:21:57 -08:00
builtin-push.c	…
builtin-read-tree.c	…
builtin-receive-pack.c	builtin-receive-pack.c: do not initialize statics to 0	2009-02-10 22:27:14 -08:00
builtin-reflog.c	…
builtin-remote.c	remote prune: warn dangling symrefs	2009-02-10 22:26:20 -08:00
builtin-rerere.c	add is_dot_or_dotdot inline function	2009-01-11 13:21:57 -08:00
builtin-reset.c	…
builtin-rev-list.c	rev-list: fix showing distance when using --bisect-all	2009-02-08 12:48:28 -08:00
builtin-rev-parse.c	…
builtin-revert.c	Generalize and libify index_is_dirty() to index_differs_from(...)	2009-02-10 22:25:39 -08:00
builtin-rm.c	…
builtin-send-pack.c	send-pack: do not send unknown object name from ".have" to pack-objects	2009-01-27 23:46:59 -08:00
builtin-shortlog.c	Merge branch 'rs/maint-shortlog-foldline'	2009-01-17 23:05:23 -08:00
builtin-show-branch.c	…
builtin-show-ref.c	…
builtin-stripspace.c	…
builtin-symbolic-ref.c	symbolic-ref: allow refs/<whatever> in HEAD	2009-02-13 18:20:44 -08:00
builtin-tag.c	git-tag: Add --contains option	2009-01-28 11:33:51 -08:00
builtin-tar-tree.c	…
builtin-unpack-objects.c	Merge branch 'lt/maint-wrap-zlib' into maint	2009-02-05 18:01:00 -08:00
builtin-update-index.c	remove trailing LF in die() messages	2009-01-05 13:01:01 -08:00
builtin-update-ref.c	…
builtin-upload-archive.c	…
builtin-verify-pack.c	Replace deprecated dashed git commands in usage	2009-02-04 15:08:49 -08:00
builtin-verify-tag.c	…
builtin-write-tree.c	…
builtin.h	…
bundle.c	Merge branch 'js/maint-all-implies-HEAD'	2009-01-25 17:13:02 -08:00
bundle.h	…
cache-tree.c	…
cache-tree.h	…
cache.h	Revert "Merge branch 'js/notes'"	2009-02-10 21:32:10 -08:00
check-builtins.sh	…
check-racy.c	…
check_bindir	…
color.c	Merge branch 'js/diff-color-words'	2009-01-25 17:13:29 -08:00
color.h	Merge branch 'js/diff-color-words'	2009-01-25 17:13:29 -08:00
combine-diff.c	…
command-list.txt	Revert "Merge branch 'js/notes'"	2009-02-10 21:32:10 -08:00
commit.c	Revert "Merge branch 'js/notes'"	2009-02-10 21:32:10 -08:00
commit.h	Make has_commit() non-static	2009-01-28 11:33:03 -08:00
config.c	Revert "Merge branch 'js/notes'"	2009-02-10 21:32:10 -08:00
config.mak.in	config.mak.in: define paths without trailing slash	2009-02-05 00:29:23 -08:00
configure.ac	Fix naming scheme for configure cache variables.	2009-01-21 00:12:25 -08:00
connect.c	remove trailing LF in die() messages	2009-01-05 13:01:01 -08:00
convert.c	…
copy.c	…
csum-file.c	…
csum-file.h	…
ctype.c	Add is_regex_special()	2009-01-17 18:30:41 -08:00
daemon.c	Add calls to git_extract_argv0_path() in programs that call git_config_*	2009-01-26 00:26:05 -08:00
date.c	…
decorate.c	…
decorate.h	…
delta.h	…
diff-delta.c	…
diff-lib.c	Generalize and libify index_is_dirty() to index_differs_from(...)	2009-02-10 22:25:39 -08:00
diff-no-index.c	Fix 'git diff --no-index' with a non-existing symlink target	2009-01-30 21:11:24 -08:00
diff.c	Remove redundant bit clears from diff_setup()	2009-02-13 18:19:37 -08:00
diff.h	Generalize and libify index_is_dirty() to index_differs_from(...)	2009-02-10 22:25:39 -08:00
diffcore-break.c	…
diffcore-delta.c	…
diffcore-order.c	…
diffcore-pickaxe.c	…
diffcore-rename.c	Rename detection: Avoid repeated filespec population	2009-01-21 00:14:12 -08:00
diffcore.h	…
dir.c	Merge branch 'cb/add-pathspec'	2009-01-25 17:13:11 -08:00
dir.h	Allow cloning to an existing empty directory	2009-01-11 13:26:29 -08:00
editor.c	…
entry.c	Merge branch 'kb/lstat-cache'	2009-01-25 17:13:34 -08:00
environment.c	Revert "Merge branch 'js/notes'"	2009-02-10 21:32:10 -08:00
exec_cmd.c	Compute prefix at runtime if RUNTIME_PREFIX is set	2009-01-26 00:26:05 -08:00
exec_cmd.h	Refactor git_set_argv0_path() to git_extract_argv0_path()	2009-01-26 00:26:05 -08:00
fast-import.c	Drop double-semicolon in C	2009-02-10 22:26:37 -08:00
fetch-pack.h	…
fixup-builtins	…
fsck.c	…
fsck.h	…
generate-cmdlist.sh	…
git-add--interactive.perl	add -p: get rid of Git.pm warnings about unitialized values	2009-02-08 13:06:33 -08:00
git-am.sh	Merge branch 'ns/am-slacker'	2009-02-04 13:07:02 -08:00
git-archimport.perl	…
git-bisect.sh	bisect view: call gitk if Cygwin's SESSIONNAME variable is set	2009-01-03 14:25:27 -08:00
git-compat-util.h	Add is_regex_special()	2009-01-17 18:30:41 -08:00
git-cvsexportcommit.perl	…
git-cvsimport.perl	…
git-cvsserver.perl	git-cvsserver: run post-update hook after update.	2009-01-30 21:11:46 -08:00
git-filter-branch.sh	filter-branch: Add more error-handling	2009-02-11 18:26:52 -08:00
git-instaweb.sh	…
git-lost-found.sh	…
git-merge-octopus.sh	…
git-merge-one-file.sh	…
git-merge-resolve.sh	…
git-mergetool.sh	Merge branch 'cb/mergetool'	2009-02-05 19:40:35 -08:00
git-parse-remote.sh	…
git-pull.sh	…
git-quiltimport.sh	…
git-rebase--interactive.sh	Merge branch 'js/maint-rebase-i-submodule'	2009-01-31 18:07:55 -08:00
git-rebase.sh	rebase: learn to rebase root commit	2009-01-11 23:03:36 -08:00
git-relink.perl	…
git-repack.sh	Make repack less likely to corrupt repository	2009-02-11 18:32:16 -08:00
git-request-pull.sh	…
git-send-email.perl	send-email: futureproof split_addrs() sub	2008-12-21 01:57:59 -08:00
git-sh-setup.sh	git-sh-setup: Fix scripts whose PWD is a symlink to a work-dir on OS X	2009-01-05 11:46:58 -08:00
git-stash.sh	…
git-submodule.sh	submodule: warn about non-submodules	2009-02-07 12:49:58 -08:00
git-svn.perl	git-svn: fix broken symlink workaround when switching branches	2009-02-11 02:02:04 -08:00
git-web--browse.sh	git-web--browse: Fix check for /bin/start	2009-02-09 00:06:36 -08:00
git.c	Merge branch 'jk/maint-cleanup-after-exec-failure'	2009-02-03 00:26:12 -08:00
git.spec.in	Merge branch 'maint-1.6.0' into maint	2009-02-05 19:38:58 -08:00
graph.c	…
graph.h	…
grep.c	Add is_regex_special()	2009-01-17 18:30:41 -08:00
grep.h	grep: don't call regexec() for fixed strings	2009-01-09 21:35:56 -08:00
hash-object.c	Add calls to git_extract_argv0_path() in programs that call git_config_*	2009-01-26 00:26:05 -08:00
hash.c	…
hash.h	…
help.c	…
help.h	…
http-push.c	Merge branch 'rc/http-push'	2009-02-05 19:40:36 -08:00
http-walker.c	Merge branch 'lt/maint-wrap-zlib' into maint	2009-02-05 18:01:00 -08:00
http.c	…
http.h	…
ident.c	…
imap-send.c	Add calls to git_extract_argv0_path() in programs that call git_config_*	2009-01-26 00:26:05 -08:00
index-pack.c	Merge branch 'lt/maint-wrap-zlib' into maint	2009-02-05 18:01:00 -08:00
levenshtein.c	…
levenshtein.h	…
list-objects.c	…
list-objects.h	…
ll-merge.c	…
ll-merge.h	…
lockfile.c	refactor signal handling for cleanup functions	2009-01-21 22:46:53 -08:00
log-tree.c	…
log-tree.h	…
mailmap.c	…
mailmap.h	…
match-trees.c	…
merge-file.c	…
merge-index.c	Replace deprecated dashed git commands in usage	2009-02-04 15:08:49 -08:00
merge-recursive.c	tree.c: allow read_tree_recursive() to traverse gitlink entries	2009-02-07 12:14:34 -08:00
merge-recursive.h	…
merge-tree.c	Replace deprecated dashed git commands in usage	2009-02-04 15:08:49 -08:00
mktag.c	Replace deprecated dashed git commands in usage	2009-02-04 15:08:49 -08:00
mktree.c	Replace deprecated dashed git commands in usage	2009-02-04 15:08:49 -08:00
name-hash.c	…
object.c	bundle: allow the same ref to be given more than once	2009-01-17 23:00:31 -08:00
object.h	Merge branch 'js/maint-all-implies-HEAD' into maint	2009-02-05 17:54:12 -08:00
pack-check.c	…
pack-redundant.c	Add calls to git_extract_argv0_path() in programs that call git_config_*	2009-01-26 00:26:05 -08:00
pack-refs.c	…
pack-refs.h	…
pack-revindex.c	…
pack-revindex.h	…
pack-write.c	…
pack.h	…
pager.c	pager: do wait_for_pager on signal death	2009-01-21 22:46:53 -08:00
parse-options.c	Make opt_parse_with_commit() non-static	2009-01-28 11:32:27 -08:00
parse-options.h	Make opt_parse_with_commit() non-static	2009-01-28 11:32:27 -08:00
patch-delta.c	…
patch-id.c	Replace deprecated dashed git commands in usage	2009-02-04 15:08:49 -08:00
patch-ids.c	…
patch-ids.h	…
path.c	Revert "validate_headref: tighten ref-matching to just branches"	2009-02-12 13:02:09 -08:00
pkt-line.c	…
pkt-line.h	…
preload-index.c	…
pretty.c	Revert "Merge branch 'js/notes'"	2009-02-10 21:32:10 -08:00
progress.c	…
progress.h	…
quote.c	…
quote.h	…
reachable.c	…
reachable.h	…
read-cache.c	add -u: do not fail to resolve a path as deleted	2009-01-28 17:29:33 -08:00
reflog-walk.c	…
reflog-walk.h	…
refs.c	remote prune: warn dangling symrefs	2009-02-10 22:26:20 -08:00
refs.h	remote prune: warn dangling symrefs	2009-02-10 22:26:20 -08:00
remote.c	add is_dot_or_dotdot inline function	2009-01-11 13:21:57 -08:00
remote.h	…
rerere.c	Drop double-semicolon in C	2009-02-10 22:26:37 -08:00
rerere.h	…
revision.c	Merge branch 'maint'	2009-02-11 02:00:22 -08:00
revision.h	…
run-command.c	Merge branch 'jk/maint-cleanup-after-exec-failure'	2009-02-03 00:26:12 -08:00
run-command.h	Merge branch 'jk/maint-cleanup-after-exec-failure'	2009-02-03 00:26:12 -08:00
send-pack.h	…
server-info.c	…
setup.c	Merge branch 'js/maint-1.6.0-path-normalize'	2009-02-10 21:30:52 -08:00
sha1-lookup.c	…
sha1-lookup.h	…
sha1_file.c	Merge branch 'maint'	2009-02-11 18:47:30 -08:00
sha1_name.c	Squelch overzealous "ignoring dangling symref" in an empty repository	2009-02-11 09:22:16 -08:00
shallow.c	…
shell.c	…
shortlog.h	…
show-index.c	…
sideband.c	…
sideband.h	…
sigchain.c	refactor signal handling for cleanup functions	2009-01-21 22:46:53 -08:00
sigchain.h	refactor signal handling for cleanup functions	2009-01-21 22:46:53 -08:00
strbuf.c	strbuf: instate cleanup rule in case of non-memory errors	2009-01-06 22:13:43 -08:00
strbuf.h	…
string-list.c	…
string-list.h	…
symlinks.c	lstat_cache(): introduce clear_lstat_cache() function	2009-01-18 13:58:34 -08:00
tag.c	…
tag.h	…
tar.h	…
test-chmtime.c	…
test-ctype.c	Add is_regex_special()	2009-01-17 18:30:41 -08:00
test-date.c	…
test-delta.c	…
test-dump-cache-tree.c	add test-dump-cache-tree in Makefile	2009-02-03 22:11:44 -08:00
test-genrandom.c	…
test-match-trees.c	…
test-parse-options.c	…
test-path-utils.c	Test and fix normalize_path_copy()	2009-02-07 12:23:30 -08:00
test-sha1.c	…
test-sha1.sh	…
test-sigchain.c	t0005: use SIGTERM for sigchain test	2009-01-30 01:14:26 -08:00
thread-utils.c	…
thread-utils.h	…
trace.c	…
transport.c	add is_dot_or_dotdot inline function	2009-01-11 13:21:57 -08:00
transport.h	…
tree-diff.c	…
tree-walk.c	…
tree-walk.h	…
tree.c	Drop double-semicolon in C	2009-02-10 22:26:37 -08:00
tree.h	…
unpack-file.c	Replace deprecated dashed git commands in usage	2009-02-04 15:08:49 -08:00
unpack-trees.c	Merge branch 'maint'	2009-01-31 17:42:26 -08:00
unpack-trees.h	…
update-server-info.c	Add calls to git_extract_argv0_path() in programs that call git_config_*	2009-01-26 00:26:05 -08:00
upload-pack.c	Replace deprecated dashed git commands in usage	2009-02-04 15:08:49 -08:00
usage.c	…
userdiff.c	Change the spelling of "wordregex".	2009-01-21 23:52:16 -08:00
userdiff.h	color-words: make regex configurable via attributes	2009-01-17 10:44:21 -08:00
utf8.c	utf8: add utf8_strwidth()	2009-02-04 16:30:43 -08:00
utf8.h	utf8: add utf8_strwidth()	2009-02-04 16:30:43 -08:00
var.c	Add calls to git_extract_argv0_path() in programs that call git_config_*	2009-01-26 00:26:05 -08:00
walker.c	Drop double-semicolon in C	2009-02-10 22:26:37 -08:00
walker.h	…
wrapper.c	Wrap inflate and other zlib routines for better error reporting	2009-01-11 02:13:06 -08:00
write_or_die.c	…
ws.c	…
wt-status.c	…
wt-status.h	…
xdiff-interface.c	…
xdiff-interface.h	…

README

////////////////////////////////////////////////////////////////

	GIT - the stupid content tracker

////////////////////////////////////////////////////////////////

"git" can mean anything, depending on your mood.

 - random three-letter combination that is pronounceable, and not
   actually used by any common UNIX command.  The fact that it is a
   mispronunciation of "get" may or may not be relevant.
 - stupid. contemptible and despicable. simple. Take your pick from the
   dictionary of slang.
 - "global information tracker": you're in a good mood, and it actually
   works for you. Angels sing, and a light suddenly fills the room.
 - "goddamn idiotic truckload of sh*t": when it breaks

Git is a fast, scalable, distributed revision control system with an
unusually rich command set that provides both high-level operations
and full access to internals.

Git is an Open Source project covered by the GNU General Public License.
It was originally written by Linus Torvalds with help of a group of
hackers around the net. It is currently maintained by Junio C Hamano.

Please read the file INSTALL for installation instructions.
See Documentation/gittutorial.txt to get started, then see
Documentation/everyday.txt for a useful minimum set of commands,
and "man git-commandname" for documentation of each command.
CVS users may also want to read Documentation/cvs-migration.txt.

Many Git online resources are accessible from http://git.or.cz/
including full documentation and Git related tools.

The user discussion and development of Git take place on the Git
mailing list -- everyone is welcome to post bug reports, feature
requests, comments and patches to git@vger.kernel.org. To subscribe
to the list, send an email with just "subscribe git" in the body to
majordomo@vger.kernel.org. The mailing list archives are available at
http://marc.theaimsgroup.com/?l=git and other archival sites.

The messages titled "A note from the maintainer", "What's in
git.git (stable)" and "What's cooking in git.git (topics)" and
the discussion following them on the mailing list give a good
reference for project status, development direction and
remaining tasks.