From f68e94a8cf480f7f67f1c140854020868374296c Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Thu, 28 Jan 2016 00:13:26 +0100
Subject: [PATCH] introduce 3.1 and 4.0 upgrade files

---
 UPGRADE-3.1.md | 30 ++++++++++++++++++++++++++++++
 UPGRADE-4.0.md | 28 ++++++++++++++++++++++++++++
 2 files changed, 58 insertions(+)
 create mode 100644 UPGRADE-3.1.md
 create mode 100644 UPGRADE-4.0.md

diff --git a/UPGRADE-3.1.md b/UPGRADE-3.1.md
new file mode 100644
index 0000000000..9f2b82dae0
--- /dev/null
+++ b/UPGRADE-3.1.md
@@ -0,0 +1,30 @@
+UPGRADE FROM 3.0 to 3.1
+=======================
+
+DependencyInjection
+-------------------
+
+ * Using unsupported configuration keys in YAML configuration files has been
+   deprecated and will raise an exception in Symfony 4.0.
+
+ * Using unsupported options to configure service aliases has been deprecated
+   and will raise an exception in Symfony 4.0.
+
+Form
+----
+
+ * The `choices_as_values` option of the `ChoiceType` has been deprecated and
+   will be removed in Symfony 4.0.
+
+Serializer
+----------
+
+ * Passing a Doctrine `Cache` instance to the `ClassMetadataFactory` has been
+   deprecated and will not be supported in Symfony 4.0. You should use the
+   `CacheClassMetadataFactory` class instead.
+
+Yaml
+----
+
+ * The `!!php/object` tag to indicate dumped PHP objects has been deprecated
+   and will be removed in Symfony 4.0. Use the `!php/object` tag instead.
diff --git a/UPGRADE-4.0.md b/UPGRADE-4.0.md
new file mode 100644
index 0000000000..2d402d75fb
--- /dev/null
+++ b/UPGRADE-4.0.md
@@ -0,0 +1,28 @@
+UPGRADE FROM 3.x to 4.0
+=======================
+
+DependencyInjection
+-------------------
+
+ * Using unsupported configuration keys in YAML configuration files raises an
+   exception.
+
+ * Using unsupported options to configure service aliases raises an exception.
+
+Form
+----
+
+ * The `choices_as_values` option of the `ChoiceType` has been removed.
+
+Serializer
+----------
+
+ * The ability to pass a Doctrine `Cache` instance to the `ClassMetadataFactory`
+   class has been removed. You should use the `CacheClassMetadataFactory` class
+   instead.
+
+Yaml
+----
+
+ * The `!!php/object` tag to indicate dumped PHP objects was removed in favor of
+   the `!php/object` tag.