ubuntu-packaging-guide-team team mailing list archive

[Barry Warsaw <barry@xxxxxxxxxxxxx>]

Barry Warsaw has proposed merging lp:~barry/ubuntu-packaging-guide/lookathistory into lp:ubuntu-packaging-guide.

Requested reviews:
  Ubuntu Packaging Guide Team (ubuntu-packaging-guide-team)

For more details, see:
https://code.launchpad.net/~barry/ubuntu-packaging-guide/lookathistory/+merge/61787

This adds a small section describing the revision specifier that bzr-builddeb adds.  It was the last piece in the wiki docs that were missing from the packaging guide.
-- 
https://code.launchpad.net/~barry/ubuntu-packaging-guide/lookathistory/+merge/61787
Your team Ubuntu Packaging Guide Team is requested to review the proposed merge of lp:~barry/ubuntu-packaging-guide/lookathistory into lp:ubuntu-packaging-guide.

=== modified file 'udd-latest.rst'
--- udd-latest.rst	2011-02-05 01:44:04 +0000
+++ udd-latest.rst	2011-05-20 15:33:28 +0000
@@ -44,3 +44,18 @@
 Any conflicts will be reported, and you can fix them up.  To review the
 changes that you just merged use `bzr diff`.  To undo the merge use `bzr
 revert`.  Once you are happy with the changes then use `bzr commit`.
+
+
+Referring to versions of a package
+==================================
+
+You will often think in terms of versions of a package, rather than the
+underlying Bazaar revision numbers.  `bzr-builddeb` provides a revision
+specifier that makes this convenient.  Any command that takes a ``-r``
+argument to specify a revision or revision range will work with this
+specifier, e.g. ``bzr log``, ``bzr diff``, and so on.  To view the versions of
+a package, use the ``package:`` specifier::
+
+    $ bzr diff -r package:0.1-1..package:0.1-2
+
+This shows you the difference between package version 0.1-1 and 0.1-2.