Merge lp:~patrick-regan/bzr/lp-quicktutorial into lp:bzr

Mini-tutorial had bug against it that said that the new(ish) lp: shortcut for the branch url scheme.

I added some to fix this bug. Comments and suggestions welcome.

Is there any reason for stressing that lp: is only supported in 0.92 several times? That release was over 2 years ago now. I'd be tempted to mention it in a note once (only). Thoughts?

> Is there any reason for stressing that lp: is only supported in 0.92 several
> times? That release was over 2 years ago now. I'd be tempted to mention it in
> a note once (only). Thoughts?

Sounds good, but where to say it? Just once the first time, or make a foot note? Should I even keep the whole URL examples?

Patrick Regan wrote:
>> Is there any reason for stressing that lp: is only supported in 0.92 several
>> times? That release was over 2 years ago now. I'd be tempted to mention it in
>> a note once (only). Thoughts?
>
> Sounds good, but where to say it? Just once the first time, or make a foot note? Should I even keep the whole URL examples?

Just once the first time is sufficient.

It's worth keeping the whole URL examples I think in "Publishing your
branch with sftp". I don't think they're needed in "Publishing your
branch with Launchpad".

Ian C.

Changes according to suggestions added and pushed.

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Ian Clatworthy wrote:
> Patrick Regan wrote:
>>> Is there any reason for stressing that lp: is only supported in 0.92 several
>>> times? That release was over 2 years ago now. I'd be tempted to mention it in
>>> a note once (only). Thoughts?
>> Sounds good, but where to say it? Just once the first time, or make a foot note? Should I even keep the whole URL examples?
>
> Just once the first time is sufficient.
>
> It's worth keeping the whole URL examples I think in "Publishing your
> branch with sftp". I don't think they're needed in "Publishing your
> branch with Launchpad".
>
> Ian C.

I would probably do it in a footnote. Something like:

Use[#]::

  bzr branch lp:~john-doe/foo/bar

.. [#] Versions of bzr before 0.92 did not understand the 'lp:' prefix.
       You can manually expand them to:
       ``bzr+ssh://bazaar.launchpad.net/~john-doe/foo/bar``.

The wrapping would need to be fixed, etc. But that would be the basic idea.

By the way, I always find:
http://docutils.sourceforge.net/docs/user/rst/quickref.html

To be *very* handy to keep around. When writing reStructuredText.

John
=:->

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Cygwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAksGsUcACgkQJdeBCYSNAAMZfgCgqfJz7iyUJWNvwmPh++XKVczI
LowAn1kYb4kOHFsRStoky9+qLLdiyNw4
=jopB
-----END PGP SIGNATURE-----

Finally got it changed. I've used a foot note. Thanks to Mr. Meinel for the link to the ReST quickref.

Looks good to me, using a footnote is a good solution.

One minor tweak while landing: the last example can simply be ...

  bzr branch lp:bzr-gtk bzr-gtk.john

I'll tweak and merge.

To get this to build, I had to do:
=== modified file 'doc/en/mini-tutorial/index.txt'
--- doc/en/mini-tutorial/index.txt 2009-12-02 23:09:40 +0000
+++ doc/en/mini-tutorial/index.txt 2009-12-03 00:44:16 +0000
@@ -182,10 +182,10 @@

 Replacing ``john.doe`` with your own Launchpad username, type [#]_::

+ $ bzr push lp:~john.doe/+junk/myproject
+
 .. [#] Use of the ``lp:`` URL scheme requires bzr 0.92 or later.

- $ bzr push lp:~john.doe/+junk/myproject
-
 **Note:** ``+junk`` means that this branch isn't associated with any particular
 project in Launchpad.

I assume the issue is that the ".. [#]" can't be in the "::" block. Did you do "make doc/en/mini-tutorial/index.html" and it worked for you? Because it didn't work on PQM or on my local machine.

>
> I assume the issue is that the ".. [#]" can't be in the "::" block. Did you
> do "make doc/en/mini-tutorial/index.html" and it worked for you? Because it
> didn't work on PQM or on my local machine.

I didn't actually (/me has a shameful look). I was at work on one of my
breaks for that edit, so I didn't have an environment with docutils
installed. I should have just waited to push it until I got home.

Won't happen again.

Pat

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Patrick Regan wrote:
>> I assume the issue is that the ".. [#]" can't be in the "::" block. Did you
>> do "make doc/en/mini-tutorial/index.html" and it worked for you? Because it
>> didn't work on PQM or on my local machine.
>
>
> I didn't actually (/me has a shameful look). I was at work on one of my
> breaks for that edit, so I didn't have an environment with docutils
> installed. I should have just waited to push it until I got home.
>
> Won't happen again.
>
> Pat
>

I wouldn't worry too much about "Won't happen again". Accidents happen,
and its why we have a PQM, a test suite, and code review in the first place.

Just a recommendation to make sure you check results before submission
as much is reasonable.

John
=:->
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Cygwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAksX2cIACgkQJdeBCYSNAAPfTgCeIJp/HR9RDgIGlbyQ+hWj4nyK
UXcAoK/QNZmXabubEY5/gi3i5e7j4QU8
=9Dng
-----END PGP SIGNATURE-----