Adapting PBA to new Debian Release

Introduction

About every 2 years Debian introduces a new release.

The following notes shall provide a step-by-step-plan for adapting the PBA Package Builder + Archiver to a new Debian release and shall make it more efficient for the next Debian.

The first version of this page was created when Debian Buster was on it's way from Full Freeze to GA.

Currently we are in the progress of adapting to Debian Bullseye, and we have switched from svn to git. Currently this is WORK IN PROGRESS rg. Bullseye.

Adapting pba to new Debian Release

Preprations

OLDDN=stretch
NEWDN=buster

# we prefix name of feature branches issue number or epic numbers
ISSUENR="e1"BRANCHNAME="${ISSUENR}_adapt_to_debian_11_${NEWDN}" ; echo "Branch name: ${BRANCHNAME}"

Adaptions for phase 1, towards GA

In phase 1 we make the new distribution known in the sense of adding a template for distributions.d/.

cd ~/sources/pba/git/pba

git checkout main ; git pull ; git checkout main

git branch ${BRANCHNAME} && git checkout ${BRANCHNAME} && git status

git push --set-upstream origin ${BRANCHNAME}

cat src/etc/pba/distributions.d/${OLDDN} |sed -e "s/${OLDDN}/${NEWDN}/g" >src/etc/pba/distributions.d/${NEWDN}
git add src/etc/pba/distributions.d/${NEWDN}

# evtl. drop ancient ones
git rm src/etc/pba/distributions.d/foobar

${EDITOR:-vi} debian/changelog debian/rules debian/pba-common.install src/etc/pba/distributions.d/${NEWDN} debian/control
# src/etc/pba/builder.conf.template src/lib/build-functions.pl

# commit
git commit -m "Adding support for new Debian distro ${NEWDN}"

# release it
pba-release

Adapt HelloWorld Projects

cd ~/sources/pba/trunk/pba-helloworld

git checkout main ; git pull ; git checkout main

git branch ${BRANCHNAME} && git checkout ${BRANCHNAME} && git status

git push --set-upstream origin ${BRANCHNAME}

pba-raiseversion
# decide next version
pba-raisversion -b 1.2.3 "Adding new Debian target distro ${NEWDN}"

git add debian*/control debian*/changelog

PBAO="."
# or
PBAO="arch|unix"
# or in phase 2 or when combining
PBAO="arch|unix|7"

#pba-builddeps -i -o ${PBAO}

#pba-instdeps -i -o ${PBAO}

pba-build -u -i -o ${PBAO}

# solve eventual problems

PBADD=$(ls -1d debian* |grep -v mingw |head -1)
${EDITOR:-vi} ${PBADD}/changelog ${PBADD}/control

pba-localbuild -u -o ${PBAO}

# evtl.
#pba-localrpmbuild -u -o ${PBAO}

# wait for success

git commit -m "Adding support for new Debian distro ${NEWDN}"
git push

# optional, eventually after merge in main
pba-release -o ${PBAO}

LATER (after adapting Fancylibs below) repeat for pba-helloworld-portable (with -o unix).

Repeat for pba-hellolib-portable (with -o unix).

Repeat for pba-hellobigworld-portable (with -o unix).

... with -o unix or later -o "unix|9".

Adapt FancyLibs

--- current point of adaption to Debian Bullseye ---

See Adapting FancyLibs & MinGW-Pkg from Debian 9 Stretch to 10 Buster, Mingw-7 to Mingw-8.

Adapt pba-helloworld-portable

See above, use -o unix.

Create PBA-Builder tarballs

See eventual separate notes (my ITEG's PBA-Tarball Notes are not public, sorry).

Adapt MinGW

See mingw 6 rebuild order.

MinGW-Adapt pba-hello*-portable

See above, with -o "unix|9" instead of "-o unix".

Adaptions for phase 2, once new release is settled

Once the new Debian release is settled and all VIP libraries and current projects can be built for it, we can declare it the new default value for DefaultDistribution in pba-builder.conf.

${EDITOR:-vi} debian/changelog src/etc/pba/builder.conf.template src/lib/build-functions.pl

# commit
git commit -m "Making new Debian distro ${NEWDN} default for DefaultDistribution in pba-builder.conf"

# release it
pba-release