X-Git-Url: http://wagnertech.de/gitweb/gitweb.cgi/timetracker.git/blobdiff_plain/afe2d051307ae2cd54bdb957f04e1d9f625f2dd9..90ff65cf45284f90b1c4e09fe575319b320f56ac:/WEB-INF/lib/pear/README.rst diff --git a/WEB-INF/lib/pear/README.rst b/WEB-INF/lib/pear/README.rst new file mode 100644 index 00000000..ac8e6fd1 --- /dev/null +++ b/WEB-INF/lib/pear/README.rst @@ -0,0 +1,88 @@ +************************* +PEAR - The PEAR Installer +************************* +.. image:: https://travis-ci.org/pear/pear-core.svg?branch=stable + :target: https://travis-ci.org/pear/pear-core + +========================================= +What is the PEAR Installer? What is PEAR? +========================================= +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. + +.. 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. + + +============= +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. + + +===== +Tests +===== +Run the tests without installation as follows:: + + $ ./scripts/pear.sh run-tests -r tests + +You should have the ``Text_Diff`` package installed to get nicer error output. + +To run the tests with another PHP version, modify ``php_bin`` and set the +``PHP_PEAR_PHP_BIN`` environment variable:: + + $ pear config-set php_bin /usr/local/bin/php7 + $ PHP_PEAR_PHP_BIN=/usr/local/bin/php7 ./scripts/pear.sh run-tests -r tests + +Happy PHPing, we hope PEAR will be a great tool for your development work! + + +Test dependencies +================= +* ``zlib`` + + +========= +Releasing +========= +Create a PEAR package as well as phars for pear-less installation:: + + $ rm -f PEAR-*.tgz + $ pear package package2.xml + $ cd go-pear-tarballs + $ rm -f PEAR-* + $ cp ../PEAR-*.tgz . + $ gunzip PEAR-*.tgz + $ pear download -Z Archive_Tar Console_Getopt Structures_Graph XML_Util + $ mkdir src && cd src + $ for i in ../*.tar; do tar xvf $i; done + $ mv *\/* . + $ cd ../../ + $ php make-gopear-phar.php + $ php make-installpear-nozlib-phar.php + +(Or simply run ``build-release.sh``). + +``go-pear.phar`` is contains the PEAR installer installer that asks questions +where to install it. +It is available from http://pear.php.net/go-pear.phar. + +``install-pear-nozlib.phar`` installs PEAR automatically without asking +anything. +It is shipped with PHP itself.