|author||Sean Whitton <firstname.lastname@example.org>||2016-08-12 18:53:11 -0700|
|committer||Sean Whitton <email@example.com>||2016-08-12 18:53:22 -0700|
better output & docs for when DEB_* isn't enough
Diffstat (limited to 'dh_elpa.in')
1 files changed, 9 insertions, 6 deletions
@@ -326,9 +326,10 @@ substvars
If dh_elpa can't determine the package version by looking at *.el
files (usually because upstream has failed to include the proper
-headers), it will fallback to the DEB_UPSTREAM_VERSION and
-DEB_VERSION_UPSTREAM environment variables. An easy way to set one of
-these is just to prepend the following to your rules file:
+headers or *-pkg.el file), it will fallback to the
+DEB_UPSTREAM_VERSION and DEB_VERSION_UPSTREAM environment variables.
+An easy way to set one of these is just to prepend the following to
+your rules file:
@@ -337,6 +338,8 @@ these is just to prepend the following to your rules file:
-Note that this will fail in certain cases where the Debian upstream
-version cannot be translated into an adequate Emacs version string.
-See the documentation for the `dhelpa-sanitise-version' function.
+Certain Debian upstream version strings cannot be translated into
+version strings Emacs will accept (see the docstring for the Emacs
+function `version-to-list' for details). dh_elpa will error out if
+the version cannot be translated. You should resort to patching in a
+Package-Version header or adding a *-pkg.el file.