ELISP.ECLASS

章节: eclass-manpages (5)
更新时间: 2024 年 11 月
索引返回主内容

名称

elisp.eclass - Emacs Lisp 软件包的 Eclass

此 eclass 旨在将 Emacs 相关软件包的 elisp 文件安装到 site-lisp 目录中。大多数 elisp 软件包只需要定义标准的 ebuild 变量（如 SRC_URI）以及可选的 SITEFILE 即可成功安装。

对于非纯 elisp 软件包的 Emacs 支持由 elisp-common.eclass 处理，您无需依赖 Emacs 本身。所有 elisp-* 函数都在那里有文档记录。

如果软件包的源代码是单个（以任何方式）压缩的 elisp 文件，其文件名是 ${P}.el，则此 eclass 会在 src_unpack() 中将 ${P}.el 移动到 ${PN}.el。

7 8

elisp-common

elisp_pkg_setup: 测试 eselected Emacs 版本是否足以满足 NEED_EMACS 变量的版本要求。
elisp_src_unpack: 解压源代码；也处理以这种方式分发的软件包在 WORKDIR 中单个 *.el 文件的情况。
elisp_src_prepare: 应用 ELISP_PATCHES 中列出的所有补丁。在当前工作目录、WORKDIR 和 FILESDIR 中搜索补丁文件。
elisp_src_configure: 不执行任何操作，因为 Emacs 软件包很少自带完整的构建系统。
elisp_src_compile: 调用 elisp-compile 对所有 Emacs Lisp (*.el) 文件进行字节码编译。如果 ELISP_TEXINFO 列出任何 Texinfo 源文件，则调用 makeinfo 从中生成 GNU Info 文件。
elisp_src_test: 如果事先调用了“elisp-enable-tests”，则调用“elisp-test”来测试软件包，否则执行默认测试函数 - “src_test”。
elisp_src_install: 调用 elisp-install 来安装所有 Emacs Lisp (*.el 和 *.elc) 文件。如果 SITEFILE 变量指定了一个 site-init 文件，则使用 elisp-site-file-install 安装它。还安装 ELISP_TEXINFO 中列出的任何 GNU Info 文件以及 DOCS 变量中列出的文档。
elisp_pkg_postinst: 调用 elisp-site-regen，以便在 site-gentoo.el 文件中收集所有已安装的 Emacs Lisp 软件包的站点初始化。
elisp_pkg_postrm: 调用 elisp-site-regen，以便在 site-gentoo.el 文件中收集所有已安装的 Emacs Lisp 软件包的站点初始化。

NEED_EMACS (在继承之前设置): 如果您需要 Emacs 25.3（或更高版本）以外的任何内容，请在继承 elisp.eclass 之前使用 NEED_EMACS 变量。将其设置为您的软件包使用的版本，依赖项将进行调整。
ELISP_PATCHES: 要应用于解压源代码后的补丁的空格分隔列表。在当前工作目录、WORKDIR 和 FILESDIR 中搜索补丁文件。此变量已部分弃用，最好使用 PATCHES 数组代替。
ELISP_REMOVE: 解压源代码后要删除的文件的空格分隔列表。
SITEFILE: 软件包的 site-init 文件名。文件名必须与 shell 模式“[1-8][0-9]*-gentoo.el”匹配；10 以下和 89 以上的数字保留供内部使用。“50${PN}-gentoo.el”在大多数情况下是一个合理的选择。
ELISP_TEXINFO: Texinfo 源文件的空格分隔列表。相应的 GNU Info 文件将在 src_compile() 中生成并在 src_install() 中安装。

Matthew Kennedy <[email protected]>
Jeremy Maitin-Shepard <[email protected]>
Christian Faulhammer <[email protected]>
Ulrich Müller <[email protected]>
Maciej Barć <[email protected]>

Gentoo GNU Emacs 项目 <[email protected]>

elisp.eclass

本文件由 man2html 使用手册页创建。
时间：2024 年 11 月 12 日格林尼治标准时间 03:27:01