From cca92fc15bce0de625a42b1b87b7a31e9fd75fe0 Mon Sep 17 00:00:00 2001
From: P. J. McDermott <pjm@nac.net>
Date: Sat, 21 Jul 2012 14:50:32 -0400
Subject: Add comments to "builddsc" command.

---
(limited to 'src')

diff --git a/src/deb.sh b/src/deb.sh
index 741bc1d..3531a2e 100755
--- a/src/deb.sh
+++ b/src/deb.sh
@@ -306,17 +306,21 @@ EOF
 
 	pkg="${1}"
 
+	# Find source package in internal list.
 	line="$(grep "^${pkg} " "${DEB_DIR}/dsc.list")" || \
 		error 'Package "%s" not found' "${pkg}"
 	dsc="${line#${pkg} }"
 	dsc="${dsc##*/}"
 
+	# Ensure that source package is unpacked.
 	[ ! -d "${DEB_TREE}/work/${pkg}/${pkg}-*" ] && \
 		error 'Source package "%s" not unpacked for editing' "${pkg}"
 
+	# Get source package version from internal list.
 	oldverrev="${dsc%.dsc}"
 	oldverrev="${oldverrev#${pkg}_}"
 
+	# Get source package version from work area.
 	verrev="$(dpkg-parsechangelog \
 		-l"${DEB_TREE}/work/${pkg}/${pkg}-*/debian/changelog" | \
 		sed -n 's/^Version: \(.*\)$/\1/p')"
@@ -324,16 +328,20 @@ EOF
 	ver="${verrev%-*}"
 	rev="${verrev#*-}"
 
+	# Ensure that an NMU was made.
 	dpkg --compare-versions "${verrev}" gt "${oldverrev}" || \
 		error 'Version not incremented'
 
+	# Build source package.
 	cd "${DEB_TREE}/work/${pkg}/${pkg}-*"
 	dpkg-buildpackage -S -us -uc
 
+	# Make a clean source package destination.
 	cd ..
 	rm -Rf "${DEB_TREE}/pkgs/${pkg}"
 	mkdir -p "${DEB_TREE}/pkgs/${pkg}"
 
+	# Copy source package files.
 	while read line; do
 		if [ "${line#Files:}" != "${line}" ]; then
 			while read sum size file; do
@@ -343,6 +351,7 @@ EOF
 	done < "${pkgverrev}.dsc"
 	cp -p "${pkgverrev}.dsc" "${pkgverrev}_source.changes" "${DEB_TREE}/pkgs/${pkg}"
 
+	# Generate patch.
 	debdiff \
 		"${DEB_TREE}/dsc/${pkg}/${dsc}" "${DEB_TREE}/pkgs/${pkg}/${base}.dsc" \
 		> "${DEB_TREE}/pkgs/${pkg}/${pkg}.debdiff"
--
cgit v0.9.1