From 1796eb1d95e403d487c499d7320a0deed98f0423 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien.potencier@gmail.com>
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