summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--DEVELOP.md60
1 files changed, 60 insertions, 0 deletions
diff --git a/DEVELOP.md b/DEVELOP.md
new file mode 100644
index 0000000..6cded91
--- /dev/null
+++ b/DEVELOP.md
@@ -0,0 +1,60 @@
+# System development
+
+## Create build environment
+
+ localcowbuilder-create jessie
+
+
+## Refresh build environment
+
+ localcowbuilder-update jessie
+
+
+## Build package
+
+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
+
+Resolve changelog from git commits:
+
+ gbp dch -a
+
+Finalize changelog
+(manually merge/drop items to reflect only product):
+
+ dch -r
+
+Build in clean chroot and tag as final:
+
+ localgitcowdebuild sid --git-tag
+
+Compare built binaries against previous ones
+(in MC shell):
+
+ debdiff --controlfiles ALL --wl %f %D/%F | less
+
+Check lintian warnings/errors:
+
+ lintian *.changes
+
+Rebuild source-only package
+(to save bandwidth uploading, and for official rebuild):
+
+ localgitcowdebuild sid -S
+
+Sign and upload:
+
+ debsign %f && dput %f
+
+
+## Backport package for main architecture
+
+ localcowdebuild jessie -sa
+
+
+## Backport package for secondary architecture
+
+ localcowdebuild jessie-ia32 -b