From 1796eb1d95e403d487c499d7320a0deed98f0423 Mon Sep 17 00:00:00 2001 From: Fabien Potencier Date: Mon, 5 May 2014 10:29:57 +0200 Subject: [PATCH] added a note about PEAR deprecation in the docs --- doc/installation.rst | 31 +++++++++++++++++++------------ 1 files changed, 19 insertions(+), 12 deletions(-) diff --git a/doc/installation.rst b/doc/installation.rst index 278ef61..f2c75c7 100644 --- a/doc/installation.rst +++ b/doc/installation.rst @@ -51,6 +51,11 @@ Installing the development version Installing the PEAR package ~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.. note:: + + Using PEAR for installing Twig is deprecated and Twig 1.15.1 was the last + version published on the PEAR channel; use Composer instead. + 1. Install PEAR 2. ``pear channel-discover pear.twig-project.org`` 3. ``pear install twig/Twig`` (or ``pear install twig/Twig-beta``) @@ -62,15 +67,7 @@ Installing the C extension The C extension was added in Twig 1.4. Twig comes with a C extension that enhances the performance of the Twig -runtime engine. - -You can install it via PEAR: - -1. Install PEAR -2. ``pear channel-discover pear.twig-project.org`` -3. ``pear install twig/CTwig`` (or ``pear install twig/CTwig-beta``) - -Or manually like any other PHP extension: +runtime engine; install it like any other PHP extensions: .. code-block:: bash @@ -80,6 +77,16 @@ Or manually like any other PHP extension: $ make $ make install +.. note:: + + You can also install the C extension via PEAR (note that this method is + deprecated and newer versions of Twig are not available on the PEAR + channel): + + 1. Install PEAR + 2. ``pear channel-discover pear.twig-project.org`` + 3. ``pear install twig/CTwig`` (or ``pear install twig/CTwig-beta``) + For Windows: 1. Setup the build environment following the `PHP documentation`_ @@ -90,11 +97,11 @@ For Windows: .. tip:: - For Windows ZendServer, TS is not enabled as mentionned in `Zend Server + For Windows ZendServer, ZTS is not enabled as mentioned in `Zend Server FAQ`_. - You have to use `configure --disable-all --disable-zts --enable-cli - --enable-twig=shared` to be able to build the twig C extension for + You have to use ``configure --disable-all --disable-zts --enable-cli + --enable-twig=shared`` to be able to build the twig C extension for ZendServer. The built DLL will be available in -- 1.7.2.5