emacs-mirror/emacs 源代码: https://github.com/emacs-mirror/emacs

版权所有 (C) 2001-2026 自由软件基金会公司。文件末尾查看许可条件。

本目录树包含 GNU Emacs 版本 32.0.50，这是一款可扩展、可定制、自文档化的实时显示编辑器。

解压或检出完整的 Emacs 文件树后，请参阅本目录中的 INSTALL 文件，了解如何在各种系统上构建和安装 GNU Emacs。

查看 etc/NEWS 文件，了解 Emacs 近期版本的新功能和其他用户可见变更。

etc/PROBLEMS 文件包含在构建、安装和运行 Emacs 过程中许多常见问题的解决信息。

CONTRIBUTE 文件包含关于如何作为开发者为 Emacs 做贡献的信息。

您可能会在当前版本中遇到缺陷。如果遇到，请报告它们；您的缺陷报告是对 FSF 的宝贵贡献，因为它们使我们能够注意到并修复在我们没有的机器上或不经常使用的代码中出现的问题。

请将缺陷报告发送到邮件列表 [email protected]。如果可能，请使用 M-x report-emacs-bug。

有关如何报告缺陷的更多信息，请参阅 Emacs 手册的 “Bugs” 部分。（本目录中的文件 ‘BUGS’ 解释了如何使用 Emacs 附带的 Info 文件找到并阅读该部分。）

有关与 Emacs 相关的邮件列表，请参阅 http://www.gnu.org/software/emacs/manual/html_node/emacs/Bugs.html。

有关完整的 GNU 邮件列表，请参阅 http://www.gnu.org/software/emacs/manual/html_node/emacs/Mailing-Lists.html。

etc 子目录包含若干其他以大写字母命名的文件，在安装 GNU Emacs 时，您可能希望查看这些文件。

文件 configure 是一个 shell 脚本，用于让 Emacs 适应您的处理器和操作系统的特性。它创建文件 Makefile（供 ‘make’ 程序使用的脚本），该脚本自动化了构建和安装 Emacs 的过程。有关更详细的信息，请参阅 INSTALL。

文件 configure.ac 是 autoconf 程序用于构建 configure 脚本的输入。

Shell 脚本 autogen.sh 通过运行 Autoconf（它又使用 GNU m4）来生成 configure 和其他文件，并且如果您正在使用 Git，它还会配置 .git 子目录中的文件。如果您想使用它，您需要安装这些构建工具的最新版本。这应该仅在您编辑指定 Emacs 自动构建过程的文件（如 configure.ac）时才需要。

文件 Makefile.in 是 configure 用于创建 Makefile 的模板。

文件 make-dist 是一个 shell 脚本，用于从当前 Emacs 树构建发行版 tar 文件，仅包含适合发行的文件。如果您对 Emacs 进行了广泛的更改，此脚本将帮助您将您的版本分发给其他人。

存在几个子目录：

• src 包含 Emacs 的 C 代码（Emacs Lisp 解释器及其原语、重显示代码和一些基本编辑功能）。
• lisp 包含 Emacs 的 Emacs Lisp 代码（几乎所有其他部分）。
• leim 包含 lisp/leim 中生成文件的原始源文件。它们构成了 Emacs 输入法库，用于输入无法通过键盘直接产生的国际字符。
• lib 包含 Emacs 及其工具使用的库的源代码。
• lib-src 包含一些供 Emacs 使用或与 Emacs 一起使用的实用程序（如 movemail 和 etags）的源代码。
• lwlib 包含在 X 上使用的 Lucid Widget 库的源代码。
• oldXMenu 包含 X11R2 XMenu 库的源文件，用于非工具包构建。
• etc 包含 Emacs 使用的各种与架构无关的数据文件，如教程文本和工具栏图像。
• lisp、leim、info 和 doc 子目录的内容也与架构无关。
• info 包含 Emacs 的 Info 文档树。
• doc/emacs 包含 Emacs 手册的源代码。如果您修改了手册源代码，您将需要 makeinfo 程序来生成更新的手册。makeinfo 是 GNU Texinfo 包的一部分；您需要一个适当较新版本的 Texinfo。
• doc/lispref 包含 Emacs Lisp 参考手册的源代码。
• doc/lispintro 包含 Emacs Lisp 编程入门手册的源代码。
• msdos 包含在 MS-DOS 下编译 Emacs 的配置文件。
• nextstep 包含编译 Emacs 的 Nextstep 移植版（用于 GNUstep 和 macOS Cocoa）的说明和其他一些文件。
• nt 包含在 MS-Windows 上构建 Emacs 的代码和文档。
• test 包含针对 Emacs 功能各个方面的测试。
• modules 包含 modhelp.py 辅助脚本。
• admin 包含 Emacs 开发者使用的文件和 Unicode 数据文件。
• build-aux 包含构建过程中使用的辅助文件。
• m4 包含用于生成 configure 脚本的 Autoconf 宏。
• java 包含 Emacs 移植到 Android 的 Java 代码。
• cross 包含用于为 Android 设备构建 Emacs 的 Makefile 和 gnulib 的附加副本。
• exec 包含多个辅助可执行文件的源代码，用于在 Android 上运行用户安装的程序。

在非 Posix 平台上构建 Emacs 需要不属于操作系统标准发行版的工具。特定于平台的 README 文件和安装说明应列出所需工具。

关于版权年份的说明

在版权持有者为自由软件基金会的版权通知中，出现的年份范围是包含该范围内每个年份的闭区间范围。例如：2005-2008 代表 2005、2006、2007 和 2008 年。

本文件是 GNU Emacs 的一部分。GNU Emacs 是自由软件：您可以根据自由软件基金会发布的 GNU 通用公共许可证的条款重新分发它和/或修改它，可以是该许可证的第 3 版，或（根据您的选择）任何更高版本。

GNU Emacs 的分发是希望它会有用，但不附带任何保证；甚至没有对适销性或适用于特定目的的隐含保证。有关更多详细信息，请参阅 GNU 通用公共许可证。

您应该已经收到 GNU 通用公共许可证的副本与 GNU Emacs 一起。如果没有，请参阅 http://www.gnu.org/licenses/。