Skip to content

Commit 572989f

Browse files
committed
version-strings: add willsync suffix for debian sync indication
1 parent 7f00688 commit 572989f

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

docs/how-ubuntu-is-made/concepts/version-strings.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -108,6 +108,14 @@ Only packages with no Ubuntu modifications or those with no-change updates
108108
(i.e., versions with `build` rather than `ubuntu` in the revision), are
109109
automatically synced.
110110

111+
When your is already in Debian (and preliminary in Ubuntu), you can indicate a version with `willsync` to be overwritten by any future Debian version.
112+
The suffix `willsync` > `ubuntu` (and `ubuntu` prevents syncing, see above), so the next Debian update will overwrite the Ubuntu delta automatically.
113+
114+
| When | Current Debian | Current Ubuntu | Next Debian | Ubuntu sync indication |
115+
|------------------------------------------------------|----------------|----------------|--------------------|------------------------|
116+
| Ubuntu has delta, Debian caught up | `2.0-1` | `2.0-1ubuntu1` | `2.0-2` or `2.1-1` | `2.0-1willsync1` |
117+
| No Ubuntu delta, but new change already is in Debian | `2.0-1` | `2.0-1` | `2.0-2` or `2.1-1` | `2.0-1willsync1` |
118+
111119
If these updates pass Ubuntu's automated testing, they do not require manual
112120
intervention. However, there are scenarios where the automation cannot handle
113121
the process.
@@ -351,7 +359,7 @@ Native in Ubuntu:
351359
| | | full: `3ubuntu~25.10.1` and `3ubuntu~25.04.1` |
352360

353361
```{note}
354-
Depending on just a "patch" backport or rather the "full release", the SRU version number should be the current version, or the new release version number respectively.
362+
Depending on just a "patch" backport or rather the "full release", the SRU version number should be the current version incremented, or the new release version number with `~` to order before, respectively.
355363
356364
The rule of multiple releases with the same version needing to also add a
357365
per-release `YY.MM` to differentiate and ensure upgradability can be applied here as

0 commit comments

Comments
 (0)