summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorJunio C Hamano <junkio@cox.net>2005-05-06 06:50:22 (GMT)
committerJunio C Hamano <junkio@cox.net>2005-05-06 06:50:22 (GMT)
commit4df1e7950787197f7cad081b98f9ffe6c4089fc9 (patch)
treed565757418d5760f16ef45c1925b74bca57611a8 /Documentation
parentac4e0869294cd03b9320de3b2d851f2a3980d927 (diff)
downloadgit-4df1e7950787197f7cad081b98f9ffe6c4089fc9.zip
git-4df1e7950787197f7cad081b98f9ffe6c4089fc9.tar.gz
git-4df1e7950787197f7cad081b98f9ffe6c4089fc9.tar.bz2
Add documentation for the rest of commands.
This adds descriptions for the core GIT commands that were not mentioned in the previous version. Signed-off-by: Junio C Hamano <junkio@cox.net>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/core-git.txt104
1 files changed, 104 insertions, 0 deletions
diff --git a/Documentation/core-git.txt b/Documentation/core-git.txt
index d979a66..36f5a9d 100644
--- a/Documentation/core-git.txt
+++ b/Documentation/core-git.txt
@@ -41,6 +41,14 @@ Identifier terminology used:
################################################################
+git-apply-patch-script
+
+This is a sample script to be used as GIT_EXTERNAL_DIFF to apply
+differences git-diff-* family of commands reports to the current
+work tree.
+
+
+################################################################
git-cat-file
git-cat-file (-t | <type>) <object>
@@ -226,6 +234,12 @@ see also: git-write-tree
################################################################
+git-convert-cache
+
+Converts old-style GIT repository to the latest.
+
+
+################################################################
git-diff-cache
git-diff-cache [-p] [-r] [-z] [--cached] <tree-ish>
@@ -335,6 +349,7 @@ which file is in which state, since the "has been updated" ones show a
valid sha1, and the "not in sync with the index" ones will always have the
special all-zero sha1.
+
################################################################
git-diff-tree
git-diff-tree [-p] [-r] [-z] <tree-ish> <tree-ish> [<pattern>]*
@@ -409,6 +424,7 @@ this one:
in case you care).
+
################################################################
git-diff-tree-helper
git-diff-tree-helper [-z] [-R]
@@ -431,6 +447,7 @@ generates patch format output.
See also the section on generating patches.
+
################################################################
git-fsck-cache
git-fsck-cache [--tags] [--root] [[--unreachable] [--cache] <object>*]
@@ -525,6 +542,7 @@ SHA1_FILE_DIRECTORY
GIT_INDEX_FILE
used to specify the cache
+
################################################################
git-export
git-export top [base]
@@ -548,6 +566,18 @@ git-init-db won't hurt an existing repository.
################################################################
+git-http-pull
+
+Downloads a remote GIT repository via HTTP protocol.
+
+
+################################################################
+git-local-pull
+
+Downloads another GIT repository on a local system.
+
+
+################################################################
git-ls-tree
git-ls-tree [-r] [-z] <tree-ish>
@@ -630,6 +660,33 @@ merge once anything has returned an error (ie "cat" returned an error
for the AA file, because it didn't exist in the original, and thus
"git-merge-cache" didn't even try to merge the MM thing).
+################################################################
+git-merge-one-file-script
+
+This is the standard helper program to use with git-merge-cache
+to resolve a merge after the trivial merge done with git-read-tree -m.
+
+################################################################
+git-mktag
+
+Reads a tag contents from its standard input and creates a tag object.
+The input must be a well formed tag object.
+
+
+################################################################
+git-prune-script
+
+This runs git-fsck-cache --unreachable program using the heads specified
+on the command line (or .git/refs/heads/* and .git/refs/tags/* if none is
+specified), and prunes all unreachable objects from the object database.
+
+
+################################################################
+git-pull-script
+
+This script is used by Linus to pull from a remote repository and perform
+a merge.
+
################################################################
git-read-tree
@@ -754,6 +811,12 @@ git-ls-files
################################################################
+git-resolve-script
+
+This script is used by Linus to merge two trees.
+
+
+################################################################
git-rev-list <commit>
Lists commit objects in reverse chronological order starting at the
@@ -823,6 +886,19 @@ think.)
################################################################
+git-rpull
+
+Pulls from a remote repository over ssh connection, invoking git-rpush on
+the other end.
+
+
+################################################################
+git-rpush
+
+Helper "server-side" program used by git-rpull.
+
+
+################################################################
git-diff-files
git-diff-files [-p] [-q] [-r] [-z] [<pattern>...]
@@ -850,6 +926,23 @@ section.
################################################################
+git-tag-script
+
+This is an example script that uses git-mktag to create a tag object
+signed with GPG.
+
+
+################################################################
+git-tar-tree
+
+ git-tar-tree <tree-ish> [ <base> ]
+
+Creates a tar archive containing the tree structure for the named tree.
+When <base> is specified it is added as a leading path as the files in the
+generated tar archive.
+
+
+################################################################
git-ls-files
git-ls-files [-z] [-t]
(--[cached|deleted|others|ignored|stage|unmerged])*
@@ -1001,6 +1094,17 @@ To update and refresh only the files already checked out:
################################################################
+git-write-blob
+
+ git-write-blob <any-file-on-the-filesystem>
+
+Writes the contents of the named file (which can be outside of the work
+tree) as a blob into the object database, and reports its object ID to its
+standard output. This is used by git-merge-one-file-script to update the
+cache without modifying files in the work tree.
+
+
+################################################################
git-write-tree
git-write-tree