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