update documentation

   Add a readme to all packages, which includes references and diffs
   where applicable.

8 files changed, 14 insertions, 46 deletions

diff --git a/oddjob-mkhomedir/README.md b/oddjob-mkhomedir/README.md
new file mode 100644
index 0000000..1502d0c
--- /dev/null
+++ b/oddjob-mkhomedir/README.md
@@ -0,0 +1,13 @@
+# oddjob-mkhomedir upstream
+None
+
+# Reason for being in stackrpms
+This is a dummy package for making "oddjob-mkhomedir" installable so FreeIPA client can be installed. While other mkhomedir methods exist in Devuan, freeipa has a specifically-named dependency on oddjob-mkhomedir.
+
+# Reverse dependency matrix
+Distro       | freeipa-client version | oddjob-mkhomedir version
+------------ | ---------------------- | ------------------------
+Devuan ceres | 4.8.1                  | any
+
+# Differences from upstream
+None
diff --git a/oddjob-mkhomedir/debian/README.Debian b/oddjob-mkhomedir/debian/README.Debian
index 9ccbe51..eebf478 100644
--- a/oddjob-mkhomedir/debian/README.Debian
+++ b/oddjob-mkhomedir/debian/README.Debian
@@ -5,4 +5,4 @@ this oddjob-mkhomedir Debian package.
 
     (Automatically generated by debmake Version 4.3.1)
 
- -- Brian Girton <>  Fri, 20 Sep 2019 13:52:19 -0400
+ -- B Stack <bgstack15@gmail.com>  Fri, 20 Sep 2019 13:52:19 -0400
diff --git a/oddjob-mkhomedir/debian/oddjob-mkhomedir/DEBIAN/control b/oddjob-mkhomedir/debian/oddjob-mkhomedir/DEBIAN/control
deleted file mode 100644
index cf23fa1..0000000
--- a/oddjob-mkhomedir/debian/oddjob-mkhomedir/DEBIAN/control
+++ /dev/null
@@ -1,12 +0,0 @@
-Package: oddjob-mkhomedir
-Version: 0.0.1-1
-Architecture: all
-Maintainer: B Stack <bgstack15@gmail.com>
-Installed-Size: 10
-Section: misc
-Priority: optional
-Multi-Arch: foreign
-Homepage: https://gitlab.com/bgstack15/stackrpms
-Description: Dummy package for freeipa-client dependency
- This package is a stub and only designed to fool dpkg
- so you can install freeipa-client.
diff --git a/oddjob-mkhomedir/debian/oddjob-mkhomedir/DEBIAN/md5sums b/oddjob-mkhomedir/debian/oddjob-mkhomedir/DEBIAN/md5sums
deleted file mode 100644
index 92d29a7..0000000
--- a/oddjob-mkhomedir/debian/oddjob-mkhomedir/DEBIAN/md5sums
+++ /dev/null
@@ -1,4 +0,0 @@
-5fbdce809341c17753f5e91e89047ed3  usr/share/doc/oddjob-mkhomedir/README-oddjob-mkhomedir.md
-5aa08beaf32d4a7fe0e17c59854ba94e  usr/share/doc/oddjob-mkhomedir/README.Debian
-de5542c9595363e9fa94b674859b038d  usr/share/doc/oddjob-mkhomedir/changelog.Debian.gz
-f67b1a7b580c9c6f2d2c1fbf3e6d7068  usr/share/doc/oddjob-mkhomedir/copyright
diff --git a/oddjob-mkhomedir/debian/oddjob-mkhomedir/usr/share/doc/oddjob-mkhomedir/README-oddjob-mkhomedir.md b/oddjob-mkhomedir/debian/oddjob-mkhomedir/usr/share/doc/oddjob-mkhomedir/README-oddjob-mkhomedir.md
deleted file mode 100644
index c454a3d..0000000
--- a/oddjob-mkhomedir/debian/oddjob-mkhomedir/usr/share/doc/oddjob-mkhomedir/README-oddjob-mkhomedir.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# Introduction
-This oddjob-mkhomedir-0.0.1 directory is a dummy, which is designed to be installed on a Devuan system so you can install freeipa-client.
-This is the "source" contents that will be used to build a dpkg from the oddjob-mkhomedir/ directory in this same source tree.
-
-To actually make home directories upon user first login:
-
-    tf=/etc/pam.d/common-session ; ! grep -q 'mkhomedir' "${tf}" && { thisline="$(( $( grep -nE 'session\s+optional' "${tf}" | head -n1 | awk -F':' '{print $1}' ) - 0 ))" ; awk -v thisline="$thisline" 'NR == (thisline) {print "session optional        pam_mkhomedir.so"; } {print;}' "${tf}" > "${tf}.2" ; test -f "${tf}.2" && mv "${tf}.2" "${tf}" ; }
diff --git a/oddjob-mkhomedir/debian/oddjob-mkhomedir/usr/share/doc/oddjob-mkhomedir/README.Debian b/oddjob-mkhomedir/debian/oddjob-mkhomedir/usr/share/doc/oddjob-mkhomedir/README.Debian
deleted file mode 100644
index 9ccbe51..0000000
--- a/oddjob-mkhomedir/debian/oddjob-mkhomedir/usr/share/doc/oddjob-mkhomedir/README.Debian
+++ /dev/null
@@ -1,8 +0,0 @@
-oddjob-mkhomedir for Debian
-
-Please edit this to provide information specific to
-this oddjob-mkhomedir Debian package.
-
-    (Automatically generated by debmake Version 4.3.1)
-
- -- Brian Girton <>  Fri, 20 Sep 2019 13:52:19 -0400
diff --git a/oddjob-mkhomedir/debian/oddjob-mkhomedir/usr/share/doc/oddjob-mkhomedir/changelog.Debian.gz b/oddjob-mkhomedir/debian/oddjob-mkhomedir/usr/share/doc/oddjob-mkhomedir/changelog.Debian.gz
deleted file mode 100644
index d074bea..0000000
--- a/oddjob-mkhomedir/debian/oddjob-mkhomedir/usr/share/doc/oddjob-mkhomedir/changelog.Debian.gz
+++ /dev/null
diff --git a/oddjob-mkhomedir/debian/oddjob-mkhomedir/usr/share/doc/oddjob-mkhomedir/copyright b/oddjob-mkhomedir/debian/oddjob-mkhomedir/usr/share/doc/oddjob-mkhomedir/copyright
deleted file mode 100644
index 49e65e3..0000000
--- a/oddjob-mkhomedir/debian/oddjob-mkhomedir/usr/share/doc/oddjob-mkhomedir/copyright
+++ /dev/null
@@ -1,14 +0,0 @@
-Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
-Upstream-Name: oddjob-mkhomedir
-Source: <url://example.com>
-#
-# Please double check copyright with the licensecheck(1) command.
-
-Files:     README-oddjob-mkhomedir.md
-           oddjob-mkhomedir.sh
-Copyright: __NO_COPYRIGHT_NOR_LICENSE__
-License:   __NO_COPYRIGHT_NOR_LICENSE__
-
-#----------------------------------------------------------------------------
-# Files marked as NO_LICENSE_TEXT_FOUND may be covered by the following
-# license/copyright files.