X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=Documentation%2Fgit-remote.txt;h=bb99810ec76f93ff1cdc59aacdf592c64419701a;hb=19a31f9c1a6b18abd8a7f20d616516afca36a6a3;hp=2cbd1f764b7d4d8e8c026f50b727c6cc70f5158e;hpb=dfb9a34ababeee98a9f241636c1fe6e98c754f7a;p=git.git diff --git a/Documentation/git-remote.txt b/Documentation/git-remote.txt index 2cbd1f764..bb99810ec 100644 --- a/Documentation/git-remote.txt +++ b/Documentation/git-remote.txt @@ -9,12 +9,12 @@ git-remote - manage set of tracked repositories SYNOPSIS -------- [verse] -'git-remote' -'git-remote' add [-t ] [-m ] [-f] [--mirror] -'git-remote' rm -'git-remote' show -'git-remote' prune -'git-remote' update [group] +'git remote' [-v | --verbose] +'git remote add' [-t ] [-m ] [-f] [--mirror] +'git remote rm' +'git remote show' [-n] +'git remote prune' [-n | --dry-run] +'git remote update' [group] DESCRIPTION ----------- @@ -22,6 +22,14 @@ DESCRIPTION Manage the set of repositories ("remotes") whose branches you track. +OPTIONS +------- + +-v:: +--verbose:: + Be a little more verbose and show remote url after name. + + COMMANDS -------- @@ -47,9 +55,11 @@ With `-m ` option, `$GIT_DIR/remotes//HEAD` is set up to point at remote's `` branch instead of whatever branch the `HEAD` at the remote repository actually points at. + -In mirror mode, enabled with `--mirror`, the refs will not be stored +In mirror mode, enabled with `\--mirror`, the refs will not be stored in the 'refs/remotes/' namespace, but in 'refs/heads/'. This option -only makes sense in bare repositories. +only makes sense in bare repositories. If a remote uses mirror +mode, furthermore, `git push` will always behave as if `\--mirror` +was passed. 'rm':: @@ -70,9 +80,8 @@ These stale branches have already been removed from the remote repository referenced by , but are still locally available in "remotes/". + -With `-n` option, the remote heads are not confirmed first with `git -ls-remote `; cached information is used instead. Use with -caution. +With `--dry-run` option, report what branches will be pruned, but do no +actually prune them. 'update':: @@ -115,7 +124,7 @@ $ git checkout -b nfs linux-nfs/master ... ------------ -* Imitate 'git clone' but track only selected branches +* Imitate 'git-clone' but track only selected branches + ------------ $ mkdir project.git @@ -126,7 +135,7 @@ $ git merge origin ------------ -See Also +SEE ALSO -------- linkgit:git-fetch[1] linkgit:git-branch[1] @@ -144,4 +153,4 @@ Documentation by J. Bruce Fields and the git-list . GIT --- -Part of the linkgit:git[7] suite +Part of the linkgit:git[1] suite