Permalink
Browse files

* implement Request #7352: add a README and an INSTALL by pear

git-svn-id: http://svn.php.net/repository/pear/pear-core/pear/pear-core/trunk@220345 c90b9560-bf6c-de11-be94-00142212c4b1
  • Loading branch information...
cellog
cellog committed Sep 22, 2006
1 parent 580480e commit 03f58da2e44cd97fd5855abead7d18a25000cdc7
Showing with 84 additions and 11 deletions.
  1. +53 −0 INSTALL
  2. +25 −11 README
  3. +3 −0 package-PEAR.xml
  4. +3 −0 package2.xml
View
53 INSTALL
@@ -0,0 +1,53 @@
+PEAR - The PEAR Installer
+=========================
+Installing the PEAR Installer.
+
+You should install PEAR on a local development machine first. Installing
+PEAR on a remote production machine should only be done after you are
+familiar with PEAR and have tested code using PEAR on your development
+machine.
+
+There are two methods of installing PEAR
+ - PEAR bundled in PHP
+ - go-pear
+
+We will first examine how to install PEAR that is bundled with PHP.
+
+Microsoft Windows
+=================
+If you are running PHP 5.2.0 or newer, simply download and
+run the windows installer (.msi) and PEAR can be automatically
+installed.
+
+Otherwise, for older PHP versions, download the .zip of windows,
+there is a script included with your PHP distribution that is called
+"go-pear". You must open a command box in order to run it. Click
+"start" then click "Run..." and type "cmd.exe" to open a command box.
+Use "cd" to change directory to the location of PHP where you unzipped it,
+and run the go-pear command.
+
+Unix
+====
+make sure you have enabled default extensions, and if you want faster
+downloads, enable the zlib extension. You must also enable the CLI
+SAPI with the --enable-cli extension directive. After this, simply run:
+
+make install-pear
+
+and PEAR will be automatically configured for you.
+
+go-pear
+=======
+For users who cannot perform the above steps, or who wish to obtain the
+latest PEAR with a slightly higher risk of failure, use go-pear. go-pear
+is obtained by downloading http://go-pear.org and saving it as go-pear.php.
+After downloading, simply run "php go-pear.php" or open it in a web browser
+(windows only) to download and install PEAR.
+
+You can always ask general installation questions on pear-general@lists.php.net,
+a public mailing list devoted to support for PEAR packages and installation-
+related issues.
+
+Happy PHPing, we hope PEAR will be a great tool for your development work!
+
+$Id$
View
36 README
@@ -1,18 +1,32 @@
- PEAR - PHP Extension and Application Repository
- ===============================================
- Dedicated to Malin Bakken, born 1999-11-21
+PEAR - The PEAR Installer
+=========================
-WHAT IS PEAR?
+What is the PEAR Installer? What is PEAR?
-PEAR is a code repository for PHP extensions and PHP library code
-similar to TeX's CTAN and Perl's CPAN.
-
-The intention behind PEAR is to provide a means for library code
-authors to organize their code in a defined way shared by other
-developers, and to give the PHP community a single source for such
-code.
+PEAR is the PHP Extension and Application Repository, found at
+http://pear.php.net. The PEAR Installer is this software, which
+contains executable files and PHP code that is used to download
+and install PEAR code from pear.php.net.
+PEAR contains useful software libraries and applications such as
+MDB2 (database abstraction), HTML_QuickForm (HTML forms management),
+PhpDocumentor (auto-documentation generator), DB_DataObject
+(Data Access Abstraction), and many hundreds more. Browse all
+available packages at http://pear.php.net, the list is constantly
+growing and updating to reflect improvements in the PHP language.
DOCUMENTATION
+=============
Documentation for PEAR can be found at http://pear.php.net/manual/.
+Installation documentation can be found in the INSTALL file included
+in this tarball.
+
+WARNING: DO NOT RUN PEAR WITHOUT INSTALLING IT - if you downloaded this
+tarball manually, you MUST install it. Read the instructions in INSTALL
+prior to use.
+
+
+Happy PHPing, we hope PEAR will be a great tool for your development work!
+
+$Id$
View
@@ -122,6 +122,7 @@ http://pear.php.net/dtd/package-1.0.xsd">
* implement Request #7090: PEAR_Downloader mustn't contact pear server
when installing local package file
* implement Request #7220: recognize deprecated package/channel and display to user
+ * implement Request #7352: add a README and an INSTALL by pear
* implement Request #7910: "Last Installed Version" should be
"Previous Installed Version"
* implement Request #7912: PEAR_Exception detect PEAR_Error as $message in
@@ -445,11 +446,13 @@ http://pear.php.net/dtd/package-1.0.xsd">
<replace from="@include_path@" to="php_dir" type="pear-config"/>
</file>
</dir>
+ <file role="doc" name="INSTALL" />
<file role="data" name="package.dtd"/>
<file role="data" name="template.spec"/>
<file role="php" name="PEAR.php">
<replace from="@package_version@" to="version" type="package-info"/>
</file>
+ <file role="doc" name="README" />
<file role="php" name="System.php">
<replace from="@package_version@" to="version" type="package-info"/>
</file>
View
@@ -126,6 +126,7 @@ http://pear.php.net/dtd/package-2.0.xsd">
* implement Request #7090: PEAR_Downloader mustn't contact pear server
when installing local package file
* implement Request #7220: recognize deprecated package/channel and display to user
+ * implement Request #7352: add a README and an INSTALL by pear
* implement Request #7910: &quot;Last Installed Version&quot; should be
&quot;Previous Installed Version&quot;
* implement Request #7912: PEAR_Exception detect PEAR_Error as $message in
@@ -442,10 +443,12 @@ http://pear.php.net/dtd/package-2.0.xsd">
<tasks:replace from="@include_path@" to="php_dir" type="pear-config" />
</file>
</dir> <!-- /scripts -->
+ <file name="INSTALL" role="doc" />
<file name="package.dtd" role="data" />
<file name="PEAR.php" role="php">
<tasks:replace from="@package_version@" to="version" type="package-info" />
</file>
+ <file name="README" role="doc" />
<file name="System.php" role="php">
<tasks:replace from="@package_version@" to="version" type="package-info" />
</file>

0 comments on commit 03f58da

Please sign in to comment.