Adding initial development guidelines

diff --git a/development.mdwn b/development.mdwn
new file mode 100644 (file)
index 0000000..874a408
--- /dev/null
+++ b/development.mdwn
@@ -0,0 +1,38 @@
+[[!meta title="Keyringer: development guidelines"]]
+
+Preparing the source code:
+
+    make build_man
+
+Commit and tag release:
+
+    git checkout master
+    git commit -m "Keyringer 0.1"
+    git tag -s
+    git checkout upstream
+    git merge master
+    git checkout debian
+    git merge master
+    git push --tags
+
+Creating the `debian/` structure:
+
+    dh_make -p keyringer_0.1 --createorig
+
+Creating a release file:
+
+    git archive --format=tar HEAD | gzip >../tarballs/keyringer-0.1.tar.gz
+
+To generate a `keyringer_0.1.orig.tar.gz`-line file:
+
+    dh_make -f ../tarballs/keyringer-0.1.tar.gz -p keyringer_0.1
+
+Building a package from the git three using the upstream branch:
+
+    git-buildpackage
+
+References:
+
+* [Using Git for Debian Packaging](http://www.eyrie.org/~eagle/notes/debian/git.html).
+* [Building packages from the Git repository](http://honk.sigxcpu.org/projects/git-buildpackage/manual-html/gbp.building.html).
+

diff --git a/index.mdwn b/index.mdwn
index 7ed01a6cf1f3e6c0bb3a209ac2f01205c384fa21..f147d44d183dabc04338e423c65c506602890a91 100644 (file)
--- a/index.mdwn
+++ b/index.mdwn
@@ -216,3 +216,7 @@ Optional dependencies if you want to manage ssl keys:
 
   - [OpenSSL](http://www.openssl.org)
 
+Development guidelines
+----------------------
+
+See [development](development).