Deprecate the Synchronizer package

Author: morozov

UPGRADE.md

@@ -1,5 +1,9 @@
 # Upgrade to 2.11
 
+## Deprecated `Synchronizer` package
+
+The `Doctrine\DBAL\Schema\Synchronizer\SchemaSynchronizer` interface and all its implementations are deprecated.
+
 ## Deprecated usage of wrapper-level components as implementations of driver-level interfaces
 
 The usage of the wrapper `Connection` and `Statement` classes as implementations of the `Driver\Connection` and `Driver\Statement` interfaces is deprecated.

docs/en/reference/sharding.rst

@@ -269,8 +269,8 @@ you have to sort the data in the application.
     $sql = "SELECT * FROM customers";
     $rows = $shardManager->queryAll($sql, $params);
 
-Schema Operations: SchemaSynchronizer Interface
------------------------------------------------
+Schema Operations: SchemaSynchronizer Interface (deprecated)
+------------------------------------------------------------
 
 Schema Operations in a sharding architecture are tricky. You have to perform
 them on all databases instances (shards) at the same time. Also Doctrine

lib/Doctrine/DBAL/Schema/Synchronizer/AbstractSchemaSynchronizer.php

@@ -7,6 +7,8 @@
 
 /**
  * Abstract schema synchronizer with methods for executing batches of SQL.
+ *
+ * @deprecated
  */
 abstract class AbstractSchemaSynchronizer implements SchemaSynchronizer
 {

lib/Doctrine/DBAL/Schema/Synchronizer/SchemaSynchronizer.php

@@ -7,6 +7,8 @@
 /**
  * The synchronizer knows how to synchronize a schema with the configured
  * database.
+ *
+ * @deprecated
  */
 interface SchemaSynchronizer
 {

lib/Doctrine/DBAL/Schema/Synchronizer/SingleDatabaseSynchronizer.php

@@ -12,6 +12,8 @@
 
 /**
  * Schema Synchronizer for Default DBAL Connection.
+ *
+ * @deprecated
  */
 class SingleDatabaseSynchronizer extends AbstractSchemaSynchronizer
 {