package/pkg-generic: don't download svn externals by default

Commit 7dd27cbe5b (support/download: add support to exclude svn
externals) departed from the usual opt-in scheme, like is done for
git submodule or large files, in an attempt to keep the previous
behaviour unchanged, that is to download externals by default.

As an afterthought, we've concluded that the chances for svn-hosted
packages with externals that are indeed required to do the build,
are relatively slim. For those cases, it even makes sense to explicitly
requested the use of the externals.

So, we change the default to not download svn externals.

Since the generated archives may change, we bump the version suffix.
This will allow users to more easily catch the situation and decide if
they really need the externals or not.

We have a single in-tree package that uses svn, and it does not use
externals, so the generated archive does not change, and we just need
to update the archive filename in the hash file.

Finally, we add a new section to the manual, in the chapter about
migrating Buildroot to a newer version.

Reported-by: Thomas Petazzoni <thomas.petazzoni@bootlin.com>
Signed-off-by: Yann E. MORIN <yann.morin@orange.com>
Signed-off-by: Yann E. MORIN <yann.morin.1998@free.fr>
This commit is contained in:
Yann E. MORIN
2023-08-08 15:17:41 +02:00
committed by Yann E. MORIN
parent 80a1e728b0
commit bf2d7f8f53
5 changed files with 19 additions and 11 deletions

View File

@@ -347,11 +347,9 @@ not and can not work as people would expect it should:
Git LFS to store large files out of band. This is only available for
packages downloaded with git (i.e. when +LIBFOO_SITE_METHOD=git+).
+ +LIBFOO_SVN_EXTERNAL+ can be set to +YES+ (the default) to specify
whether to retrieve the svn external references, or to +NO+ to avoid
retrieving those externals. Note that, contrary to other similar
options like +LIBFOO_GIT_SUBMODULES+ or +LIBFOO_GIT_LFS+, the default
here is to actually retrieve the externals; this is a legacy heritage.
+ +LIBFOO_SVN_EXTERNALS+ can be set to +YES+ to create an archive with
the svn external references. This is only available for packages
downloaded with subversion.
* +LIBFOO_STRIP_COMPONENTS+ is the number of leading components
(directories) that tar must strip from file names on extraction.

View File

@@ -86,3 +86,17 @@ Whenever a package installs an executable that is linked with a library
in +$(HOST_DIR)/lib+, it must have an RPATH pointing to that directory.
An RPATH pointing to +$(HOST_DIR)/usr/lib+ is no longer accepted.
[[migrating-svn-externals]]
=== Migrating to 2023.11
Before Buildroot 2023.11, the subversion download backend unconditionally
retrieved the external references (objects with an `svn:externals`
property). Starting with 2023.11, externals are no longer retrieved by
default; if you need them, set +LIBFOO_SVN_EXTERNALS+ to +YES+. This
change implies that:
* the generated archive content may change, and thus the hashes may need
to be updated appropriately;
* the archive version suffix has been updated to +-br3+, so the hash
files must be updated appropriately.