[RFC] bzr help plugin-name

[Wouter van Heyst]

On Tue, Jun 20, 2006 at 10:22:23AM +1000, Martin Pool wrote:
> On 20 Jun 2006, Robert Collins <robertc at robertcollins.net> wrote:
> > On Mon, 2006-06-19 at 10:37 -0500, John Arbash Meinel wrote:
> > > Robert Collins wrote:
> > > > I think it would be nice if 'bzr help <pluginname>' were to show the
> > > > docstring from the plugin. This would allow plugins that introduce a
> > > > number of commands to have a single place to give conceptual guidance
> > > > and help - one that users can be taught how to predict.
> > > > 
> > > > Rob
> > > 
> > > This goes back into having plugins export a 'canonical' name. Otherwise
> > > I may work like mpe and have 01_shelf, or bzrtools-baz2bzr, or
> > > bzrtools-lifeless, etc.
> 
> I can see there are cases such as yourself it's useful but I do think
> it's a bit of an advanced use, and I think for most instances people
> should just call the directory by its canonical name.
> 
> Would it be enough for those modules to do something like (pseudocode)
> 
>   sys.modules['bzrlib.plugins.guisupport'] == __module__

That solves one part of the problem, but still leaves clashing plugins.
I should really try how much of that is alleviated by setting the plugin
path.

Wouter van Heyst