From ea90353f8bfb47ab10e6e4629a8f2e8cfba3adf5 Mon Sep 17 00:00:00 2001
From: David Bremner <bremner@debian.org>
Date: Thu, 29 Oct 2015 07:49:06 -0300
Subject: document substvars

---
 dh_elpa.in | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

(limited to 'dh_elpa.in')

diff --git a/dh_elpa.in b/dh_elpa.in
index 7a196e6..8803f42 100755
--- a/dh_elpa.in
+++ b/dh_elpa.in
@@ -235,6 +235,23 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
 
 }
 
+=head1 SUBSTVARS
+
+dh_elpa currently defines two substvars (cf. deb-substvars(5)) that
+can be used in debian/control
+
+=over 4
+
+=item ${misc:Depends}
+
+These are dependencies needed by every dh_elpa based package.
+
+=item ${misc:Built-Using}
+
+This adds a value suitable for a Built-Using header identifying the version of dh_elpa used at build time.
+
+=back
+
 =head1 EXAMPLES
 
 Here is an example of using the helper in a dh(1) style debian/rules
@@ -247,5 +264,18 @@ override_dh_install:
 
 =back
 
+Here is an example of a binary package stanza using dh_elpa generated substvars
+
+=over 4
+
+    Package: elpa-hello
+    Architecture: all
+    Depends: ${misc:Depends}
+    Built-Using: ${misc:Built-Using}
+    Description: Emacs addon to say hello
+     The Emacs editor addon likes to wave and say hello.
+
+=back
+
 =cut
 
-- 
cgit v1.2.3