From 4e6889fd697787fc0df7980aefca94e60efe2b94 Mon Sep 17 00:00:00 2001
From: Silvio Rhatto <rhatto@riseup.net>
Date: Sun, 1 Oct 2017 17:16:02 -0300
Subject: Change markdown extension to .md

---
 basics.md | 92 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 basics.md

(limited to 'basics.md')

diff --git a/basics.md b/basics.md
new file mode 100644
index 0000000..2230118
--- /dev/null
+++ b/basics.md
@@ -0,0 +1,92 @@
+Basic packaging
+===============
+
+Configuration files
+-------------------
+
+All the commands in this guide assumes that you're using [these configuration files](https://git.fluxo.info/?p=rhatto/dotfiles/debian.git;a=summary).
+
+Starting a new package
+----------------------
+
+We use the `packages/` folder from this repo to store sources:
+
+    mkdir package/$package
+    cd package/$package
+
+Getting the debianized source
+-----------------------------
+
+Using `dget`:
+
+    dget $remote_dsc
+    cd $package*
+
+Using `apt-get`:
+
+    apt-get source package
+
+Checking the source
+-------------------
+
+See `checking.md`.
+
+Extracting the source
+---------------------
+
+If needed, do this after your successfully verified the sources:
+
+    dpkg-source -x *.dsc
+
+Getting dependencies
+--------------------
+
+To get:
+
+    apt-get build-dep package
+
+To remove:
+
+    hydractl remove-dep package
+
+Creating the `debian/` structure
+--------------------------------
+
+If the package wasn't debianized, proceed with
+
+    if [ ! -d "debian" ]; then
+      dh_make -p ${package}_${version} --createorig
+    fi
+
+Simple build
+------------
+
+    dch -i
+    dpkg-buildpackage -rfakeroot -sa -k$KEY_ID
+
+Creating a new debian source
+----------------------------
+
+    cd ..
+    dpkg-source -b $package*
+    debsign $package*.dsc
+
+Building and signing
+--------------------
+
+To generate signatures, remove `-uc` and `-us` from `dpkg-buildpackage` (see
+[Complete build](http://www.debian.org/doc/maint-guide/ch-build.pt-br.html#s-completebuild)):
+
+    dpkg-buildpackage -rfakeroot
+
+To sign using an specific key:
+
+    dpkg-buildpackage -rfakeroot -kKEY_ID
+
+WNPP
+----
+
+Before packaging anything, have a look at:
+
+* [WNPP](http://wnpp.debian.net).
+* [Debian Git](http://anonscm.debian.org/gitweb/).
-- 
cgit v1.2.3