/[gentoo-x86]/eclass/elisp.eclass
Gentoo

Contents of /eclass/elisp.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.53 - (show annotations) (download)
Fri Oct 21 19:16:16 2011 UTC (2 years, 9 months ago) by ulm
Branch: MAIN
Changes since 1.52: +4 -3 lines
ELISP_PATCHES is a space separated list.

1 # Copyright 1999-2011 Gentoo Foundation
2 # Distributed under the terms of the GNU General Public License v2
3 # $Header: /var/cvsroot/gentoo-x86/eclass/elisp.eclass,v 1.52 2011/08/30 20:10:13 ulm Exp $
4 #
5 # @ECLASS: elisp.eclass
6 # @MAINTAINER:
7 # Gentoo Emacs team <emacs@gentoo.org>
8 # @AUTHOR:
9 # Matthew Kennedy <mkennedy@gentoo.org>
10 # Jeremy Maitin-Shepard <jbms@attbi.com>
11 # Christian Faulhammer <fauli@gentoo.org>
12 # Ulrich Müller <ulm@gentoo.org>
13 # @BLURB: Eclass for Emacs Lisp packages
14 # @DESCRIPTION:
15 #
16 # This eclass is designed to install elisp files of Emacs related
17 # packages into the site-lisp directory. The majority of elisp packages
18 # will only need to define the standard ebuild variables (like SRC_URI)
19 # and optionally SITEFILE for successful installation.
20 #
21 # Emacs support for other than pure elisp packages is handled by
22 # elisp-common.eclass where you won't have a dependency on Emacs itself.
23 # All elisp-* functions are documented there.
24 #
25 # If the package's source is a single (in whatever way) compressed elisp
26 # file with the file name ${P}.el, then this eclass will move ${P}.el to
27 # ${PN}.el in src_unpack().
28
29 # @ECLASS-VARIABLE: NEED_EMACS
30 # @DEFAULT_UNSET
31 # @DESCRIPTION:
32 # If you need anything different from Emacs 21, use the NEED_EMACS
33 # variable before inheriting elisp.eclass. Set it to the major version
34 # your package uses and the dependency will be adjusted.
35
36 # @ECLASS-VARIABLE: ELISP_PATCHES
37 # @DEFAULT_UNSET
38 # @DESCRIPTION:
39 # Space separated list of patches to apply after unpacking the sources.
40 # Patch files are searched for in the current working dir, WORKDIR, and
41 # FILESDIR.
42
43 # @ECLASS-VARIABLE: SITEFILE
44 # @DEFAULT_UNSET
45 # @DESCRIPTION:
46 # Name of package's site-init file. The filename must match the shell
47 # pattern "[1-8][0-9]*-gentoo.el"; numbers below 10 and above 89 are
48 # reserved for internal use. "50${PN}-gentoo.el" is a reasonable choice
49 # in most cases.
50
51 # @ECLASS-VARIABLE: ELISP_TEXINFO
52 # @DEFAULT_UNSET
53 # @DESCRIPTION:
54 # Space separated list of Texinfo sources. Respective GNU Info files
55 # will be generated in src_compile() and installed in src_install().
56
57 # @ECLASS-VARIABLE: DOCS
58 # @DEFAULT_UNSET
59 # @DESCRIPTION:
60 # DOCS="blah.txt ChangeLog" is automatically used to install the given
61 # files by dodoc in src_install().
62
63 inherit elisp-common eutils
64
65 case "${EAPI:-0}" in
66 0|1) EXPORT_FUNCTIONS src_{unpack,compile,install} \
67 pkg_{setup,postinst,postrm} ;;
68 *) EXPORT_FUNCTIONS src_{unpack,prepare,configure,compile,install} \
69 pkg_{setup,postinst,postrm} ;;
70 esac
71
72 DEPEND=">=virtual/emacs-${NEED_EMACS:-21}"
73 RDEPEND="${DEPEND}"
74 IUSE=""
75
76 # @FUNCTION: elisp_pkg_setup
77 # @DESCRIPTION:
78 # Test if the eselected Emacs version is sufficient to fulfil the major
79 # version requirement of the NEED_EMACS variable.
80
81 elisp_pkg_setup() {
82 elisp-need-emacs "${NEED_EMACS:-21}" || die "Emacs version too low"
83 }
84
85 # @FUNCTION: elisp_src_unpack
86 # @DESCRIPTION:
87 # Unpack the sources; also handle the case of a single *.el file in
88 # WORKDIR for packages distributed that way. For EAPIs without
89 # src_prepare, call elisp_src_prepare.
90
91 elisp_src_unpack() {
92 [[ -n ${A} ]] && unpack ${A}
93 if [[ -f ${P}.el ]]; then
94 # the "simple elisp" case with a single *.el file in WORKDIR
95 mv ${P}.el ${PN}.el || die
96 [[ -d ${S} ]] || S=${WORKDIR}
97 fi
98
99 case "${EAPI:-0}" in
100 0|1) [[ -d ${S} ]] && cd "${S}"
101 elisp_src_prepare ;;
102 esac
103 }
104
105 # @FUNCTION: elisp_src_prepare
106 # @DESCRIPTION:
107 # Apply any patches listed in ELISP_PATCHES. Patch files are searched
108 # for in the current working dir, WORKDIR, and FILESDIR.
109
110 elisp_src_prepare() {
111 local patch
112 for patch in ${ELISP_PATCHES}; do
113 if [[ -f ${patch} ]]; then
114 epatch "${patch}"
115 elif [[ -f ${WORKDIR}/${patch} ]]; then
116 epatch "${WORKDIR}/${patch}"
117 elif [[ -f ${FILESDIR}/${patch} ]]; then
118 epatch "${FILESDIR}/${patch}"
119 else
120 die "Cannot find ${patch}"
121 fi
122 done
123 }
124
125 # @FUNCTION: elisp_src_configure
126 # @DESCRIPTION:
127 # Do nothing, because Emacs packages seldomly bring a full build system.
128
129 elisp_src_configure() { :; }
130
131 # @FUNCTION: elisp_src_compile
132 # @DESCRIPTION:
133 # Call elisp-compile to byte-compile all Emacs Lisp (*.el) files.
134 # If ELISP_TEXINFO lists any Texinfo sources, call makeinfo to generate
135 # GNU Info files from them.
136
137 elisp_src_compile() {
138 elisp-compile *.el || die
139 if [[ -n ${ELISP_TEXINFO} ]]; then
140 makeinfo ${ELISP_TEXINFO} || die
141 fi
142 }
143
144 # @FUNCTION: elisp_src_install
145 # @DESCRIPTION:
146 # Call elisp-install to install all Emacs Lisp (*.el and *.elc) files.
147 # If the SITEFILE variable specifies a site-init file, install it with
148 # elisp-site-file-install. Also install any GNU Info files listed in
149 # ELISP_TEXINFO and documentation listed in the DOCS variable.
150
151 elisp_src_install() {
152 elisp-install ${PN} *.el *.elc || die
153 if [[ -n ${SITEFILE} ]]; then
154 elisp-site-file-install "${FILESDIR}/${SITEFILE}" || die
155 fi
156 if [[ -n ${ELISP_TEXINFO} ]]; then
157 set -- ${ELISP_TEXINFO}
158 set -- ${@##*/}
159 doinfo ${@/%.*/.info*} || die
160 fi
161 if [[ -n ${DOCS} ]]; then
162 dodoc ${DOCS} || die
163 fi
164 }
165
166 # @FUNCTION: elisp_pkg_postinst
167 # @DESCRIPTION:
168 # Call elisp-site-regen, in order to collect the site initialisation for
169 # all installed Emacs Lisp packages in the site-gentoo.el file.
170
171 elisp_pkg_postinst() {
172 elisp-site-regen
173 }
174
175 # @FUNCTION: elisp_pkg_postrm
176 # @DESCRIPTION:
177 # Call elisp-site-regen, in order to collect the site initialisation for
178 # all installed Emacs Lisp packages in the site-gentoo.el file.
179
180 elisp_pkg_postrm() {
181 elisp-site-regen
182 }

  ViewVC Help
Powered by ViewVC 1.1.20