From 5327438e780341411e5ddd702f53a742ccb39233 Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Wed, 3 Apr 2024 12:39:01 +0200 Subject: tighten markup --- ADMIN.md | 33 ++++++++++++++++++++------------- DEVELOP.md | 53 +++++++++++++++++++++++++++++++++++++---------------- 2 files changed, 57 insertions(+), 29 deletions(-) diff --git a/ADMIN.md b/ADMIN.md index cd2bb3e..c20205b 100644 --- a/ADMIN.md +++ b/ADMIN.md @@ -10,26 +10,33 @@ ## System upgrade -Make sure your current system is up-to-date: +Make sure your current system is up-to-date. +Check files that only current release is used. +Then update and upgrade: - * Check /etc/apt/sources.list* files that only current release is used. - * Update and upgrade: +```shell +apt update +apt upgrade +``` - apt update; apt upgrade +Make sure that all auto-installed packages are marked as such. +Start aptitude in fullscreen mode: -Make sure that all auto-installed packages are marked as such: +```shell +aptitude -u +``` - * Start aptitude in fullscreen mode: - - aptitude -u +In aptitude...: * Check each installed package: Flag as auto-installed as appropriate * Remove no longer used packages as needed (press "g" twice). -Double-check packages unneeded for or alien to current release: - - * Compute package lists: +Double-check packages unneeded for or alien to current release. +Compute package lists: - localbackuppkglists +```shell +localbackuppkglists +``` - * locate and inspect aliens and explicits below /etc/*/localpkglists.* +After running the above, +locate and inspect aliens and explicits below . diff --git a/DEVELOP.md b/DEVELOP.md index cd2a59f..047adb2 100644 --- a/DEVELOP.md +++ b/DEVELOP.md @@ -2,13 +2,15 @@ ## Create build environment - localcowbuilder-create jessie - +```shell +localcowbuilder-create jessie +``` ## Refresh build environment - localcowbuilder-update jessie - +```shell +localcowbuilder-update jessie +``` ## Build package @@ -16,45 +18,64 @@ Minimal steps involved in building a new package: Refresh copyright file: - debian/rules pre-build DEB_MAINTAINER_MODE=1; debian/rules clean DEB_MAINTAINER_MODE=1 +```shell +DEB_MAINTAINER_MODE=1 debian/rules pre-build +DEB_MAINTAINER_MODE=1 debian/rules clean +``` Resolve changelog from git commits: - gbp dch -a +```shell +gbp dch -a +``` Finalize changelog (manually merge/drop items to reflect only product): - dch -r +```shell +dch -r +``` Build in clean chroot and tag as final: - localgitcowdebuild sid --git-tag +```shell +localgitcowdebuild sid --git-tag +``` Compare built binaries against previous ones (in MC shell): - debdiff --controlfiles ALL --wl %f %D/%F | less +```shell +debdiff --controlfiles ALL --wl %f %D/%F | less +``` Check lintian warnings/errors: - lintian *.changes +```shell +lintian *.changes +``` Rebuild source-only package (to save bandwidth uploading, and for official rebuild): - localgitcowdebuild sid -S +```shell +localgitcowdebuild sid -S +``` Sign and upload: - debsign %f && dput %f - +```shell +debsign %f && dput %f +``` ## Backport package for main architecture - localcowdebuild jessie -sa - +```shell +localcowdebuild jessie -sa +``` ## Backport package for secondary architecture - localcowdebuild jessie-ia32 -b +```shell +localcowdebuild jessie-ia32 -b +``` -- cgit v1.2.3