diff options
Diffstat (limited to 'dh_elpa.in')
-rwxr-xr-x | dh_elpa.in | 33 |
1 files changed, 15 insertions, 18 deletions
@@ -423,27 +423,24 @@ environment variable in debian/rules: You can also specify the name on a per binary package basis with C<ELPA_NAME_binary-package-name>=tpp-mode. -=head2 Debian specific customizations - -Pre-B<dh_elpa> packages using C<emacsen-common> typically had an Emacs -Lisp file C<debian/emacsen-startup> which is installed into -C</etc/emacs/site-start.d>. One of the most important functions these -files was the correct setting of C<load-path> to make the package -available to users; this is no longer required as it is handled by the -Emacs Package system when generating I<elpa-package>-autoloads.el. -This means that many packages do not need any debian specific -configuration. - -Other kinds of configuration can be handled by adding the special -I<autoload cookie> in front of a form to be run at package -initialization time. These forms are added to -I<elpa-package>-autoloads.el, which is B<not> in C</etc/>. This -simplifies package maintenance. +=head2 Debian-specific Lisp customizations + +With B<dh_elpa>, the file C<debian/emacsen-startup> is no longer +required to ensure that C<load-path> is properly set. This means that +most packages do not require a C<debian/emacsen-startup> file at all. + +If you do need other configuration to be executed, add the special +I<autoload cookie> in front of a form, and it will be run at package +initialization time. This is better than using +C<debian/emacsen-startup> because the forms are then added to +I<elpa-package>-autoloads.el, rather than a file in C</etc/>, as the +contents of C<debian/emacsen-startup> was. This simplifies package +maintainance. These cookies can either annotate upstream source, or be added (along with the relevant forms) to a file in C<debian/>, by convention -C<debian/debian-autoloads.el>. Currently you will have manually -include that file in debian/I<package>.elpa. +C<debian/debian-autoloads.el>. That file must then be listed in +debian/I<package>.elpa. =over 4 |