From f0740e53733e0bbae471b1e7797b9d6d746b14bb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Paris?= <postmaster@greg0ire.fr>
Date: Tue, 4 Oct 2022 21:37:20 +0200
Subject: [PATCH] Deprecate package

Users should migrate to PHP 8 attributes.
---
 README.md         | 4 ++++
 composer.json     | 3 +++
 docs/en/index.rst | 8 ++++++++
 3 files changed, 15 insertions(+)

diff --git a/README.md b/README.md
index c2c7eb7ba..0b350aa1c 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,7 @@
+⚠️ PHP 8 introduced [attributes](https://www.php.net/manual/en/language.attributes.overview.php),
+which are a native replacement for annotations. As such, this library is
+deprecated, and should receive exclusively bugfixes and security fixes.
+
 # Doctrine Annotations
 
 [![Build Status](https://github.com/doctrine/annotations/workflows/Continuous%20Integration/badge.svg?label=build)](https://github.com/doctrine/persistence/actions)
diff --git a/composer.json b/composer.json
index 62f76d217..51b4ec881 100644
--- a/composer.json
+++ b/composer.json
@@ -65,5 +65,8 @@
             "dealerdirect/phpcodesniffer-composer-installer": true
         },
         "sort-packages": true
+    },
+    "suggest": {
+        "php": "PHP 8.0 or higher comes with attributes, a native replacement for annotations"
     }
 }
diff --git a/docs/en/index.rst b/docs/en/index.rst
index 95476c313..aef126579 100644
--- a/docs/en/index.rst
+++ b/docs/en/index.rst
@@ -1,3 +1,11 @@
+Deprecation notice
+==================
+
+PHP 8 introduced `attributes
+<https://www.php.net/manual/en/language.attributes.overview.php>`_,
+which are a native replacement for annotations. As such, this library is
+deprecated, and should receive exclusively bugfixes and security fixes.
+
 Introduction
 ============