CONF.sh: clarify expected layout below LOCALDEBS

Getting support for local packages (*.deb and/or *.udeb) to work
consistently has been a gigantic time sink, never again!

Document the expected layout as precisely as possible, so that
unsuspecting users have a better chance of getting things right!
This commit is contained in:
Cyril Brulebois 2023-01-27 05:24:03 +01:00
parent 8bba3df865
commit eb6d140f48
1 changed files with 19 additions and 2 deletions

21
CONF.sh
View File

@ -157,8 +157,25 @@ export FORCE_FIRMWARE=1
# export LOCAL=1
# If your local packages are not under $MIRROR, but somewhere else,
# you can uncomment this line and edit to to point to a directory
# containing dists/$CODENAME/local/binary-$ARCH
# you can uncomment this line and edit it to point to a directory
# containing:
# - dists/$CODENAME/local/binary-$ARCH/*.deb
# - dists/$CODENAME/local/debian-installer/binary-$ARCH/*.udeb
#
# Some metadata must exist for those packages to be considered:
# - dists/$CODENAME/local/binary-$ARCH/Packages.(gz|xz)
# - dists/$CODENAME/local/debian-installer/binary-$ARCH/Packages.(gz|xz)
#
# and apt will likely want a top-level Release file as well, and
# possibly uncompressed Packages files as well in each directory:
# - dists/$CODENAME/Release
# - dists/$CODENAME/local/binary-$ARCH/Packages
# - dists/$CODENAME/local/debian-installer/binary-$ARCH/Packages
#
# At least that's what was observed while updating easy-build.sh (which
# has an UPDATE_LOCAL=1 setting, controlling whether to run Packages-gen)
# for year 2023, good luck! -- kibi
#
# export LOCALDEBS=/home/joey/debian/va/debian
# Where to find the security patches. This directory should be the