Document how to use PubGlobal

[zoechi]

I tried to activate a path package but PubApp.global() seems not to support it.
Whith PubGlobals API this would be quite easy but I can't create an instance.

There also seems no way to make use of _sdkBin to rebuild the inaccessible features in an easy way outside of Grinder.

I find it quite confusing that this class is public but can't be used.

[zoechi]

I found out that Pub.global returns an instance of PubGlobal.
I still think this is confusing. Autocompletion shows PubGlobal and it looks inviting for the task at hand, but I can't use it because it has a private constructor.

The doc of PubGlobal says

/// Access the pub global commands.

And I would like to do something like this return run_lib.run(_sdkBin('pub'), arguments: args, runOptions: runOptions); myself, but can't because _sdkBin is private.

Is there a reason _sdkBin is private?

What can be done to reduce the confusion about PubGlobal?

• move the class to another file (inside src where its not directly exported)
• add documentation that points to Pub.global

[seaneagan]

Activating a path package is tracked in #165.

_sdkBin would be exposed via #204 as sdk.bin.

I agree we should document in PubGlobal that it is used via pub.global (renaming this issue to match).

[zoechi]

Sounds great!