Commands Available In PEAR2_SimpleChannelServer
Commands available for the pearscs command-line script.
create - creates a PEAR channel
The create
command creates a PEAR channel on the
local filesystem, including the channel.xml file and the get and rest
directories. This command assumes you are currently at the web root
for the channel you wish to create, unless you pass the path to where the
channel.xml file will be created. The local root can be a subdirectory
off of your webserver, but you should be in that subdirectory when
executing this command.
pearscs create pear.example.com summary [alias] [./channel.xml]
Required arguments are the channel name and channel summary. For example pear.example.com or can also be a subdirectory such as www.example.com/pear.
The alias is a short name which can be used to refer to your PEAR channel. If one is not specified, SimpleChannelServer will attempt to create one for you.
If the path to a channel.xml file is specified, the directory given will be used to create the channel.xml, get, and rest directories for the channel. If no path is specified, SimpleChannelServer will use the current directory.
release - releases a PEAR package to the channel
The release
command releases a package to your PEAR
channel.
pearscs release MyPackage-1.0.0.tgz handle
The file must be a valid PEAR package, and can be either the package.xml file, or a compressed and optionally signed .tgz file.
The handle
attribute should be a lead maintainer for the
package, as who released this version will be stored within the channel's
xml files.
update - updates the xml files for the local channel
The update
command re-generates the xml files for all
releases.
pearscs update [./channel.xml]
This command updates the associated xml files for all releases present in the get directory.
add-maintainer - adds a maintainer
The add-maintainer
command adds a maintainer's handle
to the list of channel maintainers.
pearscs add-maintainer handle
This command adds the handle of a maintainer to the local channel. It is not necessary to add maintainers before releasing a package, as they will automatically be added or updated.
add-category - adds a package category
The add-category
command adds a category to the channel.
pearscs add-cateogry category
This command adds a category to the channel for grouping related packages.