[MERGE] doc: send -o, and more on send in user guide

[Ian Clatworthy]

Martin Albisetti wrote:
> On Wed, Apr 23, 2008 at 10:28 PM, Martin Pool <mbp at sourcefrog.net> wrote:
>> https://bugs.launchpad.net/bzr/+bug/221021 mentions that "send -o -" is not
>>  well documented.  While fixing that I thought the send section in the user
>>  guide could be rearranged.
> 
> +        Option('output', short_name='o',
> +               help='Write directive to this file; '
> +                    'use - for stdout.',
> 
> "Write merge directive to this file" might be more consistent with the
> rest of the docs.
> The rest looks like a great improvement  :)

bb: tweak

As Martin A suggests.

Ian C.