From 91275ac998c439420da747fc047379a6547f7c1c Mon Sep 17 00:00:00 2001
From: Silvio Rhatto <rhatto@riseup.net>
Date: Sat, 24 Feb 2024 14:20:19 -0300
Subject: Feat: convert docs from Ikiwiki to MkDocs

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

(limited to 'docs/basics.md')

diff --git a/docs/basics.md b/docs/basics.md
new file mode 100644
index 0000000..6eafa91
--- /dev/null
+++ b/docs/basics.md
@@ -0,0 +1,74 @@
+# 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 packages/$package
+    cd packages/$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
-- 
cgit v1.2.3