内容

#名称

CPAN::Meta::History - CPAN 元数据规范变更历史

版本 2.150010

CPAN 元数据规范经历了多次迭代。它最初是用 HTML 编写的，后来修改为 POD（尽管发布的是从 POD 生成的 HTML）。字段被添加、删除或更改，有时是出于设计目的，有时是为了反映实际使用情况。

本文档根据变更日志、仓库提交消息和已发布的 HTML 文件重建了 CPAN 元数据规范的历史。在某些情况下，特别是在 1.2 版本之前，某些字段引入或更改的确切版本在不同来源之间不一致。如有疑问，将使用开发版本 2 时存在的 1.0 到 1.4 版本的已发布 HTML 文件作为权威来源。

从版本 2 开始，规范文档是 CPAN-Meta 发行版的一部分，并将作为 CPAN::Meta::Spec 发布在 CPAN 上。

今后，规范版本号将为整数，小数部分将对应于 CPAN::Meta 库的发布日期。

2010 年 4 月

将规范示例修改为 Perl 数据结构，而不是 YAML
从 YAML 切换到 JSON 序列化
指定允许的版本号格式
用新的“prereqs”数据结构替换“requires”、“build_requires”、“configure_requires”、“recommends”和“conflicts”，该数据结构按阶段（配置、构建、测试、运行时等）和关系（需要、推荐、建议、冲突）划分
添加了对“develop”阶段的支持，用于维护作者工具列表的要求
将“license”更改为列表，并修改了有效许可证集
使“dynamic_config”成为强制性的，以减少混淆
将“resources”子键“repository”更改为哈希，以明确存储库类型、浏览 URL 和签出 URL
将“resources”子键“bugtracker”更改为哈希，用于 Web 或 mailto 资源
更改了“optional_features”的规范
- 添加了正式规范和使用指南，而不仅仅是示例
- 更改为使用新的 prereqs 数据结构，而不是单独的键
阐明了“author”作为通用联系人列表的预期用途
添加了“release_status”字段，以指示稳定、测试或不稳定状态，为索引器提供提示
添加了“description”字段，用于更详细地描述发行版
正式化了对所有未列在官方规范中的自定义键使用“x_”或“X_”

2008 年 6 月

注意到对先决条件中“perl”的明确支持
添加了“configure_requires”先决条件类型
更改了“optional_features”
- 示例已更正为显示映射的映射，而不是映射的列表（尽管描述性文本在 v1.3 中甚至说“映射”）
- 删除了“requires_packages”、“requires_os”和“excluded_os”作为有效子键

2006 年 11 月

2005 年 8 月

使用 POD 语法重新编写和重构规范
将“name”更改为强制性
将“generated_by”更改为强制性
将“license”更改为强制性
添加了先决条件的版本范围规范
添加了必需的“abstract”字段
添加了必需的“author”字段
添加了必需的“meta-spec”字段，用于定义用于元数据的 CPAN 元规范的“version”（和“url”）
添加了“provides”字段
添加了“no_index”字段，并弃用了“private”字段。“no_index”子键包括“file”，“dir”，“package”和“namespace”
添加了“keywords”字段
添加了“resources”字段，其子键为“homepage”，“license”和“bugtracker”
添加了“optional_features”字段作为“recommends”下的备用字段。包括“description”，“requires”，“build_requires”，“conflicts”，“requires_packages”，“requires_os”和“excluded_os”作为有效的子键
删除了“license_uri”字段

2003 年 5 月

2003 年 3 月

原始版本（仅限 HTML 格式）
包括“name”，“version”，“license”，“distribution_type”，“requires”，“recommends”，“build_requires”，“conflicts”，“dynamic_config”，“generated_by”

这是一个自由软件；您可以根据与 Perl 5 编程语言系统本身相同的条款重新分发和/或修改它。