Debianization -> debianization.mdwn

[wiki.git] / doc / debianization.mdwn

diff --git a/doc/debianization.mdwn b/doc/debianization.mdwn
new file mode 100644 (file)
index 0000000..417555b
--- /dev/null
+++ b/doc/debianization.mdwn
@@ -0,0 +1,22 @@
+[[!meta title="Debianization"]]
+
+This document is a brief introduction to how to Debianize a piece of
+software, i.e. to create a package for a Debian or Ubuntu distribution
+so that it can be managed alongside other system software.
+
+You'll need a few packages for doing Debian development, so you should run
+
+`$ sudo aptitude install build-essential dh-make devscripts cdbs equivs lintian dpatch quilt dpkg-dev`
+
+If you're a fan of Emacs as a text editor, you should also run
+
+`$ sudo aptitude install debian-el devscripts-el dpkg-dev-el`
+
+## Preparing the source
+
+To prepare a source directory for Debianization, you'll first want to
+rename the directory to the form <package>-<version>.
+
+## Everything else
+
+This article is a stub.  You can help by expanding it.