So I was in my ~/workspaces dir trying to create a new package:
php pyrus.phar gp Services_Foo/
Pyrus version 2.0.0a3 SHA-1: BE7EA9D171AE3873F1BBAF692EEE9165BB14BD5D
Using PEAR installation found at /home/till/PEAR2/Pyrus
Creating package.xml...PEAR2\Pyrus\PackageFile\Exception: Invalid package.xml
PEAR2\Pyrus\Validate\Exception: Channel validator error: field "package" - package name "PEAR2_Services_Foo/" is invalid
It's not exactly clear what the parameters are. E.g. I was assuming that it must be a path, but obviously it's the package name.
So maybe we can improve the API and the help docs?
Hmm, here's the documentation for the command, http://pear.php.net/manual/en/pyrus.commands.generatepear2.php
pyrus help generate-pear2 also has all the details.
pyrus help generate-pear2
I'd vote for one single use case vs 3 paragraphs of text.