lint(checkdoc): add docstring, edit 2 docstrings

I've named it contrapunctus.mk to avoid getting clobbered by the
autogenerated Makefile. If we do away with the autotools stuff, we
could rename it Makefile.

.dir-locals.el

@@ -0,0 +1,26 @@
+;; `nameless-current-name' cannot be detected in Org mode buffers,
+;; IIRC, and thus has to be defined explicitly. To make use of this,
+;; install `nameless' and enable `nameless-mode' in Org mode buffers.
+((nil . ((nameless-current-name . "jabber")
+         (nameless-aliases . (("jaa" . "jabber-autoaway")
+                              ("ja"  . "jabber-avatar")
+                              ("jac" . "jabber-activity")
+                              ("jc"  . "jabber-chat")
+                              ("jco" . "jabber-console")
+                              ("jcs" . "jabber-chatstates")
+                              ("je"  . "jabber-events")
+                              ("jh"  . "jabber-history")
+                              ("jk"  . "jabber-keepalive")
+                              ("jm"  . "jabber-muc")
+                              ("jml" . "jabber-mode-line")
+                              ("jr"  . "jabber-roster")
+                              ("jp"  . "jabber-private")
+                              ("jrt" . "jabber-rtt")
+                              ("js"  . "jabber-socks5")
+                              ("jv"  . "jabber-vcard")
+                              ("jw"  . "jabber-whitespace")
+                              ("jx"  . "jabber-xml")))))
+ (org-mode . ((org-tags-column . -60)
+              (eval . (progn
+                        (make-local-variable 'before-save-hook)
+                        (add-hook 'before-save-hook #'org-align-all-tags nil t))))))

contrapunctus.mk

@@ -0,0 +1,56 @@
+.phony: all setup tangle compile lint clean
+
+all: setup tangle compile lint
+
+setup:
+	emacs --batch --eval="(package-initialize)" \
+	--eval="(mapcar #'package-install '(indent-lint package-lint relint))"
+
+# No -q or -Q without ORG_PATH - if the user has a newer version of
+# Org, we want to use it.
+jabber.el:
+	if [ -z "${ORG_PATH}" ]; then \
+          echo ; \
+	  echo "[WARNING] ORG_PATH is unset. Org versions older than 9.3.8 have a bug" ; \
+	  echo "which result in them always using absolute paths in comment links in" ; \
+	  echo "tangled source files. If your Org version is older than 9.3.8, please" ; \
+	  echo "upgrade it before tangling." ; \
+          echo ; \
+          emacs --batch \
+          --eval="(require 'ob-tangle)" \
+          --eval='(org-babel-tangle-file "jabber.org")' ; \
+        else \
+          emacs -q -Q --batch \
+          --eval="(add-to-list 'load-path \"${ORG_PATH}\")" \
+          --eval="(require 'ob-tangle)" \
+          --eval='(org-babel-tangle-file "jabber.org")' ; \
+        fi
+
+tangle: jabber.el
+
+compile: tangle
+	emacs -q -Q --batch --eval='(byte-compile-file "jabber.el")' ; \
+
+lint-check-declare: tangle
+	emacs -q -Q --batch --eval='(check-declare-file "jabber.el")'
+
+lint-checkdoc: tangle
+	emacs -q -Q --batch --eval='(checkdoc-file "jabber.el")'
+
+lint-package-lint: setup tangle
+	emacs -Q --batch --eval='(package-initialize)' \
+        --eval="(require 'package-lint)" \
+        -f 'package-lint-batch-and-exit' jabber.el
+
+lint-relint: setup tangle
+	emacs -q -Q --batch --eval='(relint-file "jabber.el")'
+
+lint: lint-check-declare lint-checkdoc lint-package-lint lint-relint
+
+clean-tangle:
+	-rm jabber.el
+
+clean-elc:
+	-rm *.elc
+
+clean: clean-elc