[Concept,5/5] doc: api: Add a migration deadline

Message ID 20250905131816.3344908-6-sjg@u-boot.org
State New
Headers
Series api: Deprecate the API |

Commit Message

Simon Glass Sept. 5, 2025, 1:18 p.m. UTC
  From: Simon Glass <sjg@chromium.org>

Set a deadline of the end of 2027 for removal of what is now the legacy
API.

Signed-off-by: Simon Glass <sjg@chromium.org>
---

 doc/develop/driver-model/migration.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)
  

Patch

diff --git a/doc/develop/driver-model/migration.rst b/doc/develop/driver-model/migration.rst
index b40a6af9d11..50689282b39 100644
--- a/doc/develop/driver-model/migration.rst
+++ b/doc/develop/driver-model/migration.rst
@@ -118,3 +118,15 @@  Deadline: 2023.04
 The serial subsystem has supported the driver model since late 2014.
 Maintainers should submit patches switching over to using CONFIG_DM_SERIAL and
 other base driver model options in time for inclusion in the 2022.10 release.
+
+CONFIG_LEGACY_API
+-----------------
+Deadline: 2028.01
+
+U-Boot has long supported an API which allows external programs to call entry
+points in U-Boot. This API does not support driver model and is not widely used.
+It is being replaced by a library approach (libu-boot.a/so) which is more
+flexible and could potentially support an automatically generated stub with
+those entry points.
+
+The API will be removed for the 2028.01 release.