Deprecated all final handlers

Final handlers will be removed in version 2.0, to be replaced with
default delegates.

Author: weierophinney

src/Container/TemplatedErrorHandlerFactory.php

@@ -38,6 +38,13 @@
  * </code>
  *
  * If any of the keys are missing, default values will be used.
+ *
+ * @deprecated since 1.1.0, to be removed in 2.0.0. The "final handler" concept
+ *     will be replaced with a "default delegate", which will be an
+ *     implementation of Interop\Http\ServerMiddleware\DelegateInterface that
+ *     returns a canned response. Expressive will provide tools to migrate your
+ *     code to use default delegates for 2.0; you will only need to manually
+ *     change your code if you are extending this class.
  */
 class TemplatedErrorHandlerFactory
 {

src/Container/WhoopsErrorHandlerFactory.php

@@ -60,6 +60,13 @@
  * </code>
  *
  * All values are booleans; omission of any implies boolean false.
+ *
+ * @deprecated since 1.1.0, to be removed in 2.0.0. The "final handler" concept
+ *     will be replaced with a "default delegate", which will be an
+ *     implementation of Interop\Http\ServerMiddleware\DelegateInterface that
+ *     returns a canned response. Expressive will provide tools to migrate your
+ *     code to use default delegates for 2.0; you will only need to manually
+ *     change your code if you are extending this class.
  */
 class WhoopsErrorHandlerFactory
 {

src/TemplatedErrorHandler.php

@@ -18,6 +18,13 @@
  * Provides the optional ability to render a template for each of 404 and
  * general error conditions. If no template renderer is provided, returns
  * empty responses with appropriate status codes.
+ *
+ * @deprecated since 1.1.0, to be removed in 2.0.0. The "final handler" concept
+ *     will be replaced with a "default delegate", which will be an
+ *     implementation of Interop\Http\ServerMiddleware\DelegateInterface that
+ *     returns a canned response. Expressive will provide tools to migrate your
+ *     code to use default delegates for 2.0; you will only need to manually
+ *     change your code if you are extending this class.
  */
 class TemplatedErrorHandler
 {

src/WhoopsErrorHandler.php

@@ -20,6 +20,12 @@
  * interface for navigating an exception stack trace.
  *
  * @see http://filp.github.io/whoops/
+ * @deprecated since 1.1.0, to be removed in 2.0.0. The "final handler" concept
+ *     will be replaced with a "default delegate", which will be an
+ *     implementation of Interop\Http\ServerMiddleware\DelegateInterface that
+ *     returns a canned response. Expressive will provide tools to migrate your
+ *     code to use default delegates for 2.0; you will only need to manually
+ *     change your code if you are extending this class.
  */
 class WhoopsErrorHandler extends TemplatedErrorHandler
 {