add NEWS / documentation for --emacs-loadpath

These are related because the NEWS points to the new documentation

2 files changed, 27 insertions, 0 deletions

diff --git a/debian/NEWS b/debian/NEWS
index f9623d5..8e69406 100644
--- a/debian/NEWS
+++ b/debian/NEWS
@@ -1,3 +1,16 @@
+dh-elpa (1.12) experimental; urgency=medium
+
+  This version of dh_elpa switches to using --quick for
+  byte-compilation. This means that the previous automatic handling of
+  non-elpa-* byte-compilation (package install time) dependencies is
+  removed. There are two solutions for maintainers of packages with
+  non-elpa-* dependencies. A long term solution is to convince the
+  maintainers of your dependencies to use dh-elpa; a local fix is to
+  add an --emacs-loadpath option to debian/rules. See dh_elpa(1) for
+  details.
+
+ -- David Bremner <bremner@debian.org>  Sun, 07 Jan 2018 13:49:06 -0400
+
 dh-elpa (0.0.20) unstable; urgency=medium
 
   This version of dh_elpa will try to run any ERT and Buttercup test
diff --git a/dh_elpa.in b/dh_elpa.in
index 9d5e034..0b70895 100755
--- a/dh_elpa.in
+++ b/dh_elpa.in
@@ -316,6 +316,20 @@ Here is an example of using the helper in a dh(1) style debian/rules
 
 =back
 
+Here is a more complex dh(1) style debian/rules, where the package
+needs some non-dh-elpa emacs addon I<fubar-el>
+
+=over 4
+
+    #!/usr/bin/make -f
+    %:
+        dh $@ --with elpa
+
+    override_dh_elpa:
+        dh_elpa --emacs-loadpath="/usr/share/emacs/site-lisp/fubar-el"
+
+=back
+
 Here is an example of a binary package stanza using dh_elpa generated
 substvars