[Buildroot] [PATCH 15/15 v2] docs/manual: document new archive version suffix

[Yann E. MORIN]

Signed-off-by: Yann E. MORIN <yann.morin.1998 at free.fr>
---
 docs/manual/migrating.adoc | 26 ++++++++++++++++++++++----
 1 file changed, 22 insertions(+), 4 deletions(-)

diff --git a/docs/manual/migrating.adoc b/docs/manual/migrating.adoc
index ed9b61257a..0a4cfdbe49 100644
--- a/docs/manual/migrating.adoc
+++ b/docs/manual/migrating.adoc
@@ -127,7 +127,25 @@ that such patches will most probably not be accepted.
 [[migrating-git-attributes]]
 === Migrating to 2024.05
 
-The git download backend now properly expands the `export-subst`
-https://git-scm.com/docs/gitattributes[git attribute] when generating
-archives; the archive version suffix has been updated, to +-br2+, so the
-hash files must be updated accordingly.
+The download backends have been extended in varios ways:
+* all locally generated tarballs are even mor ereproducible: before
+  2024.05, it was possible that the access mode of files in the archives
+  were not consistent when the download directory has specific ACLs (e.g.
+  with the +default+ extended attributes set); this impacts the archvies
+  generated for git and subversion repositories, as well as those
+  for vendored cargo and go packages
+* the git download backend now properly expands the `export-subst`
+  https://git-scm.com/docs/gitattributes[git attribute] when generating
+  archives.
+
+To acco;odate those changes, the archive suffix has been updated or
+added:
+* fot git: +-git3+
+* for subversion: +-svn4+
+* for cargo (rust) packages: +-cargo1+
+* for go packages: +-go1+
+
+Note that, if two such prefix would apply to a generated archive, like
+for a cargo package downloaded from git, both suffixes need to be added,
+first the one for the download mechanism, then the one for the vendoring,
+e.g.: +libfoo-1.2.3-git3-cargo1.tar.gz+.
-- 
2.44.0