37.4.1描述文件¶

这个说明文件包含有关包的各种信息,如名称、作者和版本。这个文件的格式很简单

• 以'开头的行#’是注释。
• 以空白字符开头的行是前一行的延续。
• 其他一切都是形式参数名称:参数值.

以下是一个简单的示例说明文件

名称:我的包的名称版本:1.0.0日期:2007-18-04作者:包作者的姓名(可能还有电子邮件)。Maintainer:当前包维护者的名称(可能还有电子邮件)。标题:包的标题描述:包的简短描述。如果这段描述对于一行来说太长,则可以通过在以下行的开头添加空格来继续下一行。许可证:GPLv3+

包管理器当前识别以下关键字

Name

包的名称。

版本

包的版本。软件包版本通常是用句点分隔的数字,但也可能包含“+’, ‘-’, ‘~'和字母数字字符(在“C”语言环境中)。例如"2.1.0+"可以指示软件包的开发版本。版本比较使用compare_versions.

日期

上次更新的日期。

著者

包的原始作者。

维护人员

包的维护者。

标题

包的单行描述。

描述

包的一段描述。

类别

描述包的可选关键字(如果否索引文件中给出了这是强制性的)。

问题

已知问题的可选列表。

Url

与程序包相关的主页的可选列表。

取决于

此包所依赖的其他Octave包的列表。这可能包括特定版本的依赖项,格式如下:

取决于:包(>=1.0.0)

可能的运算符有<,<=,==,>=或>。如果中的依赖项部分()缺少,任何版本的软件包都是可以接受的。可以将多个依赖项定义为一个逗号分隔的列表。这可用于定义特定软件包的一系列版本:

取决于:包(>=1.0.0),包(<1.5.0)

也可能取决于Octave核心的特定版本:

取决于:Octave(>=3.8.0)

许可证

所用许可证的可选简短描述(例如,GPL版本3或更新版本)。这是可选的,因为文件复制是强制性的。

系统要求

这些是包的外部安装依赖项,不受包管理器的检查。这是对分发打包程序的提示。它们遵循与相同的惯例取决于关键字。

BuildRequires

这些是包的外部生成依赖项,不从包管理器检查。这是对分发打包程序的提示。它们遵循与相同的惯例取决于关键字。请注意,一般来说,软件包系统如rpm或deb从构建依赖项中自动探测安装依赖项,因此BuildRequires依赖关系通常消除了对系统要求附属国。

开发人员可以自从地将其他参数添加到说明文件用于自己的目的。向软件包商提供的另一个细节是系统要求和BuildRequires关键字可以有一个依赖于分发的部分,自动构建过程将使用这些部分。这种格式的一个例子是

BuildRequires:libtermcap-devel〔Mandriva〕libtermcap2-devel

其中第一个包名称将用作默认名称,如果RPM构建在Mandriva发行版上,则将使用第二个包名称。