.\" $Id: pear.1,v 1.13 2010/01/26 00:59:49 cjalbert Exp $ .\" .\" Copyright (c) 2010 Apple Inc. and The PHP Group, all rights reserved. .\"/usr/share/misc/mdoc.template .mso www.tmac .Dd February 23, 2010 .Dt pear 1 .Sh NAME .Nm pear .Nd PHP Extension and Application Repository .Sh SYNOPSIS .Nm .Op options .Ar command .Op command-options .Ar parameters .Sh DESCRIPTION PEAR is an acronym for .Qq PHP Extension and Application Repository and is pronounced just like the fruit. The purpose of PEAR is to provide: .Bl -bullet -offset 3n -compact .It A structured library of open-source code for PHP users .It A system for code distribution and package maintenance .It A standard style for code written in PHP .It The PHP Extension Community Library (PECL) .It A web site, mailing lists and download mirrors to support the PHP/PEAR community .El .Pp Run .Ql Cm pear help to access the built-in tool documentation. .Pp Run .Ql Cm pear help options to list all options. .Pp Run .Ql Cm pear help shortcuts to list all command shortcuts. .Pp Run .Ql Cm pear help Ao Ar command Ac to get the help for the specified command. .Sh OPTIONS The following options are available: .Bl -tag -width ".Fl -d Ns Ar foo=bar" -offset indent -compact .It Fl c Ar file find user configuration in .Ar file .It Fl C Ar file find system configuration in .Ar file .It Fl d Ar foo=bar set user config variable .Ar foo to .Ar bar .It Fl D Ar foo=bar set system config variable .Ar foo to .Ar bar .It Fl G start in graphical (Gtk) mode .It Fl h , Fl ? display help/usage (this message) .It Fl q be quiet, decrease verbosity level .It Fl s store user configuration .It Fl S store system configuration .It Fl u Ar foo unset `foo' in the user configuration .It Fl v increase verbosity level (default 1) .It Fl V version information .El .Pp .Sh COMMANDS .Bl -tag -width ".It Cm package-dependencies" -compact .It Cm build Build an Extension From C Source .It Cm bundle Unpacks a Pecl Package .It Cm channel-add Add a Channel .It Cm channel-alias Specify an alias to a channel name .It Cm channel-delete Remove a Channel From the List .It Cm channel-discover Initialize a Channel from its server .It Cm channel-info Retrieve Information on a Channel .It Cm channel-login Connects and authenticates to remote channel server .It Cm channel-logout Logs out from the remote channel server .It Cm channel-update Update an Existing Channel .It Cm clear-cache Clear Web Services Cache .It Cm config-create Create a Default configuration file .It Cm config-get Show One Setting .It Cm config-help Show Information About Setting .It Cm config-set Change Setting .It Cm config-show Show All Settings .It Cm convert Convert a package.xml 1.0 to package.xml 2.0 format .It Cm cvsdiff Run a "cvs diff" for all files in a package .It Cm cvstag Set CVS Release Tag .It Cm download Download Package .It Cm download-all Downloads each available package from the default channel .It Cm info Display information about a package .It Cm install Install Package .It Cm list List Installed Packages In The Default Channel .It Cm list-all List All Packages .It Cm list-channels List Available Channels .It Cm list-files List Files In Installed Package .It Cm list-upgrades List Available Upgrades .It Cm login Connects and authenticates to remote server .Bq Deprecated in favor of Cm channel-login .It Cm logout Logs out from the remote server .Bq Deprecated in favor of Cm channel-logout .It Cm makerpm Builds an RPM spec file from a PEAR package .It Cm package Build Package .It Cm package-dependencies Show package dependencies .It Cm package-validate Validate Package Consistency .It Cm pickle Build PECL Package .It Cm remote-info Information About Remote Packages .It Cm remote-list List Remote Packages .It Cm run-scripts Run Post-Install Scripts bundled with a package .It Cm run-tests Run Regression Tests .It Cm search Search remote package database .It Cm shell-test Shell Script Test .It Cm sign Sign a package distribution file .It Cm svntag Set SVN Release Tag .It Cm uninstall Un-install Package .It Cm update-channels Update the Channel List .It Cm upgrade Upgrade Package .It Cm upgrade-all Upgrade All Packages .Bo Deprecated in favor of calling .Cm upgrade with no parameters .Bc .El .Sh SEE ALSO For a complete description of PEAR see .Bl -item -offset 4n -compact .It .URL http://\:pear.php.net/\:manual/ .El .Sh BUGS You can view the list of known bugs or report any new bug you found at .Bl -item -offset 4n -compact .It .URL http://\:pear.php.net .El .Sh AUTHORS The PHP Group: Thies C. Arntzen, Stig Bakken, Andi Gutmans, Rasmus Lerdorf, Sam Ruby, Sascha Schumann, Zeev Suraski, Jim Winstead, Andrei Zmievski. .Pp Additional work for the CLI sapi was done by Edin Kadribasic, Marcus Boerger and Johannes Schlueter. .Pp A list of active developers can be found on the PHP web site .Bl -item -offset 4n -compact .It .URL http://\:www.php.net/\:credits.php .El .Pp And last but not least PHP was developed with the help of a huge amount of contributors all around the world. .Sh VERSION INFORMATION This manpage describes .Cm php version 5.3.1. .Sh COPYRIGHT Copyright \(co 1997\-2010 The PHP Group .Pp This source file is subject to version 3.01 of the PHP license, that is bundled with this package in the file LICENSE, and is available through the world-wide-web at the following url: .Bl -item -offset 4n -compact .It .URL http://\:www.php.net/\:license/\:3_01.txt .El .Pp If you did not receive a copy of the PHP license and are unable to obtain it through the world-wide-web, please send a note to .MTO license@php.net so we can mail you a copy immediately.