File 3141-archives-Formally-deprecate-and-schedule-f... of Package erlang

Overview Repositories Revisions Requests Users Attributes Meta

File 3141-archives-Formally-deprecate-and-schedule-for-removal.patch of Package erlang

From f116b2646f25deb5920d316fb4f52e85466d870c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bj=C3=B6rn=20Gustavsson?= <bjorn@erlang.org>
Date: Wed, 24 Apr 2024 13:28:24 +0200
Subject: [PATCH] archives: Formally deprecate and schedule for removal

Archives is an experimental feature. Its mere presence makes
its hard or impossible to improve the time for starting `erl`.

Warn for the removal of archives for the purpose of holding a single
application and including those archives in the code path.

Using a single archive in an Escript is **not** deprecated.
---
 system/doc/general_info/deprecations_27.md       | 16 ++++++++++++++++
 .../doc/general_info/scheduled_for_removal_28.md | 14 ++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 system/doc/general_info/deprecations_27.md
 create mode 100644 system/doc/general_info/scheduled_for_removal_28.md

diff --git a/system/doc/general_info/deprecations_27.md b/system/doc/general_info/deprecations_27.md
new file mode 100644
index 0000000000..80bd06cd56
--- /dev/null
+++ b/system/doc/general_info/deprecations_27.md
@@ -0,0 +1,16 @@
+### Archives
+
+The following features for archives are deprecated:
+
+* Using archives for packaging a single application or parts of a
+  single application into an archive file that is included in the code
+  path.
+
+* All functionality to handle archives in module
+  [`erl_prim_loader`](https://www.erlang.org/doc/man/erl_prim_loader).
+
+* The `-code_path_choice` flag for `erl`.
+
+Using a single archive file for holding BEAM files and other data
+files in an Escript is **not** deprecated. However, to access files in
+the archive the `escript:extract/2` function has to be used.
diff --git a/system/doc/general_info/scheduled_for_removal_28.md b/system/doc/general_info/scheduled_for_removal_28.md
new file mode 100644
index 0000000000..b13f604aa8
--- /dev/null
+++ b/system/doc/general_info/scheduled_for_removal_28.md
@@ -0,0 +1,14 @@
+### Archives
+
+The following features of archives will be removed:
+
+* Using archives for packaging a single application or parts of a single application
+  into an archive file that is included in the code path.
+
+* All functionality to handle archives in module `m:erl_prim_loader`.
+
+* The `-code_path_choice` flag for `erl`.
+
+The functionality to use a single archive file in Escripts is **not**
+deprecated and will continue to work.  However, to access files in the
+archive, the `escript:extract/2` function has to be used.
-- 
2.35.3

Places

File 3141-archives-Formally-deprecate-and-schedule-for-removal.patch of Package erlang

Places