summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--ADMIN.md33
-rw-r--r--DEVELOP.md53
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 </etc/apt/sources.list*> 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 </etc/*/localpkglists.*>.
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
+```