[gentoo-commits] proj/portage:master commit in: bin/

[Sam James]

commit:     3f1e03e53470f6ec495ea8514fd448ffd99ec65c
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Sun Jan  4 14:15:15 2026 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Sun Jan  4 14:15:15 2026 +0000
URL:        https://gitweb.gentoo.org/proj/portage.git/commit/?id=3f1e03e5

bin: add comment wrt packdebug choice of xz

As explained in 333ca73072b5f3628a2913c136c5c5b52a371bf5, but let's
add a comment here to be clear it's not an oversight.

Signed-off-by: Sam James <sam <AT> gentoo.org>

 bin/misc-functions.sh | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/bin/misc-functions.sh b/bin/misc-functions.sh
index cf287933da..0aea28b7c9 100755
--- a/bin/misc-functions.sh
+++ b/bin/misc-functions.sh
@@ -513,6 +513,8 @@ __generate_packdebug() {
        install -d "${debugpath}"/"${CATEGORY}"{,/"${PN}"} \
                || die "Failed to generate target debug directory"
 
+       # xz is hardcoded here as it's the only format that supports random
+       # access.
        (
                unset IFS
                local 
tarfile="${debugpath}/${CATEGORY}/${PN}/${PF}-${BUILD_ID}-debug.tar.xz"