Простые пакеты

Простой пакет состоит из одного исходного файла Emacs Lisp. Файл должен соответствовать соглашениям о заголовках библиотек Emacs Lisp (см. Стандартные заголовки библиотек Emacs). Атрибуты пакета берутся из различных заголовков, как показано в следующем примере:

;;; superfrobnicator.el --- Frobnicate and bifurcate flanges  -*- lexical-binding:t -*-

;; Copyright (C) 2022, 2025--2026 Free Software Foundation, Inc.

;; Author: J. R. Hacker <jrh@example.com>
;; Version: 1.3
;; Package-Requires: ((flange "1.0"))
;; Keywords: multimedia, hypermedia
;; URL: https://example.com/jrhacker/superfrobnicate

...

;;; Commentary:

;; This package provides a minor mode to frobnicate and/or
;; bifurcate any flanges you desire.  To activate it, just type
...

;;;###autoload
(define-minor-mode superfrobnicator-mode
...

Имя пакета совпадает с базовым именем файла, указанным в первой строке. В данном случае это ‘superfrobnicator’.

Краткое описание также берётся из первой строки. В данном случае это ‘Изменение и раздвоение фланцев’.

Номер версии берётся из заголовка ‘Package-Version’, если он присутствует, или из заголовка ‘Version’ в противном случае. Один из этих заголовков обязательно должен присутствовать. В данном случае номер версии — 1.3.

Если файл содержит раздел ‘;;; Commentary:’, этот раздел используется как подробное описание. (При отображении описания Emacs опускает строку ‘;;; Commentary:’, а также начальные символы комментария в самом разделе.)

Если файл содержит заголовок ‘Package-Requires’, он используется для указания зависимостей пакета. В приведённом выше примере пакет зависит от пакета ‘flange’ версии 1.0 или выше. Описание заголовка ‘Package-Requires’ см. в разделе Стандартные заголовки библиотек Emacs. Чтобы указать зависимость от определённой версии Emacs, задайте ‘emacs’ в качестве имени пакета. Если заголовок отсутствует, у пакета нет зависимостей.

Заголовки ‘Keywords’ и ‘URL’ необязательны, но рекомендуются. Команда describe-package использует их, чтобы добавлять ссылки в свой вывод. Заголовок ‘Keywords’ должен содержать по крайней мере одно стандартное ключевое слово из списка finder-known-keywords.

Файл также должен содержать один или несколько специальных комментариев автозагрузки, как описано в разделе Основы упаковки. В приведённом выше примере специальный комментарий автозагружает superfrobnicator-mode.

Пояснение о том, как добавить пакет из одного файла в архив пакетов, см. в разделе Создание архивов пакетов и управление ими.