37.4.1 Файл DESCRIPTION ¶

Файл DESCRIPTION содержит различную информацию о пакете, такую как его имя, автор и версия. Этот файл имеет очень простой формат

• Строки, начинающиеся с ‘#’, являются комментариями.
• Строки, начинающиеся с пробела, являются продолжением предыдущей строки.
• Все остальное имеет вид NameOfOption: ValueOfOption.

Следующий пример файла DESCRIPTION

Name: The name of my package
Version: 1.0.0
Date: 2007-18-04
Author: The name (and possibly email) of the package author.
Maintainer: The name (and possibly email) of the current
 package maintainer.
Title: The title of the package
Description: A short description of the package.  If this
 description gets too long for one line it can continue
 on the next by adding a space to the beginning of the
 following lines.
License: GPLv3+

Менеджер пакетов в настоящее время распознает следующие ключевые слова

Name

Имя пакета.

Version

Версия пакета. Версия пакета обычно состоит из цифр, разделенных точками, но также может содержать ‘+’, ‘-’, ‘~’, и буквенно-цифровые символы (в локали «C»). Например, "2.1.0+" может указывать на версию разработки пакета. Версии сравниваются с помощью compare_versions.

Date

Дата последнего обновления.

Author

Исходный автор пакета.

Maintainer

Поддерживающий пакет.

Title

Однострочное описание пакета.

Description

Однопараграфическое описание пакета.

Categories

Необязательное ключевое слово, описывающее пакет (если не указан файл INDEX, это обязательно).

Problems

Необязательный список известных проблем.

Url

Необязательный список веб-страниц, связанных с пакетом.

Depends

Список других пакетов Octave, от которых зависит этот пакет. Это может включать зависимости от конкретных версий со следующим форматом:

Depends: package (>= 1.0.0)

Возможные операторы — <, <=, ==, >= или >. Если часть зависимости в () отсутствует, любая версия пакета приемлема. Несколько зависимостей можно определить как список, разделенный запятыми. Это может быть использовано для определения диапазона версий конкретного пакета:

Depends: package (>= 1.0.0), package (< 1.5.0)

Также можно зависеть от конкретных версий ядра Octave:

Depends: octave (>= 3.8.0)

License

Необязательное краткое описание используемой лицензии (например, GPL версии 3 или более поздних). Это необязательно, так как файл COPYING является обязательным.

SystemRequirements

Это внешние зависимости установки пакета и не проверяются менеджером пакетов. Это указание для упаковщика дистрибутива. Они следуют тем же соглашениям, что и ключевое слово Depends.

BuildRequires

Это внешние зависимости сборки пакета и не проверяются менеджером пакетов. Это указание для упаковщика дистрибутива. Они следуют тем же соглашениям, что и ключевое слово Depends. Обратите внимание, что, как правило, системы упаковки, такие как rpm или deb, автоматически определяют зависимости установки из зависимостей сборки, и поэтому зависимость BuildRequires обычно устраняет необходимость в зависимости SystemRequirements.

Разработчик может добавить дополнительные аргументы в файл DESCRIPTION для собственных целей. Еще одна деталь для помощи упаковщику заключается в том, что ключевые слова SystemRequirements и BuildRequires могут иметь зависимую от дистрибутива секцию, и этот автоматический процесс сборки будет использовать их. Пример формата:

BuildRequires: libtermcap-devel [Mandriva] libtermcap2-devel

где первое имя пакета будет использоваться по умолчанию, а если RPMs построены на дистрибутиве Mandriva, то вместо него будет использоваться второе имя пакета.