Shaz,

Thanks. I just tried it against my registry entry and was able to get it to 
work.  There's a bug in plugman - if I don't provide a plugin ID, I get weird 
errors.

For example, if I issue "plugman owner ls" and don't provide a plugin ID, I get a 404 
error rather than something like "You did't provide a plugin name" I'll create a ticket.

On 10/29/2014 5:04 PM, Shazron wrote:
```
$ plugman owner ls org.apache.cordova.core.file
$ plugman owner add username org.apache.cordova.core.file
$ plugman owner rm username org.apache.cordova.core.file
```

plugins.cordova.io basically uses npm code on the backend, so it's similar
(substitute package for plugin). Each plugin on plugins.cordova.io has
owners -- i.e. people that have permissions to publish updates to the
plugin, "ls" here lists all owners (and their emails). Similarly "add" and
"rm" removes owners for each plugin.

On Wed, Oct 29, 2014 at 1:41 PM, John M. Wargo <jwarg...@gmail.com> wrote:

Steve,

I'd love to make the changes, but I can't right now. With my day job and
trying to finish up Apache Cordova 4 Programming at night, I won't be able
to contribute any doc changes until after that is done.

Yeah, I figured as much, but the download link on the home page says
"Download 4.0" and there isn't one. So someone following the plugman and
platform docs will be confused.

[1] doesn't have information about owner, all it says is:

$ plugman owner ls org.apache.cordova.core.file
$ plugman owner add username org.apache.cordova.core.file
$ plugman owner rm username org.apache.cordova.core.file

Which doesn't tell anything about what it means, what it's supposed to do
and how it's supposed to work (sorry). when I execute an ls, I get an
error. For the other ones, what am I adding and removing? a Plugin
Repository user name? Npm user name? Just a name? There's no details, no
examples, nothing. so I don't understand how I'm supposed to understand how
to use this without any information except for the commands.  Where does
owner write the information? The config.xml? somewhere else? Does this go
to the registry? See what I mean?

Any chance you can provide me with a little background you have on owner?

I'll submit a ticket for unpublish.


On 10/29/2014 2:40 PM, Steven Gill wrote:

Hey John,

Thanks for filing the two issues. It would be great if you could send PRs
for them too! I believe the correct information is in this help file [1]

Platform scripts: the platforms were not bumped to version 4.0. What you
see at https://www.apache.org/dist/cordova/platforms/ is the latest
released platforms. 4.0.0 referes to the cordova cli version. You can read
more about our change in versioning at
http://cordova.apache.org/announcements/2014/10/16/cordova-4.html

[1] also has info on addUser and owner. This info needs to be copied over
to docs.cordova.io. Would love some help with that if you have time!

You should not be creating a package.json. plugman publish command will
create one based on values from your plugin.xml. It gets deleted after a
successful publish.

Plugman unpublish might be a bug. File it.

Checkout a existing plugins plugin.xml [2] to see how we set description,
repo, keywords, etc. If you have a README.md file, that will also get
uploaded on publish.

We don't have any login setup on the site. We have an existing issue at
[3]. Just no time to do it.

As you can see, our documentation around plugin publishing is severely
lacking. We could really use some help sprucing it up!

[1] https://github.com/apache/cordova-plugman/blob/master/doc/help.txt
[2] https://github.com/apache/cordova-plugin-file/blob/master/plugin.xml
[3] https://issues.apache.org/jira/browse/CB-7246



On Wed, Oct 29, 2014 at 10:43 AM, Brian LeRoux <b...@brian.io> wrote:

  thats def a bug John / pls file!
On Wed, Oct 29, 2014 at 5:52 AM, John M. Wargo <jwarg...@gmail.com>
wrote:

  I'm playing around with plugman in Cordova 4.0 and have found some
issues
and have some questions.

First of all, the docs are incorrect and I've filed a ticket:
https://issues.apache.org/jira/browse/CB-7894.  The example for adding
a
plugin is missing the install switch.:

$ plugman -platform <ios|amazon-fireos|android|blackberry10|wp8>
--project <directory> --plugin <name|url|path> [--plugins_dir

<directory>]

[--www <directory>] [-variable <name>=<value> [--variable <name>=<value>
...]]

It should be:

$ plugman install -platform <ios|amazon-fireos|android|
blackberry10|wp8>
--project <directory> --plugin <name|url|path>[--plugins_dir
<directory>]
[--www <directory>] [-variable <name>=<value> [--variable <name>=<value>
...]]

The docs also say that the switch for uninstall is "--uninstall", but in
my testing it's actually "uninstall"  - I've created a ticket for this:
https://issues.apache.org/jira/browse/CB-7895.

The docs say to use the platform scripts to create a plugman project,
but
when I follow the links to the download, there's no download for Cordova
4.0. When will that be published?

When I unpublish my plugin, it says it's unpublished, but the entry is
still there in the registry. Should I submit a ticket for this?

I can't find any information on what the plugman owner command does.
When
I execute it, I get an error:

C:\Users\jwargo\dev\myplugin>plugman owner ls
ENOENT, open 'C:\Users\jwargo\dev\myplugin\package.json'

I can't find anything in the docs that tells me I should be creating a
package.json. Should I be?

I created one using npm init. Then, when I issue a plugman owner ls I
get
the following error:

404 Not Found: myplugin

Can someone explain to me how this is supposed to work? I can't seem to
find any documentation on this command.

Regarding the registry, it doesn't explain anywhere how to set the
description for the plugin - I'm assuming it's through a readme.md
file.
I also don't see anywhere I can login to the registry site and edit my
entry. I'm assuming also that keywords are set through the package.json
file?

--
John M. Wargo
@johnwargo <http://twitter.com/johnwargo>
www.johnwargo.com <http://www.johnwargo.com>
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------------------------------------
------------------------------




Reply via email to