From: "W. Trevor King" <wking@tremily.us>
To: Git <git@vger.kernel.org>
Cc: Junio C Hamano <gitster@pobox.com>,
Jonathan Nieder <jrnieder@gmail.com>,
"W. Trevor King" <wking@tremily.us>
Subject: [PATCH v3 4/9] user-manual: Mention 'git remote add' for remote branch config
Date: Sun, 17 Feb 2013 19:15:56 -0500 [thread overview]
Message-ID: <1ef8fd5d7754ef65a9aaf26250b7b9f0488ff59c.1361146398.git.wking@tremily.us> (raw)
In-Reply-To: <cover.1361146398.git.wking@tremily.us>
In-Reply-To: <cover.1361146398.git.wking@tremily.us>
From: "W. Trevor King" <wking@tremily.us>
I hardly ever setup remote.<name>.url using 'git config'. While it
may be instructive to do so, we should also point out 'git remote
add'.
Signed-off-by: W. Trevor King <wking@tremily.us>
---
Documentation/user-manual.txt | 40 +++++++++++++---------------------------
1 file changed, 13 insertions(+), 27 deletions(-)
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index ba06b7e..91f1822 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -2878,48 +2878,34 @@ branch.master.merge=refs/heads/master
If there are other repositories that you also use frequently, you can
create similar configuration options to save typing; for example,
-after
-------------------------------------------------
-$ git config remote.example.url git://example.com/proj.git
+$ git remote add example git://example.com/proj.git
-------------------------------------------------
-then the following two commands will do the same thing:
+adds the following to `.git/config`:
-------------------------------------------------
-$ git fetch git://example.com/proj.git master:refs/remotes/example/master
-$ git fetch example master:refs/remotes/example/master
+[remote "example"]
+ url = git://example.com/proj.git
+ fetch = +refs/heads/*:refs/remotes/example/*
-------------------------------------------------
-Even better, if you add one more option:
-
--------------------------------------------------
-$ git config remote.example.fetch master:refs/remotes/example/master
--------------------------------------------------
+Also note that the above configuration can be performed by directly
+editing the file `.git/config` instead of using linkgit:git-remote[1].
-then the following commands will all do the same thing:
+After configuring the remote, the following two commands will do the
+same thing:
-------------------------------------------------
-$ git fetch git://example.com/proj.git master:refs/remotes/example/master
-$ git fetch example master:refs/remotes/example/master
+$ git fetch git://example.com/proj.git +refs/heads/*:refs/remotes/example/*
+$ git fetch example +refs/heads/*:refs/remotes/example/*
$ git fetch example
-------------------------------------------------
-You can also add a "+" to force the update each time:
-
--------------------------------------------------
-$ git config remote.example.fetch +master:refs/remotes/example/master
--------------------------------------------------
-
-Don't do this unless you're sure you won't mind "git fetch" possibly
-throwing away commits on 'example/master'.
-
-Also note that all of the above configuration can be performed by
-directly editing the file .git/config instead of using
-linkgit:git-config[1].
-
See linkgit:git-config[1] for more details on the configuration
-options mentioned above.
+options mentioned above and linkgit:git-fetch[1] for more details on
+the refspec syntax.
[[git-concepts]]
--
1.8.1.336.g94702dd
next prev parent reply other threads:[~2013-02-18 0:16 UTC|newest]
Thread overview: 97+ messages / expand[flat|nested] mbox.gz Atom feed top
2013-02-08 16:43 [PATCH] user-manual: Rewrite git-gc section for automatic packing W. Trevor King
2013-02-08 17:36 ` Junio C Hamano
2013-02-08 18:35 ` W. Trevor King
2013-02-08 23:04 ` Junio C Hamano
2013-02-08 23:04 ` Junio C Hamano
2013-02-10 15:10 ` [PATCH v2 00/15] User manual updates W. Trevor King
2013-02-10 15:10 ` [PATCH v2 01/15] user-manual: Rewrite git-gc section for automatic packing W. Trevor King
2013-02-10 15:10 ` [PATCH v2 02/15] user-manual: Update for receive.denyCurrentBranch=refuse W. Trevor King
2013-02-10 21:24 ` Junio C Hamano
2013-02-10 21:46 ` W. Trevor King
2013-02-10 22:36 ` Junio C Hamano
2013-02-14 18:57 ` Junio C Hamano
2013-02-17 17:06 ` W. Trevor King
2013-02-18 0:15 ` [PATCH v3 0/9] User manual updates W. Trevor King
2013-02-18 0:15 ` [PATCH v3 1/9] user-manual: Use 'remote add' to setup push URLs W. Trevor King
2013-02-18 1:58 ` Junio C Hamano
2013-02-18 2:15 ` Jonathan Nieder
2013-02-18 0:15 ` [PATCH v3 2/9] user-manual: Reorganize the reroll sections, adding 'git rebase -i' W. Trevor King
2013-02-18 2:23 ` Junio C Hamano
2013-02-18 2:39 ` W. Trevor King
2013-02-18 3:48 ` Junio C Hamano
2013-02-18 0:15 ` [PATCH v3 3/9] user-manual: Give 'git push -f' as an alternative to +master W. Trevor King
2013-02-18 2:24 ` Junio C Hamano
2013-02-18 0:15 ` W. Trevor King [this message]
2013-02-18 2:26 ` [PATCH v3 4/9] user-manual: Mention 'git remote add' for remote branch config Junio C Hamano
2013-02-18 2:41 ` W. Trevor King
2013-02-18 0:15 ` [PATCH v3 5/9] user-manual: Standardize backtick quoting W. Trevor King
2013-02-25 22:53 ` [PATCH v5] " W. Trevor King
2013-02-18 0:15 ` [PATCH v3 6/9] user-manual: Use 'git config --global user.*' for setup W. Trevor King
2013-02-18 2:47 ` Junio C Hamano
2013-02-18 12:12 ` W. Trevor King
2013-02-18 0:15 ` [PATCH v3 7/9] user-manual: Use request-pull to generate "please pull" text W. Trevor King
2013-02-18 2:50 ` Junio C Hamano
2013-02-18 0:16 ` [PATCH v3 8/9] user-manual: Flesh out uncommitted changes and submodule updates W. Trevor King
2013-02-18 2:53 ` Junio C Hamano
2013-02-19 9:35 ` W. Trevor King
2013-02-18 0:16 ` [PATCH v3 9/9] user-manual: Use -o latest.tar.gz to create a gzipped tarball W. Trevor King
2013-02-18 2:58 ` Junio C Hamano
2013-02-18 12:16 ` W. Trevor King
2013-02-18 8:56 ` [PATCH v3 0/9] User manual updates Junio C Hamano
2013-02-18 12:27 ` W. Trevor King
2013-02-18 13:00 ` [PATCH v2 02/15] user-manual: Update for receive.denyCurrentBranch=refuse Drew Northup
2013-02-18 21:26 ` Junio C Hamano
2013-02-10 15:10 ` [PATCH v2 03/15] user-manual: Use 'remote add' to setup push URLs W. Trevor King
2013-02-10 21:33 ` Junio C Hamano
2013-02-10 21:54 ` W. Trevor King
2013-02-10 22:08 ` Jonathan Nieder
2013-02-10 22:19 ` W. Trevor King
2013-02-10 22:45 ` Junio C Hamano
2013-02-10 22:57 ` W. Trevor King
2013-02-10 15:10 ` [PATCH v2 04/15] user-manual: Use git branch --merged W. Trevor King
2013-02-10 21:37 ` Junio C Hamano
2013-02-10 21:56 ` W. Trevor King
2013-02-10 15:10 ` [PATCH v2 05/15] user-manual: Add a few references to 'git rebase -i' W. Trevor King
2013-02-10 21:53 ` Junio C Hamano
2013-02-10 22:00 ` W. Trevor King
2013-02-10 15:10 ` [PATCH v2 06/15] user-manual: Give 'git push -f' as an alternative to +master W. Trevor King
2013-02-10 22:00 ` Junio C Hamano
2013-02-10 22:04 ` W. Trevor King
2013-02-10 23:19 ` Junio C Hamano
2013-02-10 15:10 ` [PATCH v2 07/15] user-manual: Mention 'git remote add' for remote branch config W. Trevor King
2013-02-10 22:08 ` Junio C Hamano
2013-02-10 22:09 ` Junio C Hamano
2013-02-10 22:22 ` W. Trevor King
2013-02-10 15:10 ` [PATCH v2 08/15] user-manual: Standardize backtick quoting W. Trevor King
2013-02-10 15:22 ` W. Trevor King
2013-02-10 15:10 ` [PATCH v2 09/15] user-manual: Use 'git config --global user.*' for setup W. Trevor King
2013-02-10 22:12 ` Junio C Hamano
2013-02-10 22:25 ` W. Trevor King
2013-02-10 22:48 ` Junio C Hamano
2013-02-10 22:52 ` W. Trevor King
2013-02-10 15:10 ` [PATCH v2 10/15] user-manual: Fix 'both: so' -> 'both; so' typo W. Trevor King
2013-02-10 15:10 ` [PATCH v2 11/15] user-manual: Fix 'http' -> 'HTTP' typos W. Trevor King
2013-02-10 15:10 ` [PATCH v2 12/15] user-manual: Use request-pull to generate "please pull" text W. Trevor King
2013-02-10 22:23 ` Junio C Hamano
2013-02-10 22:29 ` W. Trevor King
2013-02-10 15:10 ` [PATCH v2 13/15] user-manual: Fix 'you - Git' -> 'you--Git' typo W. Trevor King
2013-02-10 15:10 ` [PATCH v2 14/15] user-manual: Flesh out uncommitted changes and submodule updates W. Trevor King
2013-02-10 15:10 ` [PATCH v2 15/15] user-manual: Use --format=tar.gz to create a gzipped tarball W. Trevor King
2013-02-10 22:27 ` Junio C Hamano
2013-02-10 22:32 ` W. Trevor King
2013-02-10 22:52 ` Junio C Hamano
2013-02-10 23:01 ` W. Trevor King
2013-02-10 22:31 ` [PATCH v2 00/15] User manual updates Junio C Hamano
2013-02-10 22:36 ` W. Trevor King
2013-02-19 9:34 ` [PATCH v3 0/9] " W. Trevor King
2013-02-19 10:04 ` [PATCH v4 0/3] " W. Trevor King
2013-02-19 10:05 ` [PATCH v4 1/3] user-manual: Reorganize the reroll sections, adding 'git rebase -i' W. Trevor King
2013-02-19 18:47 ` Junio C Hamano
2013-02-19 18:51 ` W. Trevor King
2013-02-19 20:56 ` Junio C Hamano
2013-03-24 12:23 ` [PATCH] user-manual: Fix the interactive rebase example commit range W. Trevor King
2013-03-24 20:00 ` Eric Sunshine
2013-03-24 20:22 ` W. Trevor King
2013-02-19 10:05 ` [PATCH v4 2/3] user-manual: Use request-pull to generate "please pull" text W. Trevor King
2013-02-19 10:05 ` [PATCH v4 3/3] user-manual: Flesh out uncommitted changes and submodule updates W. Trevor King
2013-02-09 1:13 ` [PATCH] user-manual: Rewrite git-gc section for automatic packing Javier Tia
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1ef8fd5d7754ef65a9aaf26250b7b9f0488ff59c.1361146398.git.wking@tremily.us \
--to=wking@tremily.us \
--cc=git@vger.kernel.org \
--cc=gitster@pobox.com \
--cc=jrnieder@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).