summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLibravatar Uwe Kleine-König <zeisberg@informatik.uni-freiburg.de>2007-01-19 13:43:00 +0100
committerLibravatar Junio C Hamano <junkio@cox.net>2007-01-19 17:54:32 -0800
commit18bd8821cace2f830e34574df6df30e072d0ed40 (patch)
treeb399a325888002df2ee2e74441b1622b0f20daf1
parentDocumentation/git.txt: command re-classification (diff)
downloadtgif-18bd8821cace2f830e34574df6df30e072d0ed40.tar.xz
Update documentation of fetch-pack, push and send-pack
add all supported options to Documentation/git-....txt and the usage strings. Signed-off-by: Uwe Kleine-König <zeisberg@informatik.uni-freiburg.de> Signed-off-by: Junio C Hamano <junkio@cox.net>
-rw-r--r--Documentation/git-fetch-pack.txt21
-rw-r--r--Documentation/git-push.txt2
-rw-r--r--Documentation/git-send-pack.txt15
-rw-r--r--builtin-push.c2
-rw-r--r--fetch-pack.c2
-rw-r--r--send-pack.c4
6 files changed, 33 insertions, 13 deletions
diff --git a/Documentation/git-fetch-pack.txt b/Documentation/git-fetch-pack.txt
index 90ef127d12..bd8ebacd7d 100644
--- a/Documentation/git-fetch-pack.txt
+++ b/Documentation/git-fetch-pack.txt
@@ -8,7 +8,7 @@ git-fetch-pack - Receive missing objects from another repository
SYNOPSIS
--------
-'git-fetch-pack' [-q] [-k] [--exec=<git-upload-pack>] [<host>:]<directory> [<refs>...]
+'git-fetch-pack' [--all] [--quiet|-q] [--keep|-k] [--thin] [--exec=<git-upload-pack>] [--depth=<n>] [-v] [<host>:]<directory> [<refs>...]
DESCRIPTION
-----------
@@ -28,17 +28,24 @@ have a common ancestor commit.
OPTIONS
-------
--q::
+\--all::
+ Fetch all remote refs.
+
+\--quiet, \-q::
Pass '-q' flag to 'git-unpack-objects'; this makes the
cloning process less verbose.
--k::
+\--keep, \-k::
Do not invoke 'git-unpack-objects' on received data, but
create a single packfile out of it instead, and store it
in the object database. If provided twice then the pack is
locked against repacking.
---exec=<git-upload-pack>::
+\--thin::
+ Spend extra cycles to minimize the number of objects to be sent.
+ Use it on slower connection.
+
+\--exec=<git-upload-pack>::
Use this to specify the path to 'git-upload-pack' on the
remote side, if is not found on your $PATH.
Installations of sshd ignores the user's environment
@@ -50,6 +57,12 @@ OPTIONS
shells by having a lean .bashrc file (they set most of
the things up in .bash_profile).
+\--depth=<n>::
+ Limit fetching to ancestor-chains not longer than n.
+
+\-v::
+ Run verbosely.
+
<host>::
A remote host that houses the repository. When this
part is specified, 'git-upload-pack' is invoked via
diff --git a/Documentation/git-push.txt b/Documentation/git-push.txt
index 3e8dbcf93a..7a2e503a4e 100644
--- a/Documentation/git-push.txt
+++ b/Documentation/git-push.txt
@@ -8,7 +8,7 @@ git-push - Update remote refs along with associated objects
SYNOPSIS
--------
-'git-push' [--all] [--tags] [--exec=<receive-pack>] [--repo=all] [-f | --force] [-v] [<repository> <refspec>...]
+'git-push' [--all] [--tags] [--exec=<git-receive-pack>] [--repo=all] [-f | --force] [-v] [<repository> <refspec>...]
DESCRIPTION
-----------
diff --git a/Documentation/git-send-pack.txt b/Documentation/git-send-pack.txt
index eea8fe8af3..dee43a997c 100644
--- a/Documentation/git-send-pack.txt
+++ b/Documentation/git-send-pack.txt
@@ -8,7 +8,7 @@ git-send-pack - Push objects over git protocol to another reposiotory
SYNOPSIS
--------
-'git-send-pack' [--all] [--force] [--exec=<git-receive-pack>] [<host>:]<directory> [<ref>...]
+'git-send-pack' [--all] [--force] [--exec=<git-receive-pack>] [--verbose] [--thin] [<host>:]<directory> [<ref>...]
DESCRIPTION
-----------
@@ -21,23 +21,30 @@ updates it from the current repository, sending named refs.
OPTIONS
-------
---exec=<git-receive-pack>::
+\--exec=<git-receive-pack>::
Path to the 'git-receive-pack' program on the remote
end. Sometimes useful when pushing to a remote
repository over ssh, and you do not have the program in
a directory on the default $PATH.
---all::
+\--all::
Instead of explicitly specifying which refs to update,
update all refs that locally exist.
---force::
+\--force::
Usually, the command refuses to update a remote ref that
is not an ancestor of the local ref used to overwrite it.
This flag disables the check. What this means is that
the remote repository can lose commits; use it with
care.
+\--verbose::
+ Run verbosely.
+
+\--thin::
+ Spend extra cycles to minimize the number of objects to be sent.
+ Use it on slower connection.
+
<host>::
A remote host to house the repository. When this
part is specified, 'git-receive-pack' is invoked via
diff --git a/builtin-push.c b/builtin-push.c
index 7a3d2bb064..ba7981f5bf 100644
--- a/builtin-push.c
+++ b/builtin-push.c
@@ -8,7 +8,7 @@
#define MAX_URI (16)
-static const char push_usage[] = "git-push [--all] [--tags] [-f | --force] <repository> [<refspec>...]";
+static const char push_usage[] = "git-push [--all] [--tags] [--exec=<git-receive-pack>] [--repo=all] [-f | --force] [-v] [<repository> <refspec>...]";
static int all, tags, force, thin = 1, verbose;
static const char *execute;
diff --git a/fetch-pack.c b/fetch-pack.c
index 1530a94794..726140a1a5 100644
--- a/fetch-pack.c
+++ b/fetch-pack.c
@@ -12,7 +12,7 @@ static int verbose;
static int fetch_all;
static int depth;
static const char fetch_pack_usage[] =
-"git-fetch-pack [--all] [-q] [-v] [-k] [--thin] [--exec=upload-pack] [--depth=<n>] [host:]directory <refs>...";
+"git-fetch-pack [--all] [--quiet|-q] [--keep|-k] [--thin] [--exec=<git-upload-pack>] [--depth=<n>] [-v] [<host>:]<directory> [<refs>...]";
static const char *exec = "git-upload-pack";
#define COMPLETE (1U << 0)
diff --git a/send-pack.c b/send-pack.c
index 6756264b29..ec2c1089b2 100644
--- a/send-pack.c
+++ b/send-pack.c
@@ -6,8 +6,8 @@
#include "exec_cmd.h"
static const char send_pack_usage[] =
-"git-send-pack [--all] [--exec=git-receive-pack] <remote> [<head>...]\n"
-" --all and explicit <head> specification are mutually exclusive.";
+"git-send-pack [--all] [--force] [--exec=<git-receive-pack>] [--verbose] [--thin] [<host>:]<directory> [<ref>...]\n"
+" --all and explicit <ref> specification are mutually exclusive.";
static const char *exec = "git-receive-pack";
static int verbose;
static int send_all;