You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cordova.apache.org by "John M. Wargo" <jw...@gmail.com> on 2014/10/29 13:52:48 UTC
Plugman issues/questions
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>
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Re: Plugman issues/questions
Posted by "John M. Wargo" <jw...@gmail.com>.
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 <jw...@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 <jw...@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>
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------------------------------------
>>>>> ------------------------------
>>>>>
>>>>>
>>>>>
Re: Plugman issues/questions
Posted by Shazron <sh...@gmail.com>.
```
$ 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 <jw...@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 <jw...@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>
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------------------------------------
>>>> ------------------------------
>>>>
>>>>
>>>>
>
Re: Plugman issues/questions
Posted by "John M. Wargo" <jw...@gmail.com>.
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 <jw...@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>
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------
>>>
>>>
Re: Plugman issues/questions
Posted by "John M. Wargo" <jw...@gmail.com>.
Steve,
I'm trying to get setup to make the changes and submit them, but I'm not a big Git guy, so I'm running into some issues. Can you, or someone else, help me?
I'm working through the guide here: http://wiki.apache.org/cordova/IssueWorkflow.
It says I need to setup my environment using:
$ git clone https://git-wip-us.apache.org/repos/asf/cordova-docs.git
$ git remote add github https://github.com/you/cordova-docs.git
There seems to be a missing step there. Should it be?
$ git clone https://git-wip-us.apache.org/repos/asf/cordova-docs.git
$ cd cordova-docs
$ git remote add github https://github.com/you/cordova-docs.git
Later it says:
Before sending the pull request, you should ensure that your changes merge cleanly with the main documentation repository, and that the granularity of your commits make sense.
$ git checkout master
$ git pull apache master
$ git checkout CB-1234
$ git rebase master -i
There seems to be a step missing, when did I define a remote target of 'apache' to do the pull against? The docs say: "The following commands will give you two remotes: origin (apache) and github (your repository). Replaceyouwith your github.com account name in the following commands:"
How does that first remote get set to 'apache'?
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 <jw...@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>
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------
>>>
>>>
Re: Plugman issues/questions
Posted by "John M. Wargo" <jw...@gmail.com>.
Steve,
You're right, I'm being an idiot. I'll make the changes today and submit the PR. I'm just the tiniest bit intimidated by the process since I've not done it before.
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 <jw...@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>
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------------------------------------
>>> ------------------------------
>>>
>>>
Re: Plugman issues/questions
Posted by Steven Gill <st...@gmail.com>.
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 <jw...@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>
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------------------------------------
> > ------------------------------
> >
> >
>
Re: Plugman issues/questions
Posted by "John M. Wargo" <jw...@gmail.com>.
Filed: https://issues.apache.org/jira/browse/CB-7900.
On 10/29/2014 1:43 PM, Brian LeRoux wrote:
> thats def a bug John / pls file!
>
> On Wed, Oct 29, 2014 at 5:52 AM, John M. Wargo <jw...@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>
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------------------------------------
>> ------------------------------
>>
>>
Re: Plugman issues/questions
Posted by Brian LeRoux <b...@brian.io>.
thats def a bug John / pls file!
On Wed, Oct 29, 2014 at 5:52 AM, John M. Wargo <jw...@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>
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------
>
>