<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>send — Bazaar 2.6.0 documentation</title>
<link rel="stylesheet" href="../_static/default.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../',
VERSION: '2.6.0',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<link rel="shortcut icon" href="../_static/bzr.ico"/>
<link rel="top" title="Bazaar 2.6.0 documentation" href="../index.html" />
<link rel="up" title="Bazaar User Reference" href="index.html" />
<link rel="next" title="serve" href="serve-help.html" />
<link rel="prev" title="root" href="root-help.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="serve-help.html" title="serve"
accesskey="N">next</a></li>
<li class="right" >
<a href="root-help.html" title="root"
accesskey="P">previous</a> |</li>
<li><a href="http://bazaar.canonical.com/">
<img src="../_static/bzr icon 16.png" /> Home</a> | </li>
<a href="http://doc.bazaar.canonical.com/en/">Documentation</a> | </li>
<li><a href="../index.html">Table of Contents (2.6.0)</a> »</li>
<li><a href="index.html" accesskey="U">Bazaar User Reference</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="send">
<h1>send<a class="headerlink" href="#send" title="Permalink to this headline">ΒΆ</a></h1>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name">Purpose:</th><td class="field-body"><p class="first">Mail or create a merge-directive for submitting changes.</p>
</td>
</tr>
<tr class="field-even field"><th class="field-name">Usage:</th><td class="field-body"><p class="first">bzr send [SUBMIT_BRANCH] [PUBLIC_BRANCH]</p>
</td>
</tr>
<tr class="field-odd field"><th class="field-name">Options:</th><td class="field-body"><table class="first docutils option-list" frame="void" rules="none">
<col class="option" />
<col class="description" />
<tbody valign="top">
<tr><td class="option-group">
<kbd><span class="option">--body=<var>ARG</var></span></kbd></td>
<td><p class="first last">Body for the email.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--remember</span></kbd></td>
<td><p class="first last">Remember submit and public branch.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">-f <var>ARG</var></span>, <span class="option">--from=<var>ARG</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Branch to generate the submission from, rather than
the one containing the working directory.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">-v</span>, <span class="option">--verbose</span></kbd></td>
<td><p class="first last">Display more information.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--mail-to=<var>ARG</var></span></kbd></td>
<td><p class="first last">Mail the request to this address.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--format=<var>ARG</var></span></kbd></td>
<td><p class="first last">Use the specified output format.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--no-bundle</span></kbd></td>
<td><p class="first last">Do not include a bundle in the merge directive.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">-q</span>, <span class="option">--quiet</span></kbd></td>
<td><p class="first last">Only display errors and warnings.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--strict</span></kbd></td>
<td><p class="first last">Refuse to send if there are uncommitted changes in the
working tree, –no-strict disables the check.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--usage</span></kbd></td>
<td><p class="first last">Show usage message and options.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">-o <var>ARG</var></span>, <span class="option">--output=<var>ARG</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Write merge directive to this file or directory; use -
for stdout.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">-m <var>ARG</var></span>, <span class="option">--message=<var>ARG</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Message string.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">-r <var>ARG</var></span>, <span class="option">--revision=<var>ARG</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">See “help revisionspec” for details.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--no-patch</span></kbd></td>
<td><p class="first last">Do not include a preview patch in the merge directive.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">-h</span>, <span class="option">--help</span></kbd></td>
<td><p class="first last">Show help message.</p>
</td></tr>
</tbody>
</table>
</td>
</tr>
<tr class="field-even field"><th class="field-name">Description:</th><td class="field-body"><p class="first">A merge directive provides many things needed for requesting merges:</p>
<ul class="simple">
<li>A machine-readable description of the merge to perform</li>
<li>An optional patch that is a preview of the changes requested</li>
<li>An optional bundle of revision data, so that the changes can be applied
directly from the merge directive, without retrieving data from a
branch.</li>
</ul>
<p><cite>bzr send</cite> creates a compact data set that, when applied using bzr
merge, has the same effect as merging from the source branch.</p>
<p>By default the merge directive is self-contained and can be applied to any
branch containing submit_branch in its ancestory without needing access to
the source branch.</p>
<p>If –no-bundle is specified, then Bazaar doesn’t send the contents of the
revisions, but only a structured request to merge from the
public_location. In that case the public_branch is needed and it must be
up-to-date and accessible to the recipient. The public_branch is always
included if known, so that people can check it later.</p>
<p>The submit branch defaults to the parent of the source branch, but can be
overridden. Both submit branch and public branch will be remembered in
branch.conf the first time they are used for a particular branch. The
source branch defaults to that containing the working directory, but can
be changed using –from.</p>
<p>Both the submit branch and the public branch follow the usual behavior with
respect to –remember: If there is no default location set, the first send
will set it (use –no-remember to avoid setting it). After that, you can
omit the location to use the default. To change the default, use
–remember. The value will only be saved if the location can be accessed.</p>
<p>In order to calculate those changes, bzr must analyse the submit branch.
Therefore it is most efficient for the submit branch to be a local mirror.
If a public location is known for the submit_branch, that location is used
in the merge directive.</p>
<p>The default behaviour is to send the merge directive by mail, unless -o is
given, in which case it is sent to a file.</p>
<p>Mail is sent using your preferred mail program. This should be transparent
on Windows (it uses MAPI). On Unix, it requires the xdg-email utility.
If the preferred client can’t be found (or used), your editor will be used.</p>
<p>To use a specific mail program, set the mail_client configuration option.
(For Thunderbird 1.5, this works around some bugs.) Supported values for
specific clients are “claws”, “evolution”, “kmail”, “mail.app” (MacOS X’s
Mail.app), “mutt”, and “thunderbird”; generic options are “default”,
“editor”, “emacsclient”, “mapi”, and “xdg-email”. Plugins may also add
supported clients.</p>
<p>If mail is being sent, a to address is required. This can be supplied
either on the commandline, by setting the submit_to configuration
option in the branch itself or the child_submit_to configuration option
in the submit branch.</p>
<p>Two formats are currently supported: “4” uses revision bundle format 4 and
merge directive format 2. It is significantly faster and smaller than
older formats. It is compatible with Bazaar 0.19 and later. It is the
default. “0.9” uses revision bundle format 0.9 and merge directive
format 1. It is compatible with Bazaar 0.12 - 0.18.</p>
<p>The merge directives created by bzr send may be applied using bzr merge or
bzr pull by specifying a file containing a merge directive as the location.</p>
<p>bzr send makes extensive use of public locations to map local locations into
URLs that can be used by other people. See <cite>bzr help configuration</cite> to
set them, and use <cite>bzr info</cite> to display them.</p>
</td>
</tr>
<tr class="field-odd field"><th class="field-name">See also:</th><td class="field-body"><p class="first last"><a class="reference internal" href="merge-help.html"><em>merge</em></a>, <a class="reference internal" href="pull-help.html"><em>pull</em></a></p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="root-help.html"
title="previous chapter">root</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="serve-help.html"
title="next chapter">serve</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/user-reference/send-help.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="../search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="serve-help.html" title="serve"
>next</a></li>
<li class="right" >
<a href="root-help.html" title="root"
>previous</a> |</li>
<li><a href="http://bazaar.canonical.com/">
<img src="../_static/bzr icon 16.png" /> Home</a> | </li>
<a href="http://doc.bazaar.canonical.com/en/">Documentation</a> | </li>
<li><a href="../index.html">Table of Contents (2.6.0)</a> »</li>
<li><a href="index.html" >Bazaar User Reference</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2009-2011 Canonical Ltd.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.3.
</div>
</body>
</html>
