[PATCH 0/4] Whinlatter release updates

[PATCH 0/4] Whinlatter release updates

[Antonin Godard]

Regarding which patch to merge/backport:

- The first patch can be merged and backported to active branches.

- The second patch will be backported to the whinlatter branch once the
  release is out.

- The third patch should be applied to master only when the release is
  out, as it depends on the tags being created.

- The fourth patch can be merged.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
Antonin Godard (4):
      ref-manual/svg/releases.svg: mark styhead and walnascar EOL
      ref-manual/svg/releases.svg: mark whinlatter as current release
      set_versions.py: add wrynose as devbranch
      poky.yaml.in: split automatic and manually replaced macros

 documentation/poky.yaml.in                | 11 +++++++++++
 documentation/ref-manual/svg/releases.svg |  8 ++++----
 documentation/set_versions.py             |  8 +++++---
 3 files changed, 20 insertions(+), 7 deletions(-)
---
base-commit: 9d394db4f88b66500e4d5a2a518d25f08a0c9472
change-id: 20251202-release-updates-f92d8ed85b2c

[PATCH 1/4] ref-manual/svg/releases.svg: mark styhead and walnascar EOL

[Antonin Godard]

Walnascar has stopped being updated a while ago, and Styhead is EOL
since May 2025.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/svg/releases.svg | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/documentation/ref-manual/svg/releases.svg b/documentation/ref-manual/svg/releases.svg
index 3a379078b..e6038935f 100644
--- a/documentation/ref-manual/svg/releases.svg
+++ b/documentation/ref-manual/svg/releases.svg
@@ -608,7 +608,7 @@
          style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none"
          id="tspan10317-2-9-1-4">4.2</tspan></text>
     <rect
-       style="opacity:1;fill:#333333;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-opacity:1"
+       style="opacity:0.5;fill:#333333;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-opacity:1"
        id="rect917-0-0-4-4-9-4-5-3-9-2-3-6"
        width="140"
        height="45.000004"
@@ -632,7 +632,7 @@
          style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none"
          id="tspan10317-2-9-1-4-6-5-6">5.1</tspan></text>
     <rect
-       style="fill:#333333;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-opacity:1"
+       style="fill:#333333;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-opacity:1;opacity:0.5"
        id="rect917-0-0-4-4-9-4-5-3-9-2-3-6-2"
        width="140"
        height="45.000004"
@@ -1847,7 +1847,7 @@
          x="2128.7158"
          y="-7.6722765"
          style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans';text-align:center;text-anchor:middle;fill:#000000;fill-opacity:1;stroke:none"
-         id="tspan10317-2-9-1-4-6-5-6-6-5-9-7">Current (Apr. 25)</tspan></text>
+         id="tspan10317-2-9-1-4-6-5-6-6-5-9-7">Current (Dec. 25)</tspan></text>
     <text
        xml:space="preserve"
        style="font-weight:bold;font-size:13.3333px;line-height:125%;font-family:'Nimbus Roman';-inkscape-font-specification:'Nimbus Roman, Bold';letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;fill:#fffefe;fill-opacity:1;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"

-- 
2.51.0

[PATCH 2/4] ref-manual/svg/releases.svg: mark whinlatter as current release

[Antonin Godard]

Whinlatter is the new current Yocto Project release, mark it as an
active one.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/ref-manual/svg/releases.svg | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/documentation/ref-manual/svg/releases.svg b/documentation/ref-manual/svg/releases.svg
index e6038935f..7a0b99c3a 100644
--- a/documentation/ref-manual/svg/releases.svg
+++ b/documentation/ref-manual/svg/releases.svg
@@ -656,7 +656,7 @@
          style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:13.3333px;font-family:'Liberation Sans';-inkscape-font-specification:'Liberation Sans Bold';text-align:center;text-anchor:middle;fill:#fffefe;fill-opacity:1;stroke:none"
          id="tspan10317-2-9-1-4-6-5-6-9">5.2</tspan></text>
     <rect
-       style="opacity:0.75;fill:#251f32;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-opacity:1"
+       style="opacity:1;fill:#333333;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:2;stroke-opacity:1"
        id="rect917-0-0-4-4-9-4-5-3-9-2-3-67"
        width="140"
        height="45.000004"

-- 
2.51.0

[PATCH 3/4] set_versions.py: add wrynose as devbranch

[Antonin Godard]

Update set_versions.py after whinlatter release.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/set_versions.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/documentation/set_versions.py b/documentation/set_versions.py
index d146f93bb..0d199a885 100755
--- a/documentation/set_versions.py
+++ b/documentation/set_versions.py
@@ -26,9 +26,9 @@ ourversion = None
 if len(sys.argv) == 2:
     ourversion = sys.argv[1]
 
-activereleases = ["walnascar", "scarthgap", "kirkstone"]
-devbranch = "whinlatter"
-ltsseries = ["scarthgap", "kirkstone"]
+activereleases = ["whinlatter", "scarthgap", "kirkstone"]
+devbranch = "wrynose"
+ltsseries = ["wrynose", "scarthgap", "kirkstone"]
 
 # used by run-docs-builds to get the default page
 if ourversion == "getlatest":
@@ -36,6 +36,7 @@ if ourversion == "getlatest":
     sys.exit(0)
 
 release_series = collections.OrderedDict()
+release_series["wrynose"] = "5.3"
 release_series["whinlatter"] = "5.3"
 release_series["walnascar"] = "5.2"
 release_series["styhead"] = "5.1"
@@ -71,6 +72,7 @@ release_series["laverne"] = "0.9"
 
 
 bitbake_mapping = {
+    "wrynose" : "2.16",
     "whinlatter" : "2.14",
     "walnascar" : "2.12",
     "styhead" : "2.10",

-- 
2.51.0

[PATCH 4/4] poky.yaml.in: split automatic and manually replaced macros

[Antonin Godard]

Instead of thinking some of these macros should be replaced when a new
release is out, split the variable that should be manually maintained
and the ones that are automatically computed in set_versions.py.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/poky.yaml.in | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
index 810efd4d5..f6d6ea9fc 100644
--- a/documentation/poky.yaml.in
+++ b/documentation/poky.yaml.in
@@ -2,6 +2,12 @@
 # Macros used in the documentation
 #
 
+#
+# Automatically replaced by set_versions.py, no manual update required
+# Values below are placeholders to give an idea on how to use them in the
+# documentation.
+#
+
 # The DISTRO variable represents the current docs version. It should be used
 # when referring to the current docs version. See also DISTRO_LATEST_TAG.
 DISTRO : "5.2"
@@ -22,6 +28,11 @@ DISTRO_REL_TAG : "yocto-$DISTRO;"
 DISTRO_REL_LATEST_TAG : "yocto-&DISTRO_LATEST_TAG;"
 DOCCONF_VERSION : "dev"
 BITBAKE_SERIES : ""
+
+#
+# Not automatically replaced, manual updates required
+#
+
 YOCTO_DL_URL : "https://downloads.yoctoproject.org"
 YOCTO_RELEASE_DL_URL : "&YOCTO_DL_URL;/releases/yocto/yocto-&DISTRO;"
 MIN_PYTHON_VERSION : "3.9.0"

-- 
2.51.0

Re: [docs] [PATCH 1/4] ref-manual/svg/releases.svg: mark styhead and walnascar EOL

[Quentin Schulz]

Hi Antonin,

On 12/2/25 5:14 PM, Antonin Godard via lists.yoctoproject.org wrote:
> Walnascar has stopped being updated a while ago, and Styhead is EOL
> since May 2025.
> 

Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>

Thanks!
Quentin

Re: [docs] [PATCH 2/4] ref-manual/svg/releases.svg: mark whinlatter as current release

[Quentin Schulz]

Hi Antonin,

On 12/2/25 5:14 PM, Antonin Godard via lists.yoctoproject.org wrote:
> Whinlatter is the new current Yocto Project release, mark it as an
> active one.
> 

Still in the final stages though, but I guess we want that in so it's 
up-to-date for the Whinlatter doc release?

Whinlatter will be released a bit later this month I guess, so we should 
probably move its rectangle to the right to align with December.

Cheers,
Quentin

Re: [docs] [PATCH 3/4] set_versions.py: add wrynose as devbranch

[Quentin Schulz]

Hi Antonin,

On 12/2/25 5:14 PM, Antonin Godard via lists.yoctoproject.org wrote:
> Update set_versions.py after whinlatter release.
> 
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
> ---
>   documentation/set_versions.py | 8 +++++---
>   1 file changed, 5 insertions(+), 3 deletions(-)
> 
> diff --git a/documentation/set_versions.py b/documentation/set_versions.py
> index d146f93bb..0d199a885 100755
> --- a/documentation/set_versions.py
> +++ b/documentation/set_versions.py
> @@ -26,9 +26,9 @@ ourversion = None
>   if len(sys.argv) == 2:
>       ourversion = sys.argv[1]
>   
> -activereleases = ["walnascar", "scarthgap", "kirkstone"]
> -devbranch = "whinlatter"
> -ltsseries = ["scarthgap", "kirkstone"]
> +activereleases = ["whinlatter", "scarthgap", "kirkstone"]
> +devbranch = "wrynose"
> +ltsseries = ["wrynose", "scarthgap", "kirkstone"]
>   
>   # used by run-docs-builds to get the default page
>   if ourversion == "getlatest":
> @@ -36,6 +36,7 @@ if ourversion == "getlatest":
>       sys.exit(0)
>   
>   release_series = collections.OrderedDict()
> +release_series["wrynose"] = "5.3"

6.0?

Otherwise looks ok to me.

Cheers,
Quentin

Re: [docs] [PATCH 4/4] poky.yaml.in: split automatic and manually replaced macros

[Quentin Schulz]

Hi Antonin,

On 12/2/25 5:14 PM, Antonin Godard via lists.yoctoproject.org wrote:
> Instead of thinking some of these macros should be replaced when a new
> release is out, split the variable that should be manually maintained
> and the ones that are automatically computed in set_versions.py.
> 
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
> ---
>   documentation/poky.yaml.in | 11 +++++++++++
>   1 file changed, 11 insertions(+)
> 
> diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
> index 810efd4d5..f6d6ea9fc 100644
> --- a/documentation/poky.yaml.in
> +++ b/documentation/poky.yaml.in
> @@ -2,6 +2,12 @@
>   # Macros used in the documentation
>   #
>   
> +#
> +# Automatically replaced by set_versions.py, no manual update required
> +# Values below are placeholders to give an idea on how to use them in the
> +# documentation.
> +#
> +
>   # The DISTRO variable represents the current docs version. It should be used
>   # when referring to the current docs version. See also DISTRO_LATEST_TAG.
>   DISTRO : "5.2"
> @@ -22,6 +28,11 @@ DISTRO_REL_TAG : "yocto-$DISTRO;"
>   DISTRO_REL_LATEST_TAG : "yocto-&DISTRO_LATEST_TAG;"
>   DOCCONF_VERSION : "dev"
>   BITBAKE_SERIES : ""

DISTRO_REL_TAG and DISTRO_REL_LATEST_TAG aren't actually replaced, so 
should we move them with the unchanged variables below?

Cheers,
Quentin

Re: [docs] [PATCH 3/4] set_versions.py: add wrynose as devbranch

[Antonin Godard]

Hi,

On Wed Dec 3, 2025 at 4:00 PM CET, Quentin Schulz wrote:
> Hi Antonin,
>
> On 12/2/25 5:14 PM, Antonin Godard via lists.yoctoproject.org wrote:
>> Update set_versions.py after whinlatter release.
>> 
>> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
>> ---
>>   documentation/set_versions.py | 8 +++++---
>>   1 file changed, 5 insertions(+), 3 deletions(-)
>> 
>> diff --git a/documentation/set_versions.py b/documentation/set_versions.py
>> index d146f93bb..0d199a885 100755
>> --- a/documentation/set_versions.py
>> +++ b/documentation/set_versions.py
>> @@ -26,9 +26,9 @@ ourversion = None
>>   if len(sys.argv) == 2:
>>       ourversion = sys.argv[1]
>>   
>> -activereleases = ["walnascar", "scarthgap", "kirkstone"]
>> -devbranch = "whinlatter"
>> -ltsseries = ["scarthgap", "kirkstone"]
>> +activereleases = ["whinlatter", "scarthgap", "kirkstone"]
>> +devbranch = "wrynose"
>> +ltsseries = ["wrynose", "scarthgap", "kirkstone"]
>>   
>>   # used by run-docs-builds to get the default page
>>   if ourversion == "getlatest":
>> @@ -36,6 +36,7 @@ if ourversion == "getlatest":
>>       sys.exit(0)
>>   
>>   release_series = collections.OrderedDict()
>> +release_series["wrynose"] = "5.3"
>
> 6.0?

Good catch, thanks, will fix :)

Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [docs] [PATCH 2/4] ref-manual/svg/releases.svg: mark whinlatter as current release

[Antonin Godard]

Hi,

On Wed Dec 3, 2025 at 3:57 PM CET, Quentin Schulz via lists.yoctoproject.org wrote:
> Hi Antonin,
>
> On 12/2/25 5:14 PM, Antonin Godard via lists.yoctoproject.org wrote:
>> Whinlatter is the new current Yocto Project release, mark it as an
>> active one.
>> 
>
> Still in the final stages though, but I guess we want that in so it's 
> up-to-date for the Whinlatter doc release?

Yes, this is planning in advance.

> Whinlatter will be released a bit later this month I guess, so we should 
> probably move its rectangle to the right to align with December.

Oh good catch, I'll adjust that in the v2.

Thanks,
Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com

Re: [docs] [PATCH 4/4] poky.yaml.in: split automatic and manually replaced macros

[Antonin Godard]

Hi,

On Wed Dec 3, 2025 at 4:04 PM CET, Quentin Schulz via lists.yoctoproject.org wrote:
> Hi Antonin,
>
> On 12/2/25 5:14 PM, Antonin Godard via lists.yoctoproject.org wrote:
>> Instead of thinking some of these macros should be replaced when a new
>> release is out, split the variable that should be manually maintained
>> and the ones that are automatically computed in set_versions.py.
>> 
>> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
>> ---
>>   documentation/poky.yaml.in | 11 +++++++++++
>>   1 file changed, 11 insertions(+)
>> 
>> diff --git a/documentation/poky.yaml.in b/documentation/poky.yaml.in
>> index 810efd4d5..f6d6ea9fc 100644
>> --- a/documentation/poky.yaml.in
>> +++ b/documentation/poky.yaml.in
>> @@ -2,6 +2,12 @@
>>   # Macros used in the documentation
>>   #
>>   
>> +#
>> +# Automatically replaced by set_versions.py, no manual update required
>> +# Values below are placeholders to give an idea on how to use them in the
>> +# documentation.
>> +#
>> +
>>   # The DISTRO variable represents the current docs version. It should be used
>>   # when referring to the current docs version. See also DISTRO_LATEST_TAG.
>>   DISTRO : "5.2"
>> @@ -22,6 +28,11 @@ DISTRO_REL_TAG : "yocto-$DISTRO;"
>>   DISTRO_REL_LATEST_TAG : "yocto-&DISTRO_LATEST_TAG;"
>>   DOCCONF_VERSION : "dev"
>>   BITBAKE_SERIES : ""
>
> DISTRO_REL_TAG and DISTRO_REL_LATEST_TAG aren't actually replaced, so 
> should we move them with the unchanged variables below?

Ha, had a bit of hesitation for these ones, it's true they aren't replaced
although I doubt they're subject to change. Will move them anyhow, thanks.

Antonin

-- 
Antonin Godard, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com