deprecate propel support and fix some doc references

Author: Tobion

CHANGELOG-4.0.md

@@ -11,6 +11,7 @@ in 4.0 versions.
 * Introduce InPlacePagerPersister.
 * Add new options to populate command: --first-page, last-page, --max-per-page. They work only if you use v5 providers API.
 * Deprecate some options of populate command: --batch-size and --offset.
+* Deprecate Propel support
 
 ### 4.0.1 (2017-08-10)
 

DependencyInjection/FOSElasticaExtension.php

@@ -714,6 +714,10 @@ private function loadDriver(ContainerBuilder $container, $driver)
             return;
         }
 
+        if ('propel' === $driver) {
+            @trigger_error('Support for Propel is deprecated since version 4.1 and will be removed in 5.0.', E_USER_DEPRECATED);
+        }
+
         $loader = new XmlFileLoader($container, new FileLocator(__DIR__.'/../Resources/config'));
         $loader->load($driver.'.xml');
         $this->loadedDrivers[] = $driver;

Propel/ElasticaToModelTransformer.php

@@ -9,6 +9,8 @@
 use Symfony\Component\PropertyAccess\PropertyAccessorInterface;
 
 /**
+ * @deprecated since 4.1 will be removed in 5.x.
+ *
  * Maps Elastica documents with Propel objects.
  *
  * This mapper assumes an exact match between Elastica document IDs and Propel

Propel/Propel1PagerProvider.php

@@ -16,6 +16,9 @@
 use Pagerfanta\Adapter\PropelAdapter;
 use Pagerfanta\Pagerfanta;
 
+/**
+ * @deprecated since 4.1 will be removed in 5.x.
+ */
 final class Propel1PagerProvider implements PagerProviderInterface
 {
     /**

README.md

@@ -16,7 +16,7 @@ Documentation
 
 Documentation for FOSElasticaBundle is in `Resources/doc/index.md`
 
-[Read the documentation for 4.x](https://github.com/FriendsOfSymfony/FOSElasticaBundle/blob/master/Resources/doc/index.md)
+[Read the documentation for 4.x](Resources/doc/index.md)
 
 [Read the documentation for 3.2.x](https://github.com/FriendsOfSymfony/FOSElasticaBundle/blob/3.2.x/Resources/doc/index.md)
 

Resources/doc/cookbook/manual-provider.md

@@ -1,7 +1,7 @@
 Manual pager provider
 ====================
 
-Create a service with the tag "fos_elastica.provider" and attributes for the
+Create a service with the tag "fos_elastica.pager_provider" and attributes for the
 index and type for which the service will provide.
 
 ```yaml
@@ -35,10 +35,10 @@ class UserPagerProvider implements PagerProviderInterface
 
 There are some examples:
 
-* [DoctrineORMPagerProvider](https://github.com/FriendsOfSymfony/FOSElasticaBundle/blob/master/Doctrine/DoctrineORMPagerProvider.php)
-* [DoctrinePHPCRPagerProvider](https://github.com/FriendsOfSymfony/FOSElasticaBundle/blob/master/Doctrine/DoctrinePHPCRPagerProvider.php)
-* [DoctrineMongoDBPagerProvider](https://github.com/FriendsOfSymfony/FOSElasticaBundle/blob/master/Doctrine/DoctrineMongoDBPagerProvider.php)
-* [Propel1PagerProvider](https://github.com/FriendsOfSymfony/FOSElasticaBundle/blob/master/Propel/Propel1PagerProvider.php)
+* [ORMPagerProvider](../../../Doctrine/ORMPagerProvider.php)
+* [PHPCRPagerProvider](../../../Doctrine/PHPCRPagerProvider.php)
+* [MongoDBPagerProvider](../../../Doctrine/MongoDBPagerProvider.php)
+* [Propel1PagerProvider](../../../Propel/Propel1PagerProvider.php)
 
 
 Manual Provider (DEPRECATED)