so that linkgit:git-pull[1] will appropriately merge from that
remote branch. Note that even if this option is not set,
this behavior can be chosen per-branch using the `--track`
- and `--no-track` options. This option defaults to false.
+ and `--no-track` options. This option defaults to true.
branch.<name>.remote::
When in branch <name>, it tells `git fetch` which remote to fetch.
<p>Note that this will create the new branch, but it will not switch the\r
working tree to it; use "git checkout <newbranch>" to switch to the\r
new branch.</p>\r
-<p>When a local branch is started off a remote branch, git can setup the\r
+<p>When a local branch is started off a remote branch, git sets up the\r
branch so that <a href="git-pull.html">git-pull(1)</a> will appropriately merge from that\r
-remote branch. If this behavior is desired, it is possible to make it\r
-the default using the global <tt>branch.autosetupmerge</tt> configuration\r
-flag. Otherwise, it can be chosen per-branch using the <tt>--track</tt>\r
+remote branch. If this behavior is not desired, it is possible to\r
+disable it using the global <tt>branch.autosetupmerge</tt> configuration\r
+flag. That setting can be overridden by using the <tt>--track</tt>\r
and <tt>--no-track</tt> options.</p>\r
<p>With a <em>-m</em> or <em>-M</em> option, <oldbranch> will be renamed to <newbranch>.\r
If <oldbranch> had a corresponding reflog, it is renamed to match\r
Set up configuration so that git-pull will automatically\r
retrieve data from the remote branch. Use this if you always\r
pull from the same remote branch into the new branch, or if you\r
- don't want to use "git pull <repository> <refspec>" explicitly. Set the\r
- branch.autosetupmerge configuration variable to true if you\r
+ don't want to use "git pull <repository> <refspec>" explicitly.\r
+ This behavior is the default. Set the\r
+ branch.autosetupmerge configuration variable to false if you\r
want git-checkout and git-branch to always behave as if\r
- <em>--track</em> were given.\r
+ <em>--no-track</em> were given.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 07-Jan-2008 07:50:03 UTC\r
+Last updated 12-Feb-2008 03:18:04 UTC\r
</div>\r
</div>\r
</body>\r
working tree to it; use "git checkout <newbranch>" to switch to the
new branch.
-When a local branch is started off a remote branch, git can setup the
+When a local branch is started off a remote branch, git sets up the
branch so that linkgit:git-pull[1] will appropriately merge from that
-remote branch. If this behavior is desired, it is possible to make it
-the default using the global `branch.autosetupmerge` configuration
-flag. Otherwise, it can be chosen per-branch using the `--track`
+remote branch. If this behavior is not desired, it is possible to
+disable it using the global `branch.autosetupmerge` configuration
+flag. That setting can be overridden by using the `--track`
and `--no-track` options.
With a '-m' or '-M' option, <oldbranch> will be renamed to <newbranch>.
Set up configuration so that git-pull will automatically
retrieve data from the remote branch. Use this if you always
pull from the same remote branch into the new branch, or if you
- don't want to use "git pull <repository> <refspec>" explicitly. Set the
- branch.autosetupmerge configuration variable to true if you
+ don't want to use "git pull <repository> <refspec>" explicitly.
+ This behavior is the default. Set the
+ branch.autosetupmerge configuration variable to false if you
want git-checkout and git-branch to always behave as if
- '--track' were given.
+ '--no-track' were given.
--no-track::
When a branch is created off a remote branch,
set up configuration so that git-pull will automatically\r
retrieve data from the remote branch. Use this if you always\r
pull from the same remote branch into the new branch, or if you\r
- don't want to use "git pull <repository> <refspec>" explicitly. Set the\r
- branch.autosetupmerge configuration variable to true if you\r
+ don't want to use "git pull <repository> <refspec>" explicitly.\r
+ This behavior is the default. Set the\r
+ branch.autosetupmerge configuration variable to false if you\r
want git-checkout and git-branch to always behave as if\r
- <em>--track</em> were given.\r
+ <em>--no-track</em> were given.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 07-Jan-2008 07:50:05 UTC\r
+Last updated 12-Feb-2008 03:18:04 UTC\r
</div>\r
</div>\r
</body>\r
set up configuration so that git-pull will automatically
retrieve data from the remote branch. Use this if you always
pull from the same remote branch into the new branch, or if you
- don't want to use "git pull <repository> <refspec>" explicitly. Set the
- branch.autosetupmerge configuration variable to true if you
+ don't want to use "git pull <repository> <refspec>" explicitly.
+ This behavior is the default. Set the
+ branch.autosetupmerge configuration variable to false if you
want git-checkout and git-branch to always behave as if
- '--track' were given.
+ '--no-track' were given.
--no-track::
When -b is given and a branch is created off a remote branch,
so that <a href="git-pull.html">git-pull(1)</a> will appropriately merge from that\r
remote branch. Note that even if this option is not set,\r
this behavior can be chosen per-branch using the <tt>--track</tt>\r
- and <tt>--no-track</tt> options. This option defaults to false.\r
+ and <tt>--no-track</tt> options. This option defaults to true.\r
</p>\r
</dd>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 10-Feb-2008 10:47:42 UTC\r
+Last updated 12-Feb-2008 03:18:05 UTC\r
</div>\r
</div>\r
</body>\r
be printed to standard out.\r
</p>\r
</dd>\r
+<dt>\r
+--match <pattern>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Only consider tags matching the given pattern (can be used to avoid\r
+ leaking private tags made from the repository).\r
+</p>\r
+</dd>\r
</dl>\r
</div>\r
<h2>EXAMPLES</h2>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 07-Jan-2008 07:50:12 UTC\r
+Last updated 12-Feb-2008 03:18:05 UTC\r
</div>\r
</div>\r
</body>\r
being employed to standard error. The tag name will still
be printed to standard out.
+--match <pattern>::
+ Only consider tags matching the given pattern (can be used to avoid
+ leaking private tags made from the repository).
+
EXAMPLES
--------
was rebased since last fetched, the rebase uses that information\r
to avoid rebasing non-local changes.\r
</p>\r
-<div class="literalblock">\r
-<div class="content">\r
-<pre><tt>*NOTE:* This is a potentially _dangerous_ mode of operation.\r
+<p><strong>NOTE:</strong> This is a potentially _dangerous_ mode of operation.\r
It rewrites history, which does not bode well when you\r
-published that history already. Do *not* use this option\r
-unless you have read linkgit:git-rebase[1] carefully.</tt></pre>\r
-</div></div>\r
+published that history already. Do <strong>not</strong> use this option\r
+unless you have read <a href="git-rebase.html">git-rebase(1)</a> carefully.</p>\r
</dd>\r
<dt>\r
--no-rebase\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 27-Jan-2008 08:23:28 UTC\r
+Last updated 12-Feb-2008 03:18:05 UTC\r
</div>\r
</div>\r
</body>\r
there is a remote ref for the upstream branch, and this branch
was rebased since last fetched, the rebase uses that information
to avoid rebasing non-local changes.
-
- *NOTE:* This is a potentially _dangerous_ mode of operation.
- It rewrites history, which does not bode well when you
- published that history already. Do *not* use this option
- unless you have read linkgit:git-rebase[1] carefully.
++
+*NOTE:* This is a potentially _dangerous_ mode of operation.
+It rewrites history, which does not bode well when you
+published that history already. Do *not* use this option
+unless you have read linkgit:git-rebase[1] carefully.
\--no-rebase::
Override earlier \--rebase.
</p>\r
</dd>\r
<dt>\r
---smtp-user, --smtp-pass\r
+--smtp-user\r
</dt>\r
<dd>\r
<p>\r
- Username and password for SMTP-AUTH. Defaults are the values of\r
- the configuration values <em>sendemail.smtpuser</em> and\r
- <em>sendemail.smtppass</em>, but see also <em>sendemail.identity</em>.\r
- If not set, authentication is not attempted.\r
+ Username for SMTP-AUTH. In place of this option, the following\r
+ configuration variables can be specified:\r
</p>\r
+<ul>\r
+<li>\r
+<p>\r
+sendemail.smtpuser\r
+</p>\r
+</li>\r
+<li>\r
+<p>\r
+sendemail.<identity>.smtpuser (see sendemail.identity).\r
+</p>\r
+</li>\r
+</ul>\r
+<p>However, --smtp-user always overrides these variables.</p>\r
+<p>If a username is not specified (with --smtp-user or a\r
+configuration variable), then authentication is not attempted.</p>\r
+</dd>\r
+<dt>\r
+--smtp-pass\r
+</dt>\r
+<dd>\r
+<p>\r
+ Password for SMTP-AUTH. The argument is optional: If no\r
+ argument is specified, then the empty string is used as\r
+ the password.\r
+</p>\r
+<p>In place of this option, the following configuration variables\r
+can be specified:</p>\r
+<ul>\r
+<li>\r
+<p>\r
+sendemail.smtppass\r
+</p>\r
+</li>\r
+<li>\r
+<p>\r
+sendemail.<identity>.smtppass (see sendemail.identity).\r
+</p>\r
+</li>\r
+</ul>\r
+<p>However, --smtp-pass always overrides these variables.</p>\r
+<p>Furthermore, passwords need not be specified in configuration files\r
+or on the command line. If a username has been specified (with\r
+--smtp-user or a configuration variable), but no password has been\r
+specified (with --smtp-pass or a configuration variable), then the\r
+user is prompted for a password while the input is masked for privacy.</p>\r
</dd>\r
<dt>\r
--smtp-ssl\r
</p>\r
</dd>\r
<dt>\r
+--suppress-cc\r
+</dt>\r
+<dd>\r
+<p>\r
+ Specify an additional category of recipients to suppress the\r
+ auto-cc of. <em>self</em> will avoid including the sender, <em>author</em> will\r
+ avoid including the patch author, <em>cc</em> will avoid including anyone\r
+ mentioned in Cc lines in the patch, <em>sob</em> will avoid including\r
+ anyone mentioned in Signed-off-by lines, and <em>cccmd</em> will avoid\r
+ running the --cc-cmd. <em>all</em> will suppress all auto cc values.\r
+ Default is the value of <em>sendemail.suppresscc</em> configuration value;\r
+ if that is unspecified, default to <em>self</em> if --suppress-from is\r
+ specified, as well as <em>sob</em> if --no-signed-off-cc is specified.\r
+</p>\r
+</dd>\r
+<dt>\r
--thread, --no-thread\r
</dt>\r
<dd>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 27-Jan-2008 08:23:29 UTC\r
+Last updated 12-Feb-2008 03:18:06 UTC\r
</div>\r
</div>\r
</body>\r
servers typically listen to smtp port 25 and ssmtp port
465).
---smtp-user, --smtp-pass::
- Username and password for SMTP-AUTH. Defaults are the values of
- the configuration values 'sendemail.smtpuser' and
- 'sendemail.smtppass', but see also 'sendemail.identity'.
- If not set, authentication is not attempted.
+--smtp-user::
+ Username for SMTP-AUTH. In place of this option, the following
+ configuration variables can be specified:
++
+--
+ * sendemail.smtpuser
+ * sendemail.<identity>.smtpuser (see sendemail.identity).
+--
++
+However, --smtp-user always overrides these variables.
++
+If a username is not specified (with --smtp-user or a
+configuration variable), then authentication is not attempted.
+
+--smtp-pass::
+ Password for SMTP-AUTH. The argument is optional: If no
+ argument is specified, then the empty string is used as
+ the password.
++
+In place of this option, the following configuration variables
+can be specified:
++
+--
+ * sendemail.smtppass
+ * sendemail.<identity>.smtppass (see sendemail.identity).
+--
++
+However, --smtp-pass always overrides these variables.
++
+Furthermore, passwords need not be specified in configuration files
+or on the command line. If a username has been specified (with
+--smtp-user or a configuration variable), but no password has been
+specified (with --smtp-pass or a configuration variable), then the
+user is prompted for a password while the input is masked for privacy.
--smtp-ssl::
If set, connects to the SMTP server using SSL.
Default is the value of 'sendemail.suppressfrom' configuration value;
if that is unspecified, default to --no-suppress-from.
+--suppress-cc::
+ Specify an additional category of recipients to suppress the
+ auto-cc of. 'self' will avoid including the sender, 'author' will
+ avoid including the patch author, 'cc' will avoid including anyone
+ mentioned in Cc lines in the patch, 'sob' will avoid including
+ anyone mentioned in Signed-off-by lines, and 'cccmd' will avoid
+ running the --cc-cmd. 'all' will suppress all auto cc values.
+ Default is the value of 'sendemail.suppresscc' configuration value;
+ if that is unspecified, default to 'self' if --suppress-from is
+ specified, as well as 'sob' if --no-signed-off-cc is specified.
+
--thread, --no-thread::
If this is set, the In-Reply-To header will be set on each email sent.
If disabled with "--no-thread", no emails will have the In-Reply-To
</dl>\r
<p>Any other arguments are passed directly to `git log'</p>\r
</dd>\r
+<dt>\r
+<em>blame</em>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Show what revision and author last modified each line of a file. This is\r
+ identical to `git blame', but SVN revision numbers are shown instead of git\r
+ commit hashes.\r
+</p>\r
+<p>All arguments are passed directly to `git blame'.</p>\r
+</dd>\r
</dl>\r
<dl>\r
<dt>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 27-Jan-2008 08:23:29 UTC\r
+Last updated 12-Feb-2008 03:18:07 UTC\r
</div>\r
</div>\r
</body>\r
+
Any other arguments are passed directly to `git log'
+'blame'::
+ Show what revision and author last modified each line of a file. This is
+ identical to `git blame', but SVN revision numbers are shown instead of git
+ commit hashes.
++
+All arguments are passed directly to `git blame'.
+
--
'find-rev'::
When given an SVN revision number of the form 'rN', returns the