xenial (1) dh_elpa.1.gz

NAME

       dh_elpa - install emacs lisp packages into package build directories

SYNOPSIS

       dh_elpa [debhelper options]  [pkg-file]

DESCRIPTION

       dh_elpa is a debhelper program that is responsible for installing elpa style emacs lisp packages into
       package build directories.

FILES

       debian/package.elpa
           List of files to be installed into package as an elpa package.

OPTIONS

       --byte-compile, --no-byte-compile
           Enable (default) or disable byte compilation of installed emacs lisp files.  Disabling byte
           compilation changes the destination directory to one that is found by the emacs package system.

       --fix-autoload-date, --no--fix-autoload-date
           Enable (default) or disable munging the dates in Emacs generated autoload files to match
           debian/changelog.

SUBSTVARS

       dh_elpa currently defines three substvars (cf. deb-substvars(5)) that can be used in debian/control

       ${misc:Depends}
           These are dependencies needed by every dh_elpa based package.

       ${misc:Built-Using}
           This adds a value suitable for a Built-Using header identifying the version of dh_elpa used at build
           time.

       ${elpa:Depends}
           These are dependencies on other ELPA packages as given in the Package-Requires: line of the package's
           main Emacs Lisp file.

           Note that Emacs Lisp dependencies packaged outside the elpa-* dpkg namespace must be specified
           manually.  For example, the s.el library is provided by the binary package s-el.  If dh_elpa adds
           dependency elpa-x where x is an Emacs Lisp binary package outside the elpa-* namespace, please file a
           bug against dh_elpa to have an exclusion added.

EXAMPLES

       Here is an example of using the helper in a dh(1) style debian/rules

           #!/usr/bin/make -f
           %:
               dh $@ --with elpa

       Here is an example of a binary package stanza using dh_elpa generated substvars

           Package: elpa-hello
           Architecture: all
           Depends: ${misc:Depends}, ${elpa:Depends}
           Built-Using: ${misc:Built-Using}
           Description: Emacs addon to say hello
            The Emacs editor addon likes to wave and say hello.