From patchwork Mon Jun 15 06:24:34 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: ChenQi X-Patchwork-Id: 90094 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id AC5A3CD98CF for ; Mon, 15 Jun 2026 06:25:02 +0000 (UTC) Received: from mx0b-0064b401.pphosted.com (mx0b-0064b401.pphosted.com [205.220.178.238]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123721.1781504690390036498 for ; Sun, 14 Jun 2026 23:24:50 -0700 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@windriver.com header.s=PPS06212021 header.b=JJrV7Alm; spf=permerror, err=parse error for token &{10 18 %{ir}.%{v}.%{d}.spf.has.pphosted.com}: invalid domain name (domain: windriver.com, ip: 205.220.178.238, mailfrom: prvs=062669d7a8=qi.chen@windriver.com) Received: from pps.filterd (m0250811.ppops.net [127.0.0.1]) by mx0a-0064b401.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 65F6Ntvk216469; Mon, 15 Jun 2026 06:24:49 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=windriver.com; h=cc:content-transfer-encoding:content-type:date:from :message-id:mime-version:subject:to; s=PPS06212021; bh=dLp/MHL5l aFvhTEMhWR3mUEYVlchWbqLLvWR8GQjy9M=; b=JJrV7Alm/tMM6c/pjaCat7dLp lNUn5QIeFcwWyIHErlAoqqOE9ku0oswestncABEpO7+3xIhTn82FkU4dWiI6lbzc MVTKNsX9Y3mDApDhBHA+vkf2vNEZpH0RTE3DpgHiAYpMELI4PYZv3/07ByYKSUzg bzKuLdXcCIWJmXCpbYuD8e4dFERhmiHn1GHaJLwzszed2tS/4++3AraGkrtMavnW jucZ6imXR0vf1ZUJvCZoZjno7sl9hIVMolgBF/OKBDgMbyEyB8T5K9Da3jWIZTTh 29c04noRr+gCQjeO+GWAp0I13EDhC9BB6KPJrKT35KatDRxgRKN3kWSYmRkOA== Received: from sn4pr2101cu001.outbound.protection.outlook.com (mail-southcentralusazon11012015.outbound.protection.outlook.com [40.93.195.15]) by mx0a-0064b401.pphosted.com (PPS) with ESMTPS id 4ervkp2bvm-2 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NOT); Mon, 15 Jun 2026 06:24:48 +0000 (GMT) ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=s5nUKXy3OdsfIUHz0J2N6ogetqkzpBLqJyEvJKxYK7J70Y2Yx7IADZEhjKdJyq3UQ25U/wfdpTfLCaq/uPfO0OcCbIYF5gvnw1yqE+vj/6GxKmgeWYe+69lpUZT6QU9FXkEJYCoAvqtKpcuRxz7n0dMfEEYvuyqlpTasLLh05KbsGxOVtLAXHAitTZGJwj2vCQ1ILI4Gg0eTepxF5nBjErGl+aX9jh2heQ+dks5vztHP4xoyfSyfylTa+nFfWe72KW7JtBZkNauBbNrRqm8tF0QC/jjSqfeM+QFLSYh/Wao6833A6hnvc7o2eDuUvgCguZmdwh2krBc1SBkpaVwzOQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=dLp/MHL5laFvhTEMhWR3mUEYVlchWbqLLvWR8GQjy9M=; b=fYZ0sT+eAtreZjdAJyk2FjwyhSCeOkhO+Pr3rz7mdm+/by9J81pdiARpc7QRTYqLZF2qo+hb/ot4eDNSqDNeqTRA92vaELmoxLS2Mtj1Fw2UbypRZFKxcHaWgrD/ZUZuIA20nPJ3ckUBI/kpKlVeZ7gg6VE0xvEB9i23pFEiJ+2Gx7sj5SV0Zt1Q0kZy6EOC60f59XYZWBFxw0j51VSjmCQTIijNwBxZ8DTjrHe6zPSgeYh5+RCKY2oe9OK1bx8eyan8tUn5wqN96TUg8AE259S3S5shtdlBHSwWhPR6J808H3/+TgRIWWOlNG7DMoX/uP0QzlE7RCIb9E/4O0YaIg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=windriver.com; dmarc=pass action=none header.from=windriver.com; dkim=pass header.d=windriver.com; arc=none Received: from CO6PR11MB5602.namprd11.prod.outlook.com (2603:10b6:303:13a::5) by CO1PR11MB5154.namprd11.prod.outlook.com (2603:10b6:303:99::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.21.113.18; Mon, 15 Jun 2026 06:24:45 +0000 Received: from CO6PR11MB5602.namprd11.prod.outlook.com ([fe80::5ad6:8f90:b01d:2c62]) by CO6PR11MB5602.namprd11.prod.outlook.com ([fe80::5ad6:8f90:b01d:2c62%3]) with mapi id 15.21.0113.015; Mon, 15 Jun 2026 06:24:45 +0000 From: Qi.Chen@windriver.com To: docs@lists.yoctoproject.org Cc: alex.kanavin@gmail.com Subject: [PATCH 1/3] ref-manual/classes.rst: add upstream-stable-release-point class documentation Date: Sun, 14 Jun 2026 23:24:34 -0700 Message-ID: <20260615062438.3119651-1-Qi.Chen@windriver.com> X-Mailer: git-send-email 2.54.0 X-ClientProxiedBy: SJ0PR03CA0143.namprd03.prod.outlook.com (2603:10b6:a03:33c::28) To CO6PR11MB5602.namprd11.prod.outlook.com (2603:10b6:303:13a::5) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CO6PR11MB5602:EE_|CO1PR11MB5154:EE_ X-MS-Office365-Filtering-Correlation-Id: a0796d3b-c4c6-435e-7cf3-08decaa6cafc X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|376014|52116014|23010399003|366016|18002099003|38350700014|56012099006|11063799006; X-Microsoft-Antispam-Message-Info: xR6W0m5IJiWj1j83Yow6CatIBU64iYYDh5mErItFnHYcvQT+9Gl5kloBQd+zPFOBuTzJFcQIpUN85AxIKFBGfsGJvCZORcfBDIt3L7Mwu8tbS+fRHb/qi2K6HPUVxGUpBbXTpwVratjq8TmGuwEmpIcccQtvBXLErI39T26wbBBWWnIMFENPgTLPGUAvKq9uw0BNHUIZ+xPB3z00csvEZmbHbQYlsnHKHPxmsElIGtrbf2+c53A9FGqRLztS1glvCxPpV2xnQ9sdw4TczGE36xkInDTCMR7HecCqsoGKMfi5qTF73r6sHjLC7aLWsSZ4qLOSbIokgRiiwbtgP5iWGQFbMQzEVWhFmz8TejrfiML/cJq4KNIW5K3qx/Etxv2wRkNHq2vkX5PkowYeiVhDyQ5//rEIkqA7aczuf+1f2xyCAOZ4YSeT1NkmPDyj0DYTucSqOEs4bwaZGP8DluLu0hv0tIWkZBFeBP6ZtQ/8zBYUi6cRPaQW1QDKGtjh58jr2ulLR5GFZOCD80qem++WAEhI+kXCCg0BXnFS4jkHpSmHKNT6gkJJ17inuYpLqonizhC4aZa0HTVdOnfD/FVNNSZOtqIxoNgxcIbrvQIZWL1OlxdPCUiKCz6Dn/uDxoOqhtVoiB+p/TCzzk6VTMZV31cOss3MI2HJoFqhThMHG6c/UY7Op9acqd68FbZb7M/ldiFI55ooFvfDTyf85QRujfv+ID4zDkY8ucRau4Eov1NONDsjSNAXyjW1DzPyq4aQ X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:CO6PR11MB5602.namprd11.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(1800799024)(376014)(52116014)(23010399003)(366016)(18002099003)(38350700014)(56012099006)(11063799006);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?rptaZCtWdVEFrPP4ZSFIWA400lld?= =?utf-8?q?kVWFhhYwv770IcPLVb7Nd8Fg4r/ELwNJIUdEGnKXYITGUHA/E6Pb7bpdPk2Gu+jjm?= =?utf-8?q?kEyDtCJbRrwmZCOXtWMzQjFgEtqrt4zjjWPnRoMU/41I4iSJd1mw43W5ueTm+tOhM?= =?utf-8?q?QxKhej7ee51BvntkMSLiJzHJsUEuNTYNnGgJrKtgTzFbscOVwfWxJ52AaNkrE1SgX?= =?utf-8?q?f3rbGfuWkhncq0lpoA+uGmqeh84ocr0S4F5vLvogifMIp+qPpdynPKW8mgM+ov6Fw?= =?utf-8?q?H+AzhBQesdE3QVkMCEy8YPjUBMDPzYd6j6kNVxsJiZWkrM8YVrJ9AMvWGIgzRMHae?= =?utf-8?q?SNuEWwTry50TT3EzrNCRehTOHJlTZ+D2LT9lcyq1KbLYIaFS9GDgTIedCclKzX3Zk?= =?utf-8?q?3+kdY1objF98F6xEzv5ahxCrd/AZobUqdqW1s4Jiv1YeTIaS5QQbg4SZSF1iiJyix?= =?utf-8?q?rgS6TBcJ5QEbqycxJ8mUaVU9A1DnBkqcI8qa2LlvAPRMokYfhBptGOf0BnVO9ql+l?= =?utf-8?q?61RQVtCRs51rY6ZXwz/6OIrda1X92Ty0MpBdbow5xIy7cnZWi7yVvLxK89cskKmni?= =?utf-8?q?Q2bFJxknakcDhd7U8GN1IKOqDjnU9tp3YbID9zNKk4ArSWe0ay+UV7r61h2XO4pBS?= =?utf-8?q?j1nywTnVfoYgRCZqiKewdU0X9KGpCEyTiGxfhFXdlJvHD3Zb40helG6q2uXrK3YyM?= =?utf-8?q?UoB4OhqTuJjFpDD4WlPUGZjgXq+wb/mPtxAaC2rfM99pkBkdC+HpDZVSCycWMAw9W?= =?utf-8?q?boqdLqNPWbzLOaiOjoXt34CY+fTGK3o2sgVz4yDvO40x8ptsaaltadwXr1CVqtpHb?= =?utf-8?q?0qklgW9trPTATHLq8KQWo/ziDq9R+rJ0sALWKq0Eo+LY0Deod1o9WMfAnxTelS0bb?= =?utf-8?q?bekOgFEiwMauEJVlVBDYcq6cDsQUjyyOznaaaznNV02TvFU8688gBudrJaXd24fj2?= =?utf-8?q?sB7RfQ/pzR2JBu/1v89WqeNodOSmMAAYveLKwGyidj3aH8ZTG03NFHRXWCR9y8rWV?= =?utf-8?q?gHi2it1qqxRjzb2ybPsMbHrMrCLiKGhnl8k5iixOUSgFqSa9/ht6e5NwJgXUYOHQf?= =?utf-8?q?yvuidE7N7bm21/Ub3nZUnCiy9N5rkUy/LrhcmP2tkOCup959KUdfYP5b+jUFfEIyf?= =?utf-8?q?gHyRM7kcao/YzjiUzwl93Cyi08VFnIRBHzt459oQD7luztdCK4z+EdYmQkwaffHeC?= =?utf-8?q?dciKcVmGciGzxq5rTtfIUR+esbRnerW7vdLsvKLuV7/cGR57qNe045PZJABXgvIvy?= =?utf-8?q?OEiypMlzcrz1ua0xE0S7PlYhK6vEQNr+F93tw/BDlbg2zv/xkLGH+dr6Ih6NacQAw?= =?utf-8?q?HESxvmjme6rpNEx0RwAjgjGP5pAKeoAh3VhlyR9sPCEgBt3z132POUDjaMuZtmYmV?= =?utf-8?q?ggEr+pRE2PkKINbV5viDfwXhG5w955qCu+ZuBwAbbNjGUpVGBcM6BOn7jtWy9V12E?= =?utf-8?q?VwYl3ATS9e9nk+wID9kDwmGuYzdvkJDRlAfuTdj1PjXBBw0A2FcTUQT4bxPhgeATR?= =?utf-8?q?SW74bzWof4uFjcWy92OBS5ztovXddsHnr/nmu11FJNFjv3/hd1JweZWvwMH5wSlpi?= =?utf-8?q?nP+EQN9CprU6JLuUULtPq7ogRt60ON8/pqfwnj/EO7XPNOptzohtV3UNP1Zie3ncQ?= =?utf-8?q?Mgehpcyr7zjcRKLCX1NWCs/XVvGCgO/w=3D=3D?= X-Exchange-RoutingPolicyChecked: frDRy7lrPFtXRDQhtGQt58gf0jIB068wcCRYTWp179+rAFqIcxLgZlGCEoUc+HIj9WB7g6TJj/qFfK0Ba4QDLlJWfViOLMo6mYD613yAaFxBJoMmmcdc7PCLvEcQTLQtlip4G2ZEaImXh0U5Xwf4SNervvaUREzp11Q4A7c9c1dbCtkJ03MO7OWsx1NZBEFHJ4VD1h8GCheSVLXgBY0iRjlKdk4J9dDRciQxd+cM6RaUTsRlBOZRkLpXPAHOFtVNqx/njx5LI6Zqlx3ug1YPw5Yu2w+R7KzevVJ+UFkAJzTl8ZODbDlK5Fid2ezcrVwctTQ/Xqd2v456gKrv9DfgCQ== X-OriginatorOrg: windriver.com X-MS-Exchange-CrossTenant-Network-Message-Id: a0796d3b-c4c6-435e-7cf3-08decaa6cafc X-MS-Exchange-CrossTenant-AuthSource: CO6PR11MB5602.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Jun 2026 06:24:45.3178 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 8ddb2873-a1ad-4a18-ae4e-4644631433be X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: s4PgsiB0rrFDMuJEgFOwgVMlNpwBvJ21pS51tC7dkbQj2YE81HtXHNnhMNVU0RRCecNKYbIoFM9N1X6ijGGWiA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO1PR11MB5154 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwNjE1MDA2NCBTYWx0ZWRfX3h+dzptasurr bwk9aBKBV216YcD74/noJk6ye4mOG1GnICq69GUJhicDKeVTJ2Uph1bCloEhhQ88yfNffiIhEbg aiX5Pw/zvJE+Y10QnFkX8drx1Sk0PyShocxIiXAaz9BuNAeeh1d9ubxmJWYRfbIqVb5lWS9S/S0 NZ4lbtejZi9bIMJwtbZcWfT3Pq4Yi0qN22ylV8ARevpGgqi1dzfqysoijPeu8ElzS6ObnSTbi4B wxFJR2Hx3abWMWzuv+R2K+A3UcDuAKrug5g/NtO7XiDML9+kexn6GRPe64CkzbVYkTzWx/TkDs2 E465dVL7Ouwe+f5wjSI+tKeXemBhw91LOt7AdTI2bEqj3hmJXhs4zpqMSDbzhaVHILsxdFEqmMJ T2jRKJssVRMqOIbbdLSVmvpe5CWWZnR46guydSXvz25iQDLR/jiQ7g7BvEaAdp9pROJ8y9bN/vF wcBjeReGAkresIFonZg== X-Authority-Analysis: v=2.4 cv=BK+DalQG c=1 sm=1 tr=0 ts=6a2f9ab0 cx=c_pps a=OAmo50eV21M7Ophgg7+Z+Q==:117 a=6eWqkTHjU83fiwn7nKZWdM+Sl24=:19 a=z/mQ4Ysz8XfWz/Q5cLBRGdckG28=:19 a=lCpzRmAYbLLaTzLvsPZ7Mbvzbb8=:19 a=xqWC_Br6kY4A:10 a=IkcTkHD0fZMA:10 a=FelO9ux0wxsA:10 a=VkNPw1HP01LnGYTKEx00:22 a=bi6dqmuHe4P4UrxVR6um:22 a=klDOsUkWDRETUCZYPvoE:22 a=t7CeM3EgAAAA:8 a=ljOHmGDoImW_DtJpQMQA:9 a=3ZKOabzyN94A:10 a=QEXdDO2ut3YA:10 a=FdTzh2GWekK77mhwV6Dw:22 X-Proofpoint-Spam-Info: AW1haW4tMjYwNjE1MDA2NCBTYWx0ZWRfXy90THyc04Oko 3/4MPIUjQZifv2Z0N0N0uMHjSEy+PD7F7DHJXP1UmpzVjiQE+WG/gXcCikFJx/2mS4iDEi7GHM4 X5KdoCCnB17ifIyA26C2rh4tPGiBoVrdYLgAo0OrR70dq2Z1SfUw X-Proofpoint-GUID: lpLO38Vkp_pKm56Tx9b5gHHkrWNOW8bl X-Proofpoint-ORIG-GUID: lpLO38Vkp_pKm56Tx9b5gHHkrWNOW8bl X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.125,FMLib:17.12.100.49 definitions=2026-06-15_02,2026-06-12_03,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 adultscore=0 lowpriorityscore=0 priorityscore=1501 malwarescore=0 clxscore=1015 bulkscore=0 suspectscore=0 impostorscore=0 spamscore=0 phishscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2606040000 definitions=main-2606150064 X-MIME-Autoconverted: from 8bit to quoted-printable by mx0a-0064b401.pphosted.com id 65F6Ntvk216469 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Mon, 15 Jun 2026 06:25:02 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/9715 From: Chen Qi Document the upstream-stable-release-point bbclass which automatically generates UPSTREAM_STABLE_RELEASE_REGEX for recipes with dot-separated version schemes, enabling stable point release upgrades. Signed-off-by: Chen Qi --- documentation/ref-manual/classes.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/documentation/ref-manual/classes.rst b/documentation/ref-manual/classes.rst index 95e07f85a..f0d9b1d55 100644 --- a/documentation/ref-manual/classes.rst +++ b/documentation/ref-manual/classes.rst @@ -3655,6 +3655,30 @@ Three variables control this class: :term:`INITSCRIPT_PACKAGES`, :term:`INITSCRIPT_NAME` and :term:`INITSCRIPT_PARAMS`. See the variable links for details. +.. _ref-classes-upstream-stable-release-point: + +``upstream-stable-release-point`` +================================= + +The :ref:`ref-classes-upstream-stable-release-point` class automatically +generates the :term:`UPSTREAM_STABLE_RELEASE_REGEX` variable for recipes +whose version uses a dot-separated scheme. This enables stable point release +upgrades — version upgrades constrained to the same stable series (e.g. +``1.4.2`` to ``1.4.3`` but not to ``1.5.0``). + +The class uses the :term:`STABLE_VERSION_PARTS` variable (defaults to ``"2"``) +to determine how many leading dot-separated parts of :term:`PV` constitute the +stable prefix. For example: + +- With ``PV = "1.4.2"`` and ``STABLE_VERSION_PARTS = "2"`` (default), the + generated regex is ``^1\.4(\.\d+)*$``. +- With ``PV = "259.5"`` and ``STABLE_VERSION_PARTS = "1"`` (e.g. systemd), the + generated regex is ``^259(\.\d+)*$``. + +For recipes whose stable version part is not dot-separated (e.g. openssh uses +``10.2p1``), set :term:`UPSTREAM_STABLE_RELEASE_REGEX` directly instead of +inheriting this class. + .. _ref-classes-useradd: ``useradd*`` From patchwork Mon Jun 15 06:24:35 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: ChenQi X-Patchwork-Id: 90093 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 9A898CD98CE for ; Mon, 15 Jun 2026 06:24:52 +0000 (UTC) Received: from mx0b-0064b401.pphosted.com (mx0b-0064b401.pphosted.com [205.220.178.238]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.123782.1781504689957317431 for ; Sun, 14 Jun 2026 23:24:50 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@windriver.com header.s=PPS06212021 header.b=LVINFMOX; spf=permerror, err=parse error for token &{10 18 %{ir}.%{v}.%{d}.spf.has.pphosted.com}: invalid domain name (domain: windriver.com, ip: 205.220.178.238, mailfrom: prvs=062669d7a8=qi.chen@windriver.com) Received: from pps.filterd (m0250811.ppops.net [127.0.0.1]) by mx0a-0064b401.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 65F6Ntvj216469; Mon, 15 Jun 2026 06:24:48 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=windriver.com; h=cc:content-transfer-encoding:content-type:date:from :in-reply-to:message-id:mime-version:references:subject:to; s= PPS06212021; bh=R01EzcQtMYeD0H1edN23mtvkvwIa84mX8CdACb/Q1Dg=; b= LVINFMOXt+vmSO2rYiWGh0lpG+4Qc7h5rkTYPFRAcTq+F1YYNJejjgyGjO3+7fsr xF7QV0RDleYGjPC+7UooPCay2c8MHeR7bfsz+uOWDazZLzXNcFIH/uW1bzb7DxVT ImMOo8OjX+WkrL4cuU3ZVBfrJrnMj0jiv8dwXbUIvzsLs2EFk2LvYiq+QEDzYN3R R2caipdYZFI9JBHsVeYOAqxfbQqSIrth2ljaAqJPk2ujg5uMPVju3gqGLJpO9R0G S77bR7WoIVcGPKHbpr0WGhOMXMCs5BcH3aJ4swk5wsDfb3nWrykurRA8QFJgf5Ql YbIUqVtVnOsXSav9xZTA0w== Received: from sn4pr2101cu001.outbound.protection.outlook.com (mail-southcentralusazon11012015.outbound.protection.outlook.com [40.93.195.15]) by mx0a-0064b401.pphosted.com (PPS) with ESMTPS id 4ervkp2bvm-1 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NOT); Mon, 15 Jun 2026 06:24:48 +0000 (GMT) ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=oY4KLoO+3quQ5ftPggl2ck1xiHABCxekE6XsYx9Zh2D9pS6tBHyPcAQyBiC00u4Z/APhCSJ163F+JcWXM9Gvu5/AOnmSeoNHWYQVhyPtG6sBlqw4JqINEWBx/zYb33A9/Ne0pgoCPhL9TnDpOrJ35O5bqkZystNMs95/X7KcyRA8cg/H32raXkXtJUiwW5K4+sf+vyMuTUQ/vjFync/QXQsjSL7MAUVmBhEqC2qQ0ugslB4illCLvIjg0d2KixSrZrW4WVWXETuNmPPLZGacQoNDpMiOL1CehaOyr/Tafm2naNKgYbbeRHLnkoXqM8Fk65P2b9fg1Y/qatPPoh9K8Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=R01EzcQtMYeD0H1edN23mtvkvwIa84mX8CdACb/Q1Dg=; b=SaFI5rrWrYwWAfFhIlkZxFFN4Bs2ozxlpGG16Rm31CJxLyu0nTSvOpkQI4HzNOJEIGUdY49wSPvIYhRl0mvhlGuVhmKDGpcPt738Az96MJMx0GmS2lDvQ4eYecIzmaVvHaGHxOulKIfOgEUzL3rbjWcsS3nm/8CvmgYREYm0JF21PcB100dQYueBBBkmS1ZItQirCGcQM8S7Kn9qjA1zL0h1TmSyGUe5WoszE5AOQNU1GWk32vJdvf/MHkJGCLBnXtLVTmeSg0m8RIGEiElvl+jFh4h6a+DGqmA0VkoSHOC+OYUrpmKMJ0m+61M5M9ckLeV5EQX3XR8jUj3aMIXOMQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=windriver.com; dmarc=pass action=none header.from=windriver.com; dkim=pass header.d=windriver.com; arc=none Received: from CO6PR11MB5602.namprd11.prod.outlook.com (2603:10b6:303:13a::5) by CO1PR11MB5154.namprd11.prod.outlook.com (2603:10b6:303:99::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.21.113.18; Mon, 15 Jun 2026 06:24:46 +0000 Received: from CO6PR11MB5602.namprd11.prod.outlook.com ([fe80::5ad6:8f90:b01d:2c62]) by CO6PR11MB5602.namprd11.prod.outlook.com ([fe80::5ad6:8f90:b01d:2c62%3]) with mapi id 15.21.0113.015; Mon, 15 Jun 2026 06:24:45 +0000 From: Qi.Chen@windriver.com To: docs@lists.yoctoproject.org Cc: alex.kanavin@gmail.com Subject: [PATCH 2/3] ref-manual/variables.rst: add UPSTREAM_STABLE_RELEASE_REGEX and STABLE_VERSION_PARTS Date: Sun, 14 Jun 2026 23:24:35 -0700 Message-ID: <20260615062438.3119651-2-Qi.Chen@windriver.com> X-Mailer: git-send-email 2.54.0 In-Reply-To: <20260615062438.3119651-1-Qi.Chen@windriver.com> References: <20260615062438.3119651-1-Qi.Chen@windriver.com> X-ClientProxiedBy: SJ0PR03CA0143.namprd03.prod.outlook.com (2603:10b6:a03:33c::28) To CO6PR11MB5602.namprd11.prod.outlook.com (2603:10b6:303:13a::5) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CO6PR11MB5602:EE_|CO1PR11MB5154:EE_ X-MS-Office365-Filtering-Correlation-Id: 2a1c434b-3699-4abe-d327-08decaa6cb2f X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|376014|52116014|23010399003|366016|22082099003|18002099003|38350700014|56012099006|11063799006; X-Microsoft-Antispam-Message-Info: dF1CB8/ituABH6B9oydx4JB9N2p1egPFoN21actDC7IS8JZt/LEzScNxOVx6L5PZUown/3EsYrgMfXpPZdMItCq5lqYULjb8VZ8wlfRy3pf1F8aSLuT2+17IYiexLHq+jEbtXiBAiQ5T0jSrVJdZQYl1HMs1aofZKXfL7pqZQcxvIrw98nizdLvaUsX03V5Bfj0H6qXmt1sZv6OVyS+XH6wIj003xESmlIxzAcy3hBcXdbNdNiiHKQppjZ+iyEsG6TiYxHFHkbr8NUGtx+GI4LSk04d0lmj2Sjzv/ZwVBPvN3uqtrvmXwn3lk2NiTplD/r2A+K1MwyFzMuf6x/8MQhRTJXwV8m/zWoLB7WEpSouxf2ic48bWiS4naH94+x/4kQLqgFBGEUfHGwBGd1Okb0XsxyZPgC3JMoeqZbAIgtgbQgEn0/rphZPWuz/n9+GON+PGkXFovLRkYmjYV764XMZly04L1I7SYYDx+i3ORNgi5vB8D3I7zGDyT9tenx6QWTUJmbPsUeHmbYnQ65TJoNXOMD7AvJ82JyXfyiu8UELZq8V40fZYbwTadlIWLrIZCE58tqjxiQvnpf8HfxSXGxqzof41Lqb1OH9UzZmwHJQjsZmPEsFtgzkGjzgHRQwvIZ3+eTSGo7CQd7INPQ6Xw9O8ggO1MgXWYPdug8iZsiSc6u7zlwv0YNWAM1HwuGm8iazjplWQHTr5zj1L2duK0RiEikzYPXnEvG9INBxbtttlqsslYDQXfVO1szl5ueLZ X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:CO6PR11MB5602.namprd11.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(1800799024)(376014)(52116014)(23010399003)(366016)(22082099003)(18002099003)(38350700014)(56012099006)(11063799006);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: mEvmJF9o0Nh2gagaFUTWLJ6mMxbNttf94Caz8SoWyHUk9rVvGDPBEf6TMcUzA13yJ8oAytnudbyR7raTL5ujW6SW9TGqJb1CqNYY/Aa5RUVgOrexvT4I/UEGHsO6YB9L41ZPMOpqZXtxL9/mL8WYmlLMM4MOSfOl9WKYQA3XpfuO5/9h78+yCzj84rjIiwQfGZvFCZmcxIF0KQlWqMC/eHs6BD/ARactHhkT33iqK+wkc8MDzS2RM80cHKhXp9jHXMQFZdxzTQHxph3Ugs1JG4xZAfsxkuAyrdcfZdXCoZVXAFnWfIHJ6fVUQkYTUs9kv/jA2PI4tgbFf746ARnuzaMTu8nAo6Ndf3+L/kFomIZ1lgb4TbuZ8WT5bQLs63NiKXmCZE+YNQYY4qasTCReZwzQt7oh56mId89Cu/d0zR2MceNt5GmU8LA4eGJluNIQ1mBeKKXJkaWZnBZNvjq+rXc2hPT842Ux2P9SrkQMyzQku1NXFGEdQ1j5n1ewMkCEbF9Tj5mKN9z4xD5ZaupNv0ef41TAi9qqyU02qQQgGKMCdohtdz2Cmv7J5z/1nBc5XAw2eTEsHJpg4rP8HL6zyn9ohTzGZjwYx8z82GpTVKDEs6666ukFQp+x7a3kfYtBLb8v2mw3PAANdg3jXssWBsXyvGubSVtbmHQicNNaeatjnhjE9BW6D3KcS3E9R++cnYIGWEENwik+plPKmdBP3+/AbojP+D5lyWLREPcpTKR69vnYJ+DG8ISPG+PCEvIuI2GlDeLhwo7DNWlQh/2rKD2KoZ9SQdSzuft77AaDiBJYBjJx9NC681PRtUo6iuj74navaXqXN8AQrZu4pGD7KFw3NTSbPtXRK3m7w+7PYz4+QHTdadRMFC6xYLAGfCLdh2HMsD3BnS1eDkGde/D/w4vWvQ3C3AkPjdSp/DsV6jlbAny5dDizs52r6uPV737LjY+lSNK7bExcLJBDfyU3FFxbB+COTAAmsCksbc3MEF6I/NEzQxKsbNBcMPHFifb3EUdisuqZnMJsBXILGTahed1rEbR7C6qbsuYBRLcFM3Rl0QZd3bAuuVg5/+US0dPO8raOjg6pkKXXKBga7fYx3ezA4aEl3j4ZjUVLIPb+rdaYX/fAgeePGbP9+rhmVQO8++cnPJXTUyPfLyO5FdzYgwd5+G9vRD+Nfipk5d+C2HbEFZwzPFQUkvy4zJ/ORyYzJL40bwAuQK1bcSIkfSVeFmSGtroBmPe2ncwfo38NFsU+eMj3nPGBVDdDurzsqStLKLIbxeiPndf0ONvVxxo90/1AwBEXgq/zDo40H6nUfkulu41D5MotixefHPJyseTqRJ1rkHbsq5yknSWo48HaMKdruUUmzlFfpM95iyVDjT/BwTCaJqv3jX8ToZ1JTvh9QZUSuqPJiKxdEBUzHy91+vNqZlCTIoLWd2GiSZ16XrTZYzZzycpOFzXyFhHu/IjqUC1cdpESY1v9icpMZZSPzW97QlGwT2BBIRN3eYNMFri2dY4UlGwf4NMcL4zbeMF0OQHxw/Q5unQspICKDvATSUfn+2vYRsnorlVGfVpviKVxil5UwIiXwaYx+f2R1Y0gEJ34EebNoULaR4wru0WC77GfYS5bFRYNIKdzMaGBFKBARqhQhcsuP66ixRjFIx3LG5BdaLY2eSPFZepF7YTm68XyMKQYz0Rpz7D+QpuVaPr1t7hjAStXMOfVvu4vBNueNGAd2SKkQQtD0reyPRnlEA== X-Exchange-RoutingPolicyChecked: NOF4ihK+L3ztJXQQux5OeVV8VYzc0PBZm9Yu4EXmZ995psq/iLu0leGO2/xulmXKp3GbP2nmo1OjEZCjOShXEhf115EjOFK3N6+MOjFFmxniYNS2OPykdndnf5GOkGhO6iK5jTOVQMki/8eXdmk77KLqKgtesexlzvkIhLcskJWg3scaNAxp0mAal8Mc0VanTxJg7F6uwxYmNi8etRU0q2FoSXuCvdIDi/qXiicMx/DbbjPus3ZeS9JqOxol+8SV/Bw2oTnuZWIdzWQVXrWKopWtitfvpNbbbHE/ZX5mHBPoH5VvCYLpjUyiFBF08CMFimpQKcSaRD+8cO5gi/D7TA== X-OriginatorOrg: windriver.com X-MS-Exchange-CrossTenant-Network-Message-Id: 2a1c434b-3699-4abe-d327-08decaa6cb2f X-MS-Exchange-CrossTenant-AuthSource: CO6PR11MB5602.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Jun 2026 06:24:45.6990 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 8ddb2873-a1ad-4a18-ae4e-4644631433be X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 6bT99PP3dtXapS8KRsJXDevFUKSdBITXXo97scUHbgda+oCJFtQWvayzfcfp4ddMNueyId6VMoxGods43Ymfww== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO1PR11MB5154 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwNjE1MDA2NCBTYWx0ZWRfXwuUf88qAK54g wzOARqmjtQhdSjGNNmBi18ytY1w781F2CeHKHOoYGAePo5fyBeaq3gGs+eRqTyabd8X76pjJZEm YhyMuXWimzbya+ICLWxjWWzbsc5nhFT3hH7gIhk2oaMNax8sZF7d1zmk3MALF34cxtYz2iGvyGg Jfq7P92ZhiXt572MDHP/MoYbmb2w6MC6ZTFBHtq4rILDyN8DCYervWj+qzV+5oi1/qElGmz8bIN tQJMfihK0s6pucGjjI8eD3DMqoxLqliIikcg0TeN80tNKlyqj2otLFZ71a9nAADkhUGNodzFRku 7S96+eB5ZcHPUcHpBsFj836k3g4F+/jtw6YNvC1T+MMLerLGm4vP/3fiKP/9jM9ofVvqMhU7qvs P1eKvwfHtojqrjCDBRtd2WX4T4M9hsgPf5EnU/6JjZ3vi+SFdy3HjY7m9lEVkWCw2kmJD55s0lH YVFbY63udIuu7dHBgUw== X-Authority-Analysis: v=2.4 cv=BK+DalQG c=1 sm=1 tr=0 ts=6a2f9ab0 cx=c_pps a=OAmo50eV21M7Ophgg7+Z+Q==:117 a=6eWqkTHjU83fiwn7nKZWdM+Sl24=:19 a=z/mQ4Ysz8XfWz/Q5cLBRGdckG28=:19 a=lCpzRmAYbLLaTzLvsPZ7Mbvzbb8=:19 a=xqWC_Br6kY4A:10 a=FelO9ux0wxsA:10 a=VkNPw1HP01LnGYTKEx00:22 a=bi6dqmuHe4P4UrxVR6um:22 a=klDOsUkWDRETUCZYPvoE:22 a=t7CeM3EgAAAA:8 a=e08-atkVFR6WX4J2vB4A:9 a=FdTzh2GWekK77mhwV6Dw:22 X-Proofpoint-Spam-Info: AW1haW4tMjYwNjE1MDA2NCBTYWx0ZWRfXw++7SYPHenMM Dog0PzrWPLk7lvvK4itNkjz/MOrppZL+OesCpv6lKKPsdNyy3VMJtBltnQ67ex5GDuwirzjg9yB eDTs5IgpWyzvclzmeDUxM0EcEQECaTgio2lW8o1PFF7FTyK9dGD5 X-Proofpoint-GUID: FeR7lVe2pbgVJ0boFVQZmsSExZAbX1Wh X-Proofpoint-ORIG-GUID: FeR7lVe2pbgVJ0boFVQZmsSExZAbX1Wh X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.125,FMLib:17.12.100.49 definitions=2026-06-15_02,2026-06-12_03,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 adultscore=0 lowpriorityscore=0 priorityscore=1501 malwarescore=0 clxscore=1011 bulkscore=0 suspectscore=0 impostorscore=0 spamscore=0 phishscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2606040000 definitions=main-2606150064 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Mon, 15 Jun 2026 06:24:52 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/9714 From: Chen Qi Document the two new variables used for stable point release upgrades: - UPSTREAM_STABLE_RELEASE_REGEX: filter regex for upstream version checks - STABLE_VERSION_PARTS: controls how many version parts form the stable prefix Signed-off-by: Chen Qi --- documentation/ref-manual/variables.rst | 28 ++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index fe3d5a999..cb11f7901 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst @@ -10097,6 +10097,15 @@ system and gives an overview of their function and contents. SSTATE_SKIP_CREATION = "1" + :term:`STABLE_VERSION_PARTS` + The number of leading dot-separated components of :term:`PV` that + constitute the stable version prefix. Used by the + :ref:`ref-classes-upstream-stable-release-point` class to generate + :term:`UPSTREAM_STABLE_RELEASE_REGEX`. Defaults to ``"2"``. + + For example, with ``PV = "259.5"`` and ``STABLE_VERSION_PARTS = "1"``, + the generated regex matches versions starting with ``259``. + :term:`STAGING_BASE_LIBDIR_NATIVE` Specifies the path to the ``/lib`` subdirectory of the sysroot directory for the build host. @@ -12001,6 +12010,25 @@ system and gives an overview of their function and contents. UPSTREAM_VERSION_UNKNOWN = "1" + :term:`UPSTREAM_STABLE_RELEASE_REGEX` + A regular expression used to filter upstream versions during version + checks so that only versions within the same stable series are + considered. When set, BitBake's fetchers (git, wget, crate) apply this + regex to discovered upstream versions and discard any that do not match. + + For example, if a recipe is at version ``1.4.2`` and the regex is + ``^1\.4(\.\d+)*$``, then ``1.4.7`` would be a valid upgrade candidate + but ``1.5.0`` would not. + + For recipes with dot-separated versions, inherit the + :ref:`ref-classes-upstream-stable-release-point` class to generate this + variable automatically. For other versioning schemes, set it directly:: + + UPSTREAM_STABLE_RELEASE_REGEX = "^10\.2p\d+$" + + See :ref:`ref-manual/release-process:stable point release upgrades` for + the criteria under which this variable should be set. + :term:`USE_DEVFS` Determines if ``devtmpfs`` is used for ``/dev`` population. The default value used for :term:`USE_DEVFS` is "1" when no value is From patchwork Mon Jun 15 06:24:36 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: ChenQi X-Patchwork-Id: 90095 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 8E666CD98C5 for ; Mon, 15 Jun 2026 06:25:02 +0000 (UTC) Received: from mx0b-0064b401.pphosted.com (mx0b-0064b401.pphosted.com [205.220.178.238]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.123723.1781504691001089634 for ; Sun, 14 Jun 2026 23:24:51 -0700 Authentication-Results: mx.groups.io; dkim=fail reason="dkim: body hash did not verify" header.i=@windriver.com header.s=PPS06212021 header.b=h6YMRQ/d; spf=permerror, err=parse error for token &{10 18 %{ir}.%{v}.%{d}.spf.has.pphosted.com}: invalid domain name (domain: windriver.com, ip: 205.220.178.238, mailfrom: prvs=062669d7a8=qi.chen@windriver.com) Received: from pps.filterd (m0250811.ppops.net [127.0.0.1]) by mx0a-0064b401.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 65F6Ntvl216469; Mon, 15 Jun 2026 06:24:49 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=windriver.com; h=cc:content-transfer-encoding:content-type:date:from :in-reply-to:message-id:mime-version:references:subject:to; s= PPS06212021; bh=zrCcU6qHFxuLhGk/DQOHbSaitYeffbi2Pn9ysz9UQ2g=; b= h6YMRQ/dVSZzIkPursJblomCsJF9lJadWrS9CxuL2j6X8//lM4vC8jVoVkwoMbsD N+jt5gJH4iI1dKbjl29QmQZQLImHpsDgx9EZMqBjRBAvyNO3IN6wjYcgsY2oU0Fj 7Ne1n6VdankSHQjDNuaVc91SmS08px4AVaH7WiDU7bScZ6nt9W/13Q3AB7fME/Sz QwxZ9savYn8sH7sP2r8u96ftzk6rxvxgPqoJG85fg91nTZfoSQx1rDcrQLsYVp3g 4ljb3Wf20bLY8Xe3aVK9XO5hC5IS/iZGpu/RXELT1Kn9Op1YqSaYJN/1dmCtE01F nBQBFMyMGay6HnIT+kn1Gg== Received: from sn4pr2101cu001.outbound.protection.outlook.com (mail-southcentralusazon11012015.outbound.protection.outlook.com [40.93.195.15]) by mx0a-0064b401.pphosted.com (PPS) with ESMTPS id 4ervkp2bvm-3 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NOT); Mon, 15 Jun 2026 06:24:49 +0000 (GMT) ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=l1EaUgteqAqDR2xcY/rYJdekLNtMMFelrOUKZTssSnNPToPk5xNayyfWNs2whMfhqnJEzRoOzWY6O+lk2EYC762EAl9BMZpajBW6k1szbS+6RgUSmzSwZSDsZqz6hnYe5KTBEAwUugW13zBxs4d2I+AupfuHD/kO6RXX8Fy5y4zmVE+jzsjId0eZ0RpZw4w2PrRYhTB0kZtl2dPwKndq8BsvjpW2CEbvdOuYj066rbb5ZoM0p6ELEkGilbCndQ+d6gvzSWN6Ty/KMUKpiAMXLV3wcEElHFuFWZUC/TbGuWv06xTzAClX0jc8to/bCGl5Hq1XNUnYpxx5pjt+9YcBFg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=zrCcU6qHFxuLhGk/DQOHbSaitYeffbi2Pn9ysz9UQ2g=; b=DyQJfAYkmyZEqJWJwUgXMso15pPbl7EqTFpGjzXCshkKoQvKUbVrVDwWYNjSuGnlrDlsenxpM+IJL/23eNaMyHaKExDU1hVxg3Hz0D87L1obPTdyVheW9M50p5sYHbZeecdFitEUTajlgTMU3iDbWLUopzCDRbtV6Vb7F2sZf+yW63G26cbdcJflaYvBMTzfwTxlp781yxdVamUPwrUr9v7fmbBX8GM8PR6r+6ntCspNMgwjdfeexyg0uPNHJm7lbH8xgSMxUUGI5j3dp6E+IJm3491okZOaDb/oEt+CuSlUUF9zZfG40uIpfYkR/A/wl2qwojqLqmxQrEJ6LtDIAA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=windriver.com; dmarc=pass action=none header.from=windriver.com; dkim=pass header.d=windriver.com; arc=none Received: from CO6PR11MB5602.namprd11.prod.outlook.com (2603:10b6:303:13a::5) by CO1PR11MB5154.namprd11.prod.outlook.com (2603:10b6:303:99::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.21.113.18; Mon, 15 Jun 2026 06:24:46 +0000 Received: from CO6PR11MB5602.namprd11.prod.outlook.com ([fe80::5ad6:8f90:b01d:2c62]) by CO6PR11MB5602.namprd11.prod.outlook.com ([fe80::5ad6:8f90:b01d:2c62%3]) with mapi id 15.21.0113.015; Mon, 15 Jun 2026 06:24:46 +0000 From: Qi.Chen@windriver.com To: docs@lists.yoctoproject.org Cc: alex.kanavin@gmail.com Subject: [PATCH 3/3] ref-manual/release-process.rst: add patch acceptance policies and stable point release upgrades Date: Sun, 14 Jun 2026 23:24:36 -0700 Message-ID: <20260615062438.3119651-3-Qi.Chen@windriver.com> X-Mailer: git-send-email 2.54.0 In-Reply-To: <20260615062438.3119651-1-Qi.Chen@windriver.com> References: <20260615062438.3119651-1-Qi.Chen@windriver.com> X-ClientProxiedBy: SJ0PR03CA0143.namprd03.prod.outlook.com (2603:10b6:a03:33c::28) To CO6PR11MB5602.namprd11.prod.outlook.com (2603:10b6:303:13a::5) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CO6PR11MB5602:EE_|CO1PR11MB5154:EE_ X-MS-Office365-Filtering-Correlation-Id: 3251c722-73ce-4979-48b2-08decaa6cb7b X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0;ARA:13230040|1800799024|376014|52116014|23010399003|366016|22082099003|18002099003|38350700014|56012099006|11063799006; X-Microsoft-Antispam-Message-Info: u/CM4trNuhsyzXYkRZXd54euuImYtGlV1TzxyFm67Tz8wiTgQNpdTjzdi6jXvHtSe1ifwvaAWUkfvLaZ/9xlmKaYGeSzbYXybezAhucJYjfXr2rlyJGKSp5f3IobYowKdg6J3UBjOZILtZ8YZ7a7SLHWakNARsFB1IZ1ObJ+Y4NrnnW1OOcbqf2r2CsGoDo8lKbr2v7OTFvmQ0Q67FsIcu9Jp3QP/Wr6IWr/FBV5zQOIwKsvXiaoKta/PTBhSQfi/NeaJeiLeTsT5reZGOqvq3/qLYmVd432r6RJpdZcN8DHqEBo+4viU89EfpT6GD0VrYKGAK/2jTSM9WWl28XUU+1Ve6PBv+TVs3p/sHjU4Ro4AmzSGdwEiW2cpqL0FaO13IpFEHww7oiDZRot5Tq9BhKUthqI1uNgoGEs28jdA7vS7SqOBMpCLBwtrUKBJSfgvJUZPfZGalQQbMpkW1vtgWenrQa34UXB9mPWQYFfNAIe4uZ0RObAOs0zckgDSmSTs8Cg6eiflFBGXBkdXjwNJB2XzLOKTK6z93pSpq2Y/JrSpKr5HEXu9thoDFkarykOKsDF7ChfvSXWDlXWFkcb+OD2G3qVxHojxjI7soUbFbz+vfPqF5YqaA3ckuTBMNTEwxUfHtzk1iwVEVooPdjN7lECMmc2gujo7tupFeD5z/mdpRB3FaFKY0ib0l6YRHnDJx8ugK1nmPQcj2m8rFVTYOxXjgNdPuM4O3iQ/1owUncEUgRqOHiZ5CIx9+nrOT+A X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:CO6PR11MB5602.namprd11.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230040)(1800799024)(376014)(52116014)(23010399003)(366016)(22082099003)(18002099003)(38350700014)(56012099006)(11063799006);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?gPPuipIkxnBIMpSP17TVBxZgf+Tc?= =?utf-8?q?SakyFHoJKk95u+dfYAc6Fkg8WJWTSaRWXKo5A5G89yk69e/Fivw4Pig2ut0OcuOGc?= =?utf-8?q?ljD62QAVk3aE6apvxFfutHTiIuFAPrg9GTM/7ITc2u7D4VetLEeyQvQY7Ngu9H9nh?= =?utf-8?q?545Dib2tn8MSadTjn72fWDXP4vMPr2k4lkQC52kw+hM+EeLCU/9VDKwC7nMdKT3b6?= =?utf-8?q?rwqCf2G48uMIlPN/QFNJ3DF9pD8q/5At0hhSYz/m2cuZQGZe/0rAIAsC/q0F6PpXJ?= =?utf-8?q?71rNo3FNfTYIbZPLnaGfs3JM2q/+oxm8mqoM7m+Gy1UBt9pAayNPmYcZ16av/tAso?= =?utf-8?q?11z7w6SNJfiHWuRJ/0OhtpZz/AawIKytAj6RdvW5Uyur3sXTwLrnQ0t5J60TpNqCL?= =?utf-8?q?EZavSCQKkN83jWisrWGScU05IBoX6jFWPpIoVFlEI7TmAtbGV1LKcELdf4uPHZJBW?= =?utf-8?q?W49Z1+ifOs4Q2dO4bhA/PS/ZFMqbpRAeJAmLrNJa07rOXsFW7rVmBmDgTKUiaXd95?= =?utf-8?q?UwWRaJdZ9DExeiT3hZPSEABYjhw7FCQVkTtiBIhBANZkRB6dIucN3EOf6IgodEwkc?= =?utf-8?q?E9c0VeFare5l4UQI6Wy4PaBPne0eFuWrkZI851GXlmx0KPLrUDFYCR2ZjyodUIxFz?= =?utf-8?q?yx+qaVw/yUaRJNzKQrlyMO128LWZmfSiY3SdZC9LHyLyTEYqWh5706c9ZY2Bf5E07?= =?utf-8?q?S/2SonY0dXvK3P5JDzSu61Y8p5vxMhloHFIO1pKEKJSIVU6kyT1Rd9Yrvb+ad60Fc?= =?utf-8?q?6yhe8PW9na9PSBKBN8iq3VgMryNUpIkL7nvEhdncb7OvnrgP/fMyvYQ74t7PZvCA1?= =?utf-8?q?cJcRIWNhfir1Zku/rPay6D32hnsqjSusW8jToc3hAjMpg3lHnaXYBdPMYNUXQzSpV?= =?utf-8?q?w5i4S3M9hs9b//d/rOvIzfOJS7OvalwQOIHGszPFMVWMkS7iBjn5cZnETTAw+rOV6?= =?utf-8?q?jSsx64DcS18tyCiKP+WgLqc4K/AULXSISifOx8TjBgdqmRjG9UrR6gg0y8o8dsAxC?= =?utf-8?q?RjdTr9E4jH7yFuPFSSXKHGqWbz0RRQihcn6cT6i+588vJ9SBl7MqUokdRltx61x4S?= =?utf-8?q?Zs0MDDhrQm5d+cZ+0NjXgW2xR2HoRG+5kT4SQmA/FjdVzEe2ujWaCb9ILJOgyGHLj?= =?utf-8?q?Xe1VVgqiu1DU16lhRAEtC46xUWpk5RRDKS9DgnKI5WSUXt2Wx2OuUgisJJUBGax0n?= =?utf-8?q?3SzGFlKtyEX1KJIEnagrzvHpiPgIxjzEmuKBOi5Vipx4c+dCTcstpcJ2wJJDOKcHU?= =?utf-8?q?sWIZGqH1FfaFpPa2qC7yK3+xWrDKU+7Ycy8UU4OFyDeBMM5G4WxsTzUFCBjtcEKnK?= =?utf-8?q?7mHtklGLhMRBogoIloembZzF6Pd7MMSn0nnk9skyw16BUgfM1zDev1PxBVvRuzTAj?= =?utf-8?q?YLWs/K9rEAk7O7dkcXgj1133/gjcBr1xj2JHKjWHtNyWV3ysYC5J1EFXOu9WPMnGa?= =?utf-8?q?nyNvV0ywGwJDtiIegKrKCIg8xPk/lCEjOEuWhOBAbBdxcKMmV/yiPUVTXpRXFLvFn?= =?utf-8?q?Rea1TBi2XY1S0sEuE2j2DJlSwj3J+riD5puztLOkzDeQ0cAnh6cIDmHfsjwJR+cx+?= =?utf-8?q?hgYj2MndUifuM61lvJ8n3iuZzpCIlG2UFd1T7wAZ9tcvI0iD1MZ4yZPDHZ4r7gBYi?= =?utf-8?q?/rMzqYUTH2DN/iufng8mrWZBOiAQsG2Q=3D=3D?= X-Exchange-RoutingPolicyChecked: HWUeP9pLbQMrsAPcrbRI+maRS9Z/YwYeI9Lz6Q6I/77UuReLanVQ58EpVgr9ZIGdGVBcUdK1iyo/cfVn3jph7g9fq4kbnprtyYoyw8QcNCTXz1iG3VZwPuXipJCihGbpuSIUCOIC83fBXwd3nBcaeWgtpd7wQCWA1O/dfvi43cUx5VRpvyf7WilQTI/P2xQddHRaY5GNuwUWyXmsVxIlhsPppN1t4S3eVEcfhc9YGNRAmRBFinyX4zGbRHNUBZ6RtNH9f7f2t9QGjZMy2yW8SFs1L9it0tjGMkL5v/OU325LPtpbqIZUp1jkGOOWlBrjneKgLcIxottHGhEfKczWSw== X-OriginatorOrg: windriver.com X-MS-Exchange-CrossTenant-Network-Message-Id: 3251c722-73ce-4979-48b2-08decaa6cb7b X-MS-Exchange-CrossTenant-AuthSource: CO6PR11MB5602.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Jun 2026 06:24:46.1378 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 8ddb2873-a1ad-4a18-ae4e-4644631433be X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: wG4P9lg1qmMaBdKFzR7y2TzgaKDGVCj9zkmSZQIKXcyhxGzJmWFuwpNzwJrdPdIuK+bQTQL8forp7hOOh4PQyA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO1PR11MB5154 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwNjE1MDA2NCBTYWx0ZWRfX0UMLfr6PfgI4 8B3TPl4P4AaRPhE4DWlsC+lTn7Sn9WIYUiGs1Aq3B4kOlH/VAXupONsYRrKLuJMUOswbukXWdLx c3UB1jM784V2YmC5xCPszS48xvH6+PqRXGQi8SeLBr1w3xeHvpMo35IKXMSquqL2jSYC5tPN83P uq6gYZ6XoLwVkkF/b3IYEqWZJ0L9p06oK6TkATtXR42Cs0v83VWryJ8s1JlEHN17LD9mzwmR2ng hrNK1W2G/GF/nkreCaOLk1dfJCvpTMnZV1M5c4Y+177B7nwM1oecSng3UcrFO8hjg4N/RSoQXuP XbpGLU/6q2TTjc87ebPhG6wAbF2msphEfKkpnBRj7z9YF7GXGCKV8KgAA+9eTnhJjXKM575dQEI yIo5KIcaI/dWcGtYLbzIYNkM1raAp0gAvbwVe1WHMX9tsd2lVS63uJdw0OC+jYI3pNEnQJt46ab 6civsc7nfXERcv7szGA== X-Authority-Analysis: v=2.4 cv=BK+DalQG c=1 sm=1 tr=0 ts=6a2f9ab1 cx=c_pps a=OAmo50eV21M7Ophgg7+Z+Q==:117 a=6eWqkTHjU83fiwn7nKZWdM+Sl24=:19 a=z/mQ4Ysz8XfWz/Q5cLBRGdckG28=:19 a=lCpzRmAYbLLaTzLvsPZ7Mbvzbb8=:19 a=xqWC_Br6kY4A:10 a=IkcTkHD0fZMA:10 a=FelO9ux0wxsA:10 a=VkNPw1HP01LnGYTKEx00:22 a=bi6dqmuHe4P4UrxVR6um:22 a=klDOsUkWDRETUCZYPvoE:22 a=t7CeM3EgAAAA:8 a=VShSNdALnTx5IIslTvEA:9 a=3ZKOabzyN94A:10 a=QEXdDO2ut3YA:10 a=FdTzh2GWekK77mhwV6Dw:22 X-Proofpoint-Spam-Info: AW1haW4tMjYwNjE1MDA2NCBTYWx0ZWRfX8Y3BXcdPTp6x N0iUE15+2saYER+HnO7e8/BeGnJn+32+BjxAsGY9IFsWqr7vfm6D/pE3gGMhAWM+ysMb1sFLUyW T81wyt4owBfL7/wjdT8+5tS6P/Jw0lJIChfmlBTxGk35Gmcz/4xb X-Proofpoint-GUID: QNIrKYOrH_k9yjWJ4y5Lnyip7bikxZBY X-Proofpoint-ORIG-GUID: QNIrKYOrH_k9yjWJ4y5Lnyip7bikxZBY X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.125,FMLib:17.12.100.49 definitions=2026-06-15_02,2026-06-12_03,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 adultscore=0 lowpriorityscore=0 priorityscore=1501 malwarescore=0 clxscore=1015 bulkscore=0 suspectscore=0 impostorscore=0 spamscore=0 phishscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2606040000 definitions=main-2606150064 X-MIME-Autoconverted: from 8bit to quoted-printable by mx0a-0064b401.pphosted.com id 65F6Ntvl216469 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by aws-us-west-2-korg-lkml-1.web.codeaurora.org with HTTPS for ; Mon, 15 Jun 2026 06:25:02 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/9716 From: Chen Qi Move the Stable/LTS Patch Acceptance Policies from the wiki into the reference manual. Expand the 'potentially acceptable: bug-fix-only version upgrades' item with a new section documenting: - criteria for qualifying upstreams (stable branches, maintainer confirmation, historical evidence) - how stable release regexes work to constrain version checks Signed-off-by: Chen Qi --- documentation/ref-manual/release-process.rst | 97 ++++++++++++++++++++ 1 file changed, 97 insertions(+) diff --git a/documentation/ref-manual/release-process.rst b/documentation/ref-manual/release-process.rst index a55187c14..3bccbfbdb 100644 --- a/documentation/ref-manual/release-process.rst +++ b/documentation/ref-manual/release-process.rst @@ -127,6 +127,103 @@ stable release. exception to this policy occurs when there is a strong reason such as the fix happens to also be the preferred upstream approach. +.. _ref-stable-lts-patch-acceptance-policies: + +Stable/LTS Patch Acceptance Policies +===================================== + +All changes must have already been accepted into the current master release +and any other release still within its stable support window. + +**Acceptable:** + +- Security and CVE fixes +- Fixes for bugs +- Changes to follow an upstream stable series or LTS that aligns with + the original release (based on compatibility) + +**Potentially acceptable:** + +- Fixes so the codebase works with newly released distros (only in the + first six months after a given release series first release) +- Bug-fix-only version upgrades for upstreams that meet the criteria for + stable point release tracking (see + :ref:`ref-manual/release-process:stable point release upgrades`) + +**Unacceptable:** + +- General version upgrades +- New features +- ABI/API breakage + +.. _ref-stable-point-release-upgrades: + +Stable Point Release Upgrades +============================= + +Some upstream projects maintain stable branches that only collect bug fixes +and security patches — similar to the Yocto Project's own stable release +policy. For recipes tracking such upstreams, it is possible to perform +*stable point release upgrades* (e.g. upgrading from 1.0.2 to 1.0.3) rather +than only accepting backported patches. This is the mechanism behind the +"potentially acceptable: bug-fix-only version upgrades" policy above. + +Criteria for Qualifying Upstreams +--------------------------------- + +Setting :term:`UPSTREAM_STABLE_RELEASE_REGEX` for a recipe means that certain +version upgrades can be confidently treated as stable point upgrades under +OpenEmbedded's criteria. The Automated Upgrade Helper (AUH) will then +automatically upgrade recipes with this variable set during stable releases. + +.. note:: + + Recipes without this variable can still be upgraded for stable releases + through manual review. They simply will not be picked up automatically + by AUH. + +A recipe may have :term:`UPSTREAM_STABLE_RELEASE_REGEX` set if any of the +following criteria are met: + +1. **Upstream stable branches exist** --- the upstream project maintains + branches named with a stable version component, and there is evidence + that these branches only collect bug-fix and security-fix changes + (no new features or ABI/API breakage). For example, util-linux version + ``2.41.3`` has three parts in its version and upstream has branches like + ``stable/v2.41`` with two parts. This demonstrates that bumps in the + third part (e.g. ``2.41.3`` to ``2.41.4``) are stable point releases. + Similarly, systemd maintains ``stable/v259-stable``. + +2. **Upstream maintainer confirmation** --- the upstream project's maintainer + explicitly confirms that a bump in a certain part of the version is + bug-fix only. + +3. **Clear historical or common-sense evidence** --- the project's change + history clearly shows that a certain class of version bump is bug-fix + only, or it is widely understood convention. For example, openssh's + ``p`` suffix increments (``10.2p1`` to ``10.2p2``) and kmod's patch-level + bumps are historically bug-fix only releases. + +How Stable Release Regexes Work +------------------------------- + +The stable point upgrade mechanism uses a *filter regex* to constrain the +upstream version check so that only versions within the same stable series +are considered. When a recipe sets :term:`UPSTREAM_STABLE_RELEASE_REGEX`, the +version-checking infrastructure in BitBake's fetchers (git, wget, crate) +applies that regex to filter discovered upstream versions. Only versions +matching the regex are considered as upgrade candidates. + +For example, if a recipe is currently at version ``1.4.2`` and the regex is +``^1\.4(\.\d+)*$``, then version ``1.4.7`` would be a valid upgrade candidate +but ``1.5.0`` would not. + +For recipes whose version uses a dot-separated scheme, the +:ref:`ref-classes-upstream-stable-release-point` class can automatically +generate this regex. For other versioning schemes, set +:term:`UPSTREAM_STABLE_RELEASE_REGEX` directly in the recipe. + + .. _ref-long-term-support-releases: Long Term Support Releases