Skip to content

Commit abc91a3

Browse files
committed
chore(topic-update-manifest): mark packages-v2 as effective
1 parent ede49e8 commit abc91a3

File tree

2 files changed

+18
-45
lines changed

2 files changed

+18
-45
lines changed

content/developer/packaging/topic-update-manifest.md

Lines changed: 9 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -38,11 +38,14 @@ that the new KDE version may use up to 16GiB of RAM.
3838
zh_CN = """
3939
本次更新重启后可能会需要更多内存。据我社维护者测试,新版 KDE 可能需要接近 16GiB 内存。"""
4040

41-
[packages]
42-
konsole = "23.04.1-1"
43-
dolphin = "23.04.1"
44-
# Package removed as part of the topic.
45-
pykde = false
41+
# In October 2025, [packages] has been replaced with [packages-v2], which
42+
# uses a version range, representing the version range(s) which the
43+
# security vulnerability(ies) affects.
44+
```toml
45+
[packages-v2]
46+
firefox = "<= 142"
47+
thunderbird = ">= 108 && < 142"
48+
seamonkey = "=141 || =142 || =143"
4649
```
4750

4851
Below is a "cumulative" topic update manifest file:
@@ -52,30 +55,13 @@ Below is a "cumulative" topic update manifest file:
5255
default = "Winter 2023 Cumulative Update for amd64 AOSC OS systems"
5356
zh_MS = "适用于 amd64 AOSC OS 版本的 23 冬季累计更新"
5457

55-
# Must not exist alongside [packages].
58+
# Must not exist alongside [packages-v2].
5659
topics = [
5760
"kde-survey-20231201",
5861
"core-12.1.0"
5962
]
6063
```
6164

62-
Amendment: packages-v2
63-
---
64-
65-
{% card(type="success") %}
66-
This amendment has not been deployed yet - we will update the main text to reflect its replacement for `packages` following its deployment.
67-
此规范更新目前尚未实装;实装后将并入规范正文。
68-
{% end %}
69-
70-
In August 2025, we introduced the `[packages-v2]` section to help marking version ranges for important (and especially security) updates. The version range compares with the package version *before* the update, resolving an issue where, if the user happens to have missed the exact version defined in the metadata, they would never be prompted about the updates (in oma and potentially other package management frontends).
71-
72-
```toml
73-
[packages-v2]
74-
firefox = "<= 142"
75-
thunderbird = ">= 108 && < 142"
76-
seamonkey = "=141 || =142 || =143"
77-
```
78-
7965
Files
8066
===
8167

content/developer/packaging/topic-update-manifest.zh.md

Lines changed: 9 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -35,11 +35,14 @@ that the new KDE version may use up to 16GiB of RAM.
3535
zh_CN = """
3636
本次更新重启后可能会需要更多内存。据我社维护者测试,新版 KDE 可能需要接近 16GiB 内存。"""
3737

38-
[packages]
39-
konsole = "23.04.1-1"
40-
dolphin = "23.04.1"
41-
# Package removed as part of the topic.
42-
pykde = false
38+
# 2025 年 10 月起,[packages] 已被 [packages-v2] 字段替代,该字段使用版本
39+
# 范围描述安全漏洞的实际影响范围。
40+
```toml
41+
[packages-v2]
42+
firefox = "<= 142"
43+
thunderbird = ">= 108 && < 142"
44+
seamonkey = "=141 || =142 || =143"
45+
4346
```
4447

4548
亦可按需编写“累积更新”元数据,如下:
@@ -49,29 +52,13 @@ pykde = false
4952
default = "Winter 2023 Cumulative Update for amd64 AOSC OS systems"
5053
zh_MS = "适用于 amd64 AOSC OS 版本的 23 冬季累计更新"
5154

52-
# 不能与 [packages] 字段共存
55+
# 不能与 [packages-v2] 字段共存
5356
topics = [
5457
"kde-survey-20231201",
5558
"core-12.1.0"
5659
]
5760
```
5861

59-
规范更新:packages-v2
60-
---
61-
62-
{% card(type="success") %}
63-
此规范更新目前尚未实装;实装后将并入规范正文。
64-
{% end %}
65-
66-
2025 年 8 月,我们引入了 `[packages-v2]` 字段,以便定义重要更新(尤其是安全更新)波及的软件包范围,并以更新前的软件包作为对比基准,解决用户因错过特定版本软件包更新而在 oma 等包管理前端中收不到更新公告的问题。该字段的写入样例如下:
67-
68-
```toml
69-
[packages-v2]
70-
firefox = "<= 142"
71-
thunderbird = ">= 108 && < 142"
72-
seamonkey = "=141 || =142 || =143"
73-
```
74-
7562
文件存放
7663
===
7764

0 commit comments

Comments
 (0)