Merge lp:~barry/bzr-alldocs/debuntu into lp:bzr-alldocs

[Barry Warsaw]

Adds the bzr-debuntu plugin.

=== modified file 'plugins-registry.ini'
--- plugins-registry.ini	2010-09-22 16:01:36 +0000
+++ plugins-registry.ini	2010-09-22 18:21:48 +0000
@@ -6,7 +6,7 @@
 # Usage Tips:
 # 1. Please keep plugins in alphabetical order.
 # 2. The only required values are 'purpose' and 'link.branch'.
-# 3. purpose needs to be consise as it appears in the Guide's Contents.
+# 3. purpose needs to be concise as it appears in the Guide's Contents.
 # 4. link.branch is where the code lives. Use lp:xxx if appropriate.
 #    Other link.xxx settings you may wish to define:
 #    * link.home is the home page. If not set and link.branch=lp:xxx,
@@ -190,6 +190,12 @@
 platform.mac-osx = False
 platform.windows = False
 
+[plugin debuntu]
+purpose = Shortcuts for referencing Ubuntu and Debian source branches on Launchpad
+link.branch = lp:bzr-debuntu
+owner = barry
+platform.gnulinux = True
+
 [plugin depend]
 purpose = Show versions of installed libraries used by Bazaar
 link.branch = lp:bzr-depend

=== added file 'plugins/en/debuntu.txt'
--- plugins/en/debuntu.txt	1970-01-01 00:00:00 +0000
+++ plugins/en/debuntu.txt	2010-09-22 18:21:48 +0000
@@ -0,0 +1,88 @@
+``debuntu`` - Shortcuts to Ubuntu and Debian source branches on Launchpad
+=========================================================================
+
+================ ============================================================
+Version          Not specified                                               
+Branch           `lp:bzr-debuntu <https://code.launchpad.net/bzr-debuntu>`_
+Home page        `<https://launchpad.net/bzr-debuntu>`_                    
+Owner            `barry <https://launchpad.net/~barry>`_                       
+GNU/Linux        Yes
+Windows          Unknown
+Mac OS X         Unknown
+================ ============================================================
+
+debuntu
+-------
+
+**Purpose**
+
+Debian and Ubuntu source branch access.
+
+**Usage**
+
+``bzr branch ubuntu:gtimelog``
+
+**Options**
+
+None
+
+**Description**
+
+This plugin provides some convenient shortcuts for getting to Debian and
+Ubuntu source branches on Launchpad.  It uses the `launchpad plugin
+<launchpad-plugin.html>`_ to resolve the URLs, so you must have that plugin
+available and set up.
+
+By using the ``ubuntu:`` or ``debian:`` URL schemes, you can easily access the
+source branch for a project on Launchpad for the given distribution.  You can
+also specify a *distroseries* by naming it in the first path parameter.  For
+example, to access the
+`Ubuntu Maverick <https://launchpad.net/ubuntu/maverick>`_
+version of the
+`GTimeLog Time Tracker <https://code.launchpad.net/ubuntu/maverick/+source/gtimelog>`_
+project, you could use::
+
+    bzr branch ubuntu:maverick/gtimelog
+
+Without a distroseries specification, the source package for the *current*
+distroseries is used (as determined by Launchpad).
+
+The plugin supports abbreviations for both the distro and distroseries.
+``u:`` is an abbreviation for ``ubuntu:`` and ``d:`` is an abbreviation for
+``debian:``.  Abbreviations for distroseries are also available, e.g:
+
+Ubuntu:
+
+    * m -> maverick
+    * l -> lucid
+    * k -> karmic
+    * j -> jaunty
+    * h -> hardy
+    * d -> dapper
+
+Debian:
+
+    * l -> lenny
+    * s -> squeeze
+
+**Examples**
+
+Here are some example usages for accessing the source branches for project
+``foo``:
+
+=================== ==========
+bzr branch          expands to
+=================== ==========
+ubuntu:foo          lp:ubuntu/foo
+ubuntu:maverick/foo lp:ubuntu/maverick/foo
+ubuntu:m/foo        lp:ubuntu/maverick/foo
+u:foo               lp:ubuntu/foo
+u:maverick/foo      lp:ubuntu/maverick/foo
+u:m/foo             lp:ubuntu/maverick/foo
+debian:foo          lp:debian/foo
+debian:squeeze/foo  lp:debian/squeeze/foo
+debian:s/foo        lp:debian/squeeze/foo
+d:foo               lp:debian/foo
+d:squeeze/foo       lp:debian/squeeze/foo
+d:s/foo             lp:debian/squeeze/foo
+=================== ==========

=== modified file 'plugins/en/index.txt'
--- plugins/en/index.txt	2010-03-31 09:17:09 +0000
+++ plugins/en/index.txt	2010-09-22 18:21:48 +0000
@@ -123,6 +123,7 @@
    bzrtools-plugin
    colo-plugin
    custom-url-schemes-plugin
+   debuntu
    grep-plugin