Contents of /eclass/elisp.eclass

see commit before, this time for real:
Remove some unused parts (commented out and similar)
Documentation of functions (both by Ulrich Müller and Christian Faulhammer)
New function elisp_make_autoload_file() (by Ulrich Müller)
Taken from Emacs Overlay

1

# Copyright 1999-2007 Gentoo Foundation

2

# Distributed under the terms of the GNU General Public License v2

3

# $Header: $

4

#

5

# Copyright 2007 Christian Faulhammer <opfer@gentoo.org>

6

# Copyright 2002-2007 Matthew Kennedy <mkennedy@gentoo.org>

7

# Copyright 2003 Jeremy Maitin-Shepard <jbms@attbi.com>

8

# Copyright 2007 Ulrich Mueller <ulm@gentoo.org>

9

#

10

# This is not a real eclass, but it does provide Emacs-related installation

11

# utilities.

12

#

13

# USAGE:

14

#

15

# Usually you want to use this eclass for (optional) GNU Emacs support of

16

# your package. This is NOT for XEmacs!

17

# Many of the steps here are sometimes done by the build system of your

18

# package (especially compilation), so this is mainly for standalone elisp

19

# files you gathered from somewhere else.

20

# When relying on the emacs USE flag, you need to add

21

#

22

# emacs? ( virtual/emacs )

23

#

24

# to your DEPEND/RDEPEND line and use the functions provided here to bring

25

# the files to the correct locations.

26

#

27

# src_compile() usage:

28

# --------------------

29

#

30

# An elisp file is compiled by the elisp-compile() function defined here and

31

# simply takes the source files as arguments. In the case of interdependent

32

# elisp files, you can use the elisp-comp() function which makes sure all

33

# files are loadable.

34

#

35

# elisp-compile *.el || die "elisp-compile failed!"

36

# or

37

# elisp-comp *.el || die "elisp-comp failed!"

38

#

39

# Function elisp-make-autoload-file() can be used to generate a file with

40

# autoload definitions for the lisp functions. It takes the output file name

41

# (default: "${PN}-autoloads.el") and a list of directories (default: working

42

# directory) as its arguments. Use of this function requires that the elisp