summaryrefslogtreecommitdiff
path: root/README.org
blob: 1ff2d39c855a366582ce622a76a1348419188065 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
* Intro

This is a work-in progress project to generate Debian packages of
Emacs Lisp extensions that integrate with the built in (since GNU
Emacs 24.1) package system package.el. This means that debian packages
built with this tool will show up in M-x list-packages, and that user
installs of more up to date packages will override them (for that
user!). Perhaps the most important improvement is that no file
/etc/emacs/site-start.d is needed for such a package.

* Limitations

This is currently at the proof of concept stage. It currently deals
only with single file packages, and does not support byte compilation.
The latter limitation may require some coordination with the
emacsen-common maintainer to refine the notion of
"flavours". Package.el currently understands
/usr/share/emacs/site-lisp and /usr/share/emacs/${VERSION}/site-lisp
where VERSION is e.g. 24.5.

* Usage

Here is an example of using the helper command (extracted from
a previous debian/rules in this package).

#+BEGIN_EXAMPLE
override_dh_auto_install:
        ./dh_elpa dh-elpa.el
#+END_EXAMPLE