If you simply want to get to know the installed version of a package or see its description, issue an info command:
$ pear info PEAR
.. more info follows ..
You often don't know which files belong to a certain installed package. list-files is helping you here. It shows you the file's role and its full path:
$ pear list-files log
Installed Files For log
Type Install Path
While we try to document each package in the manual, many packages - with or without a manual entry - come with examples. They have the file role "doc" and can be located with list-files, too:
$ pear list-files log | grep ^doc
list shows you all installed packages with their version and stability:
$ pear list
Installed packages, channel pear.php.net:
Package Version State
Archive_Tar 1.3.2 stable
Auth 1.5.4 stable
Cache 1.5.4 stable
Console_Getargs 1.3.4 stable
Console_Getopt 1.2.3 stable
To see all available packages on the channel server, use remote-list:
$ pear remote-list
... output follows ...
Note: This command takes some time if there are many packages on the server
Instead of going to the PEAR website, you can use the pear installer to search for package names.
$ pear search w3c
Matched packages, channel pear.php.net:
Package Stable/(Latest) Local
Services_W3C_CSSValidator 0.1.0 (alpha) An Object Oriented Interface ...
The result list shows name, remote version and stability and the package description. Alternatively, you can use the package browser on pear.php.net.