Re: Plugman issues/questions
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 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\mypluginplugman 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
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 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\mypluginplugman 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
Re: Plugman issues/questions
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 Yes. There seems to be a step missing, when did I define a remote target of 'apache' to do the pull against? Yes The docs say: The following commands will give you two remotes: origin (apache) and github (your repository). Probably my fault How does that first remote get set to 'apache'? git remote rename origin apache I tend to use https://github/apache/* as my origin and the asf upstream (which is slower) as apache.
Re: Plugman issues/questions
Hey John, Glad you had a change of heart! I will get back to your questions when I get into the office. Feel free to email me ANY problems you have. :) On Oct 30, 2014 7:37 AM, Josh Soref jso...@blackberry.com wrote: 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 Yes. There seems to be a step missing, when did I define a remote target of 'apache' to do the pull against? Yes The docs say: The following commands will give you two remotes: origin (apache) and github (your repository). Probably my fault How does that first remote get set to 'apache'? git remote rename origin apache I tend to use https://github/apache/* as my origin and the asf upstream (which is slower) as apache.
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\mypluginplugman 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
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\mypluginplugman 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
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\mypluginplugman 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
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\mypluginplugman 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
Re: Plugman issues/questions
``` $ 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\mypluginplugman owner ls ENOENT, open 'C:\Users\jwargo\dev\myplugin\package.json' I can't find
Re: Plugman issues/questions
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
Re: Plugman issues/questions
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 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\mypluginplugman 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 --