From 5c0574c296ba0a1f0951f5d217f05fad0f1fcb00 Mon Sep 17 00:00:00 2001
From: Silvio Rhatto <rhatto@riseup.net>
Date: Thu, 5 Sep 2013 23:59:23 -0300
Subject: Adding initial development guidelines

---
 development.mdwn | 38 ++++++++++++++++++++++++++++++++++++++
 index.mdwn       |  4 ++++
 2 files changed, 42 insertions(+)
 create mode 100644 development.mdwn

diff --git a/development.mdwn b/development.mdwn
new file mode 100644
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 7ed01a6..f147d44 100644
--- 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).
-- 
cgit v1.2.3