CPAN::Meta::History - CPAN Meta Spec 變更記錄
版本 2.150010
CPAN Meta Spec 歷經多次反覆。它最初以 HTML 編寫,後來修改為 POD (儘管從 POD 生成的 HTML 中發布)。有時會根據設計或有時反映實際使用情況而新增、移除或變更欄位。
此文件根據變更記錄、儲存庫提交訊息和已發布的 HTML 檔案重建 CPAN Meta Spec 的歷史。在某些情況下,特別是在版本 1.2 之前,某些欄位在不同來源中引入或變更的確切版本不一致。如有疑問,版本 1.0 至 1.4 的已發布 HTML 檔案(在開發版本 2 時存在)將用作明確的來源。
從版本 2 開始,規格文件是 CPAN-Meta 發行的一部分,並將在 CPAN 上以 CPAN::Meta::Spec 發布。
未來,規格版本號將為整數,小數部分將對應於 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 月
新增「no_index」子金鑰「directory」,並移除「dir」,以符合實際使用情況
新增「repository」子金鑰至「resources」
2005 年 8 月
以 POD 語法重新撰寫和調整規格結構
將「name」變更為強制性
將「generated_by」變更為強制性
將「license」變更為強制性
新增先決條件的版本範圍規格
新增必要的「abstract」欄位
新增必填欄位「作者」
新增必填欄位「元資料規格」以定義用於元資料的 CPAN 元資料規格「版本」(和「網址」)
新增「提供」欄位
新增「不索引」欄位,並將「私人」欄位標示為已棄用。「不索引」子金鑰包括「檔案」、「目錄」、「套件」和「命名空間」
新增「關鍵字」欄位
新增「資源」欄位,子金鑰為「首頁」、「授權」和「錯誤追蹤器」
新增「選用功能」欄位作為「建議」下的備用選項。包含「說明」、「需要」、「建置需要」、「衝突」、「需要套件」、「需要作業系統」和「排除作業系統」作為有效的子金鑰
移除「授權 URI」欄位
2003 年 5 月
將「版本」變更為強制性
新增「私人」欄位
新增「授權 URI」欄位
2003 年 3 月
原始版本(僅 HTML 格式)
包含「名稱」、「版本」、「授權」、「發行類型」、「需要」、「建議」、「建置需要」、「衝突」、「動態組態」、「由...產生」
David Golden <dagolden@cpan.org>
Ricardo Signes <rjbs@cpan.org>
Adam Kennedy <adamk@cpan.org>
本軟體的著作權為 David Golden、Ricardo Signes、Adam Kennedy 和貢獻者所有 (c) 2010。
這是免費軟體;您可以在與 Perl 5 程式語言系統相同的條款下重新散布或修改它。