/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to doc/developers/uncommit.txt

  • Committer: Adeodato Simó
  • Date: 2007-07-18 15:51:52 UTC
  • mto: (2639.1.1 jam-integration)
  • mto: This revision was merged to the branch mainline in revision 2640.
  • Revision ID: dato@net.com.org.es-20070718155152-pv6rwq41eckqyxem
New EmailMessage class, façade around email.Message and MIMEMultipart.

* bzrlib/email_message.py,
  bzrlib/tests/test_email_message.py:
  New files.

* bzrlib/tests/__init__.py:
  (test_suite): add bzrlib.tests.test_email_message.

* bzrlib/merge_directive.py:
  (MergeDirective.to_email): Use EmailMessage instead of email.Message.

* bzrlib/tests/test_merge_directive.py,
  bzrlib/tests/blackbox/test_merge_directive.py:
  (__main__): adjust EMAIL1 and EMAIL2 strings to how EmailMessage
  formats itself.

* bzrlib/smtp_connection.py:
  (SMTPConnection.get_message_addresses): do not use methods present in
  email.Message but not in EmailMessage (get_all). Use get() instead of
  __getitem__ to make explicit that None is returned if the header does
  not exist.

* bzrlib/tests/test_smtp_connection.py:
  (TestSMTPConnection.test_get_message_addresses, 
   TestSMTPConnection.test_destination_address_required): test the
   functions against EmailMessage in addition to email.Message.

* NEWS:
  Mention EmailMessage in INTERNALS.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/uncommit.txt
 
1
Uncommit Performance Notes
 
2
==========================
 
3
 
 
4
Specification of uncommit
 
5
-------------------------
 
6
 
 
7
``uncommit`` removes revisions from the head of a branch.  (By default, only
 
8
the very latest revision is removed, but optionally more can be taken.)
 
9
Uncommit does not affect the repository (garbage collection is a separate
 
10
step and not done by default).  The working tree is not logically
 
11
modified (revert is a different operation), except as described below
 
12
about merges.
 
13
 
 
14
Uncommit can be performed on either a branch or a working tree (and
 
15
implicitly its branch.)
 
16
 
 
17
If the uncommitted revisions includes one or more merges, after the
 
18
uncommit those revisions are in the working tree's list of pending merges,
 
19
because their tree changes are still present in the tree.
 
20
 
 
21
For a bound branch, uncommit fails unless the local branch is up to date.