|
Size: 1655
Comment: Add patchbomb extension page
|
← Revision 29 as of 2013-12-29 01:06:45 ⇥
Size: 2391
Comment: updated style
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| == Patchbomb extension == | #pragma section-numbers 2 = Patchbomb extension = |
| Line 4: | Line 5: |
| === Overview === | ''Author: Bryan O'Sullivan'' <<TableOfContents(3)>> == Overview == |
| Line 11: | Line 16: |
| 1. The remainder of the changeset description. | 1. The remainder of the changeset description |
| Line 13: | Line 18: |
| 1. An optional run of diffstat on the patch if it's avaliable | 1. An optional run of diffstat on the patch if it's available |
| Line 15: | Line 20: |
| 1. The patch itself, as generated by "hg export". | 1. The patch itself, as generated by the [[Cmd:export]] command |
| Line 19: | Line 24: |
| For each changeset, you will be prompted with a diffstat summary and the changeset summary, so you can be sure you are sending the right changes. The messages can be directly sent, or written to an mbox file, and a test mode is also avaliable to review what would the resulting mails look like. |
For each changeset, you will be prompted with a diffstat summary and the changeset summary, so you can be sure you are sending the right changes. The messages can be directly sent, or written to an mbox file, and a test mode is also avaliable to review what would the resulting mails look like. |
| Line 22: | Line 26: |
| === Configuration === To enable this extension add it to the extensions stanza in the hgrc file: |
== Configuration == To enable this extension add it to the extensions stanza in the `hgrc` file: |
| Line 29: | Line 33: |
| You must then configure it to either use your system's sendmail, or to use SMTP. To use sendmail, use something like this: | |
| Line 30: | Line 35: |
| To (optionally) configure other defaults, add a section like this to your hgrc file: | {{{ [email] method = /usr/sbin/sendmail }}} For direct SMTP: {{{ [email] method = smtp [smtp] host = smtp.example.com # Optional options: # username = joeuser # password = secret # port = 25 # tls = true # Alternative values: smtps, starttls (equivalent of true) # local_hostname = me.example.com }}} To (optionally) configure other defaults, add a section like this to your `hgrc` file: |
| Line 38: | Line 63: |
=== Usage === |
== Usage == |
| Line 44: | Line 67: |
== See also == * MboxExtension can do the reverse operation and import patchbombed mails from your mbox or IMAP mailbox to the MQ queue in your local repository ---- CategoryBundledExtension |
Patchbomb extension
This extension is currently being distributed along with Mercurial.
Author: Bryan O'Sullivan
Contents
1. Overview
This extension adds a new email command to send a collection of Mercurial changesets as a series of patch emails.
The series is started off with a "[PATCH 0 of N]" introduction, which describes the series as a whole and is followed by additional patch emails with a subject header describing the order in which the patches should be applied.
The message contains two or three body parts:
- The remainder of the changeset description
- An optional run of diffstat on the patch if it's available
The patch itself, as generated by the export command
Each message refers to all of its predecessors using the In-Reply-To and References headers, so they will show up as a sequence in threaded mail and news readers, and in mail archives.
For each changeset, you will be prompted with a diffstat summary and the changeset summary, so you can be sure you are sending the right changes. The messages can be directly sent, or written to an mbox file, and a test mode is also avaliable to review what would the resulting mails look like.
2. Configuration
To enable this extension add it to the extensions stanza in the hgrc file:
[extensions] hgext.patchbomb =
You must then configure it to either use your system's sendmail, or to use SMTP. To use sendmail, use something like this:
[email] method = /usr/sbin/sendmail
For direct SMTP:
[email] method = smtp [smtp] host = smtp.example.com # Optional options: # username = joeuser # password = secret # port = 25 # tls = true # Alternative values: smtps, starttls (equivalent of true) # local_hostname = me.example.com
To (optionally) configure other defaults, add a section like this to your hgrc file:
[email] from = My Name <my@email> to = recipient1, recipient2, ... cc = cc1, cc2, ... bcc = bcc1, bcc2, ...
3. Usage
hg email [OPTION]... [REV]...
Use hg help email to know about additional options.
4. See also
MboxExtension can do the reverse operation and import patchbombed mails from your mbox or IMAP mailbox to the MQ queue in your local repository