Usage of bzr-hg plug-in

[Jelmer Vernooij]

Ben Finney wrote:
> Jelmer Vernooij <jelmer at samba.org> writes:
>> Ben Finney wrote:
>>> I concur with Colin that documentation online is very desirable
>>> *before* downloading any package, to decide whether it serves
>>> one's purpose and what will be needed to begin using it.
>> Well, this is stretching "documentation" a bit imho.
> 
> Why so? Before installing Bazaar, I browsed its online user manual.
> The fact that I could do so weighed heavily in its favour when making
> the decision to install.
You seem to mean something different than Colin. Colin mentioned wanting
to read a short description that allowed him to decide whether or not
plugin foo did what he was looking for.

>> It currently allows pulling from (and eventually pushing to) hg
>> repositories.
> Sounds great, but there's no clue *what to do differently* now that
> this ability has been asserted. Refer back to my original message in
> this thread for what I was led to assume would be the case.

>> Anyway, if you suggestions about how to improve this description,
>> they're welcome.
> 
> I don't know how to word it, but I would expect a UI-level answer to
> the questions “What can I do now that I couldn't before?” and “How
> should I do it?” If that's as simple as telling me which *existing*
> commands now work differently (and how they work differently), then
> that's what to say.
There *are* no changes on the UI level. No new commands, currently no
new revspecs, no new urlspecs. The only difference is that you can now
run some bzr commands in branches that use the Mercurial formats. If you
have a way to describing that *without* mentioning the fact there are
different file formats, I'm listening :-)

Cheers,

Jelmer