From nobody Thu Dec 18 01:48:53 2025 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id F1E191D54C2; Tue, 11 Feb 2025 06:23:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; cv=none; b=h9Hc4rdFcsVUeF6EE7b8wLWSjcBNmp/XzsDtzO3UkVH52V22+UxIMkPY1FvhQhTj+NIM1J9T2PVnPnFU+TTMv3297WzVMY/i/5UgFjQt9al3KoSyiiZuBPxtkj6/PSxAOiAaNYtvGyHDWn1Gb61LLcZ1ExOt+hyio3pPPwsgpyk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; c=relaxed/simple; bh=t4nvCsVaeq/JWg5HRJsbxqzjIAI8bXe8VWVi54lXQhI=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=PEHLpzf3I7g14zmL1Cgme4KVhOIR4RdnTu9TmamtgyzLxX/DrRuPNrv8xLXB97KEmXIFXXXs6PnmSk4Cdwjm+g7Ryh2buBNItXw3sQfzfW/tVjUPxSoALFNNGX+HeCn1g05uTq96N5IcD4GQeBzxOzsAdrCuXqgiAhArLQWGsNQ= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=YJYZ/+7h; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="YJYZ/+7h" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 826AFC4CEE4; Tue, 11 Feb 2025 06:23:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739254994; bh=t4nvCsVaeq/JWg5HRJsbxqzjIAI8bXe8VWVi54lXQhI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=YJYZ/+7hJosWMfEZ28HJjJhTP3Q5VQyEJbDLYTss8M8hrB7i/k9VAreWE+sJVZCRC SoRdczOhg8x0un+CW/AfoqJ3C7e4YrgaUE7OpHBu6+A/I3QaCrPDuT5n22kjBYV9le eBVeZ+gYKwNVQ2fjZv+0JH1tu3UYIAli0pXA7gFE1cSJFJdaRjl1gEYoPjWeUZTz6l 5ssX1As1PSmocWoJsHiyJk7mYvJS70ogxrSKC5ITWvPp6ppdu27bOzEF9ltFm1I3VX /xSzkkKT/lJs7BRAhfobftYGLcaRuCuvplSCvBJ1y4w9Kcu6yuD6naBE5vgAP2xV1y xkgybcRkbtJSQ== Received: from mchehab by mail.kernel.org with local (Exim 4.98) (envelope-from ) id 1thjfs-00000008YBH-34yO; Tue, 11 Feb 2025 07:23:12 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , Sean Young , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 1/9] docs: media: Allow creating cross-references for RC ABI Date: Tue, 11 Feb 2025 07:22:55 +0100 Message-ID: <7c2f9a9970a15df8b5e3a6ecd21bcedcc8881ce1.1739254867.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.48.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" Now that Documentation/ABI is processed by automarkup, let it generate cross-references for RC sysfs devnodes. Signed-off-by: Mauro Carvalho Chehab --- Documentation/sphinx/automarkup.py | 17 +++++++++++++---- .../userspace-api/media/rc/rc-sysfs-nodes.rst | 2 +- 2 files changed, 14 insertions(+), 5 deletions(-) diff --git a/Documentation/sphinx/automarkup.py b/Documentation/sphinx/auto= markup.py index 22defc18d6d2..03bb7020f5cb 100644 --- a/Documentation/sphinx/automarkup.py +++ b/Documentation/sphinx/automarkup.py @@ -88,13 +88,13 @@ def markup_refs(docname, app, node): # Associate each regex with the function that will markup its matches # markup_func_sphinx2 =3D {RE_doc: markup_doc_ref, - RE_abi_file: markup_abi_ref, + RE_abi_file: markup_abi_file_ref, RE_abi_symbol: markup_abi_ref, RE_function: markup_c_ref, RE_generic_type: markup_c_ref} =20 markup_func_sphinx3 =3D {RE_doc: markup_doc_ref, - RE_abi_file: markup_abi_ref, + RE_abi_file: markup_abi_file_ref, RE_abi_symbol: markup_abi_ref, RE_function: markup_func_ref_sphinx3, RE_struct: markup_c_ref, @@ -279,10 +279,10 @@ def markup_doc_ref(docname, app, match): return nodes.Text(match.group(0)) =20 # -# Try to replace a documentation reference of the form Documentation/ABI/.= .. +# Try to replace a documentation reference for ABI symbols and files # with a cross reference to that page # -def markup_abi_ref(docname, app, match): +def markup_abi_ref(docname, app, match, warning=3DFalse): stddom =3D app.env.domains['std'] # # Go through the dance of getting an xref out of the std domain @@ -294,6 +294,8 @@ def markup_abi_ref(docname, app, match): =20 # Kernel ABI doesn't describe such file or symbol if not target: + if warning: + kernel_abi.log.warning("%s not found", fname) return nodes.Text(match.group(0)) =20 pxref =3D addnodes.pending_xref('', refdomain =3D 'std', reftype =3D '= ref', @@ -317,6 +319,13 @@ def markup_abi_ref(docname, app, match): else: return nodes.Text(match.group(0)) =20 +# +# Variant of markup_abi_ref() that warns whan a reference is not found +# +def markup_abi_file_ref(docname, app, match): + return markup_abi_ref(docname, app, match, warning=3DTrue) + + def get_c_namespace(app, docname): source =3D app.env.doc2path(docname) with open(source) as f: diff --git a/Documentation/userspace-api/media/rc/rc-sysfs-nodes.rst b/Docu= mentation/userspace-api/media/rc/rc-sysfs-nodes.rst index 34d6a0a1f4d3..70b5966aaff8 100644 --- a/Documentation/userspace-api/media/rc/rc-sysfs-nodes.rst +++ b/Documentation/userspace-api/media/rc/rc-sysfs-nodes.rst @@ -6,7 +6,7 @@ Remote Controller's sysfs nodes ******************************* =20 -As defined at ``Documentation/ABI/testing/sysfs-class-rc``, those are +As defined at Documentation/ABI/testing/sysfs-class-rc, those are the sysfs nodes that control the Remote Controllers: =20 =20 --=20 2.48.1 From nobody Thu Dec 18 01:48:53 2025 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id F1DB826BD8B; Tue, 11 Feb 2025 06:23:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; cv=none; b=kk+qAt11Y2CQJq+/VUJJ++ulK39X0oD0yD0Zj+q0ibAufDMU8cwDFoJyuHy/QAdP3/yx5MrfHvbeZaWf3ADnWiHzlweY99yNNm6LGBtzJxcL7SnBVT6Adb2fUaqHDhldrC4Ku25/A3hfazWBmLpe2zX66VCu12chbVtx7un5mcw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; c=relaxed/simple; bh=GrjMjuoBldG0YBxJhhKh6xKhPGHktjhoxv5+WyCxFXo=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=YCvGA7TPeb4JMrifu50rSClrFDdc8S6Ix0J6/xgkUWhhJcXSsJVQ6fFSExhCXTgQ8hLl+MqILqxYgSuWnx7U863wQHYEABdB/2V+pslCfhtw0N6lBNIjtugJOYY7DOpHmfO6WLxyJgpgAUqKtG3YTuXDTu7VW+HJ56wCeZ8rYdM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=gmmskVaP; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="gmmskVaP" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 85709C4AF0B; Tue, 11 Feb 2025 06:23:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739254994; bh=GrjMjuoBldG0YBxJhhKh6xKhPGHktjhoxv5+WyCxFXo=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=gmmskVaPWkTFwVQR9sjKR9vsQKL2EtjEVwRSZyu22R2FVBqhYRvAaLZElUbHC6v3j pjqSXljTiV8XKyzI3gb0wWZCD9DciGJkVyMwEIteIir0zHHGfcxql0K/NC+nHOEsP/ AblfeQqEIRx5QGS5ArQXVLDRg6hha96SmWHDBGVVk2wZ40cMtl1Et/U/CH/rhXHr3d 4q4wKFsByDHIKylKhrIcmwI+JyfjP0FkBtF0IjH9DEcILyLs3Wtunjamen5DSJyWf7 VkvFDkgJ15W5NeaOvYZTIZYF7KDoCk4+xjPCxfkWXtDm0a8W4bxdUSQcy3A4g3emuZ byUpIiHp5+Plg== Received: from mchehab by mail.kernel.org with local (Exim 4.98) (envelope-from ) id 1thjfs-00000008YBL-3C08; Tue, 11 Feb 2025 07:23:12 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org Subject: [PATCH 2/9] docs: automarkup: drop legacy support Date: Tue, 11 Feb 2025 07:22:56 +0100 Message-ID: <5cb57d158e42957d4bff06db38be141d849ac13b.1739254867.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.48.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" Python 2 is already EOL for quite some time. Drop support for it. Also, the minimal Sphinx version is now 3.4.3. So, we can drop support for Sphinx < 3. Signed-off-by: Mauro Carvalho Chehab --- Documentation/sphinx/automarkup.py | 32 +++++++----------------------- 1 file changed, 7 insertions(+), 25 deletions(-) diff --git a/Documentation/sphinx/automarkup.py b/Documentation/sphinx/auto= markup.py index 03bb7020f5cb..ecf54d22e9dc 100644 --- a/Documentation/sphinx/automarkup.py +++ b/Documentation/sphinx/automarkup.py @@ -13,14 +13,6 @@ from itertools import chain =20 from kernel_abi import get_kernel_abi =20 -# -# Python 2 lacks re.ASCII... -# -try: - ascii_p3 =3D re.ASCII -except AttributeError: - ascii_p3 =3D 0 - # # Regex nastiness. Of course. # Try to identify "function()" that's not already marked up some @@ -28,22 +20,22 @@ except AttributeError: # :c:func: block (i.e. ":c:func:`mmap()`s" flakes out), so the last # bit tries to restrict matches to things that won't create trouble. # -RE_function =3D re.compile(r'\b(([a-zA-Z_]\w+)\(\))', flags=3Dascii_p3) +RE_function =3D re.compile(r'\b(([a-zA-Z_]\w+)\(\))', flags=3Dre.ASCII) =20 # # Sphinx 2 uses the same :c:type role for struct, union, enum and typedef # RE_generic_type =3D re.compile(r'\b(struct|union|enum|typedef)\s+([a-zA-Z_= ]\w+)', - flags=3Dascii_p3) + flags=3Dre.ASCII) =20 # # Sphinx 3 uses a different C role for each one of struct, union, enum and # typedef # -RE_struct =3D re.compile(r'\b(struct)\s+([a-zA-Z_]\w+)', flags=3Dascii_p3) -RE_union =3D re.compile(r'\b(union)\s+([a-zA-Z_]\w+)', flags=3Dascii_p3) -RE_enum =3D re.compile(r'\b(enum)\s+([a-zA-Z_]\w+)', flags=3Dascii_p3) -RE_typedef =3D re.compile(r'\b(typedef)\s+([a-zA-Z_]\w+)', flags=3Dascii_p= 3) +RE_struct =3D re.compile(r'\b(struct)\s+([a-zA-Z_]\w+)', flags=3Dre.ASCII) +RE_union =3D re.compile(r'\b(union)\s+([a-zA-Z_]\w+)', flags=3Dre.ASCII) +RE_enum =3D re.compile(r'\b(enum)\s+([a-zA-Z_]\w+)', flags=3Dre.ASCII) +RE_typedef =3D re.compile(r'\b(typedef)\s+([a-zA-Z_]\w+)', flags=3Dre.ASCI= I) =20 # # Detects a reference to a documentation page of the form Documentation/..= . with @@ -87,13 +79,8 @@ def markup_refs(docname, app, node): # # Associate each regex with the function that will markup its matches # - markup_func_sphinx2 =3D {RE_doc: markup_doc_ref, - RE_abi_file: markup_abi_file_ref, - RE_abi_symbol: markup_abi_ref, - RE_function: markup_c_ref, - RE_generic_type: markup_c_ref} =20 - markup_func_sphinx3 =3D {RE_doc: markup_doc_ref, + markup_func =3D {RE_doc: markup_doc_ref, RE_abi_file: markup_abi_file_ref, RE_abi_symbol: markup_abi_ref, RE_function: markup_func_ref_sphinx3, @@ -103,11 +90,6 @@ def markup_refs(docname, app, node): RE_typedef: markup_c_ref, RE_git: markup_git} =20 - if sphinx.version_info[0] >=3D 3: - markup_func =3D markup_func_sphinx3 - else: - markup_func =3D markup_func_sphinx2 - match_iterators =3D [regex.finditer(t) for regex in markup_func] # # Sort all references by the starting position in text --=20 2.48.1 From nobody Thu Dec 18 01:48:53 2025 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id F1E701E3DFD; Tue, 11 Feb 2025 06:23:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; cv=none; b=janRaDjTzJ6sSMMn1OqUnaiQH9eNl9U3yVJQV1dksnCKNbOzVLZCvM6Clg3eq0Kb8rXVatY+FR75XLi2+VGsbxNWvpvKNL9tbul9p8i/Z0+acoO3vwZS2ipowHLaRG0njvdjjV4AkKVsoQ5PNaO5kI2hs564V004HcJYwBQbkOY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; c=relaxed/simple; bh=rbk4BpPM7ONpaeiUWNXID/PprX5q2RG5Ax9J83M5MFM=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=KRcbHhdAohzXq8ReGenDvMNF4PzZ95WSrhu4LUDRR7M6kO581nlZEFB2JSpqxIpM194toK2ClxbaMgVhfGhMoEsYenI1Kw2WiwHq990foDCoqzAgRYH6rOQ7DIOUYBOgs+xFKJXqRQsQxUdAEGt9HpLEXi1ZcZCqPOH8PDDGGGs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=G5RNmNSo; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="G5RNmNSo" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 9017AC4CEE5; Tue, 11 Feb 2025 06:23:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739254994; bh=rbk4BpPM7ONpaeiUWNXID/PprX5q2RG5Ax9J83M5MFM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=G5RNmNSoMc+SaaL2V2pZNmm3UdE6xYr4BD4fUnKW9b0Hzkh0t00EVzF7wbkrN/vlg mM4J8/ioHnIHkI7P9ZI+T9f9vKiFCgcmqJtlOXuhj0GdfEaRirRXIMD64Uwx5YuGce EwSCWuyu0sy8+8gIa77CTR5LhVfgS3hiog7YAJX8Qo0XQGiAaxBjqpJ1ljrtFDyySW 3Hd/MjSarGn7VIIdpbkX+aKXoseawV5n7f+N8mlhx/4Ih/t+RYvgg9c2qJn7BPYqeZ zKU/A6TPjzDlSVC3qZa/zCaWl65XO1HBT31Kl8yDrCd+NZUfsft723s7FfwODvz84p gQ7PoVEKRX83w== Received: from mchehab by mail.kernel.org with local (Exim 4.98) (envelope-from ) id 1thjfs-00000008YBP-3J0Z; Tue, 11 Feb 2025 07:23:12 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , Andreas Noever , Michael Jamet , Mika Westerberg , Yehezkel Bernat , linux-kernel@vger.kernel.org, linux-usb@vger.kernel.org Subject: [PATCH 3/9] docs: thunderbolt: Allow creating cross-references for ABI Date: Tue, 11 Feb 2025 07:22:57 +0100 Message-ID: X-Mailer: git-send-email 2.48.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" Now that Documentation/ABI is processed by automarkup, let it generate cross-references for the corresponding ABI file. Signed-off-by: Mauro Carvalho Chehab Acked-by: Mika Westerberg --- Documentation/admin-guide/thunderbolt.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/admin-guide/thunderbolt.rst b/Documentation/admi= n-guide/thunderbolt.rst index 2ed79f41a411..d0502691dfa1 100644 --- a/Documentation/admin-guide/thunderbolt.rst +++ b/Documentation/admin-guide/thunderbolt.rst @@ -28,7 +28,7 @@ should be a userspace tool that handles all the low-level= details, keeps a database of the authorized devices and prompts users for new connections. =20 More details about the sysfs interface for Thunderbolt devices can be -found in ``Documentation/ABI/testing/sysfs-bus-thunderbolt``. +found in Documentation/ABI/testing/sysfs-bus-thunderbolt. =20 Those users who just want to connect any device without any sort of manual work can add following line to --=20 2.48.1 From nobody Thu Dec 18 01:48:53 2025 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id F1F1A1E5B83; Tue, 11 Feb 2025 06:23:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; cv=none; b=TDc1ivzBn0YdFiKePf0cRydxGnUCsweMYkY3BeKaDVyA/R0bAEfHHRlzwdfJD3uxQmYIf06FryM3cYf0QiViiI6I2lxYN2qDoukc2E2Uozi9P94ow4diXuN+BhJsYt1+PZaWZ3Wf9jNYHziJo0jta5pgpdpaumKW2Lr48AyvipA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; c=relaxed/simple; bh=70CpwTFUuUr0ZBQHvWnlxclVDHf464oJy3CMyyAPe6g=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=FLVEhYk4dCpS/vwJT8XOfYm6YScxn3ceDsIptSI/w6pk2arXfSmSNM3OsRN60TvfpgsK6EGI1euC8ieUr90V/DZpG+WwsfuNoAomsBorzFWRVnv1SkinEe4s0Tvr3tF8IJY1C3854ywk8TZmGjG/RvWIRfP7bH7cfv4RQorqhDM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=t4QwFvCu; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="t4QwFvCu" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 924D9C4CEE8; Tue, 11 Feb 2025 06:23:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739254994; bh=70CpwTFUuUr0ZBQHvWnlxclVDHf464oJy3CMyyAPe6g=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=t4QwFvCuFNBkd8ieLaQ/6s/TkWAFdurcyaPHENdXyoZjkcCWDSZHyY6Rql9/m4SnK X0uPU4IEQ6wH1i8AHJNUCpLB+fBy+TZ1M4vl7qXQt0rRhKf3gbdKv9EcW3kLvzoNI7 wbnWBIvHCO9TmZPS3auqvLF4iWlmOliTDwEcRozQjGq1E4y4e/r5jIn3PPjHtCd2rT fh5Gy6CoWhtEyNzHqsYaaKHECaXndzELHI+FiOmY/DzPPp/uS5ioCtqkTOsUig28bB qZeXe8sPO1TxoMpcDUy+fGKzbeEaf8eBNrRaisf/yeG/J2agMYZfeH+QMl1CESSp+B Yf9lhiakCc9qg== Received: from mchehab by mail.kernel.org with local (Exim 4.98) (envelope-from ) id 1thjfs-00000008YBT-3QKt; Tue, 11 Feb 2025 07:23:12 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , Catalin Marinas , Will Deacon , linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org Subject: [PATCH 4/9] docs: arm: asymmetric-32bit: Allow creating cross-references for ABI Date: Tue, 11 Feb 2025 07:22:58 +0100 Message-ID: <0a989eea90e5d03a36a07760f8b505e074e85c03.1739254867.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.48.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" Now that Documentation/ABI is processed by automarkup, let it generate cross-references for the corresponding ABI file. Signed-off-by: Mauro Carvalho Chehab --- Documentation/arch/arm64/asymmetric-32bit.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/arch/arm64/asymmetric-32bit.rst b/Documentation/= arch/arm64/asymmetric-32bit.rst index 1ca2b359a907..57b8d7476f71 100644 --- a/Documentation/arch/arm64/asymmetric-32bit.rst +++ b/Documentation/arch/arm64/asymmetric-32bit.rst @@ -55,7 +55,7 @@ sysfs =20 The subset of CPUs capable of running 32-bit tasks is described in ``/sys/devices/system/cpu/aarch32_el0`` and is documented further in -``Documentation/ABI/testing/sysfs-devices-system-cpu``. +Documentation/ABI/testing/sysfs-devices-system-cpu. =20 **Note:** CPUs are advertised by this file as they are detected and so late-onlining of 32-bit-capable CPUs can result in the file contents --=20 2.48.1 From nobody Thu Dec 18 01:48:53 2025 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 749331E9B3D; Tue, 11 Feb 2025 06:23:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; cv=none; b=Duw1G+5s/AVRRbxoEmh4pl6zEP0ktQjEhFRIsUnXgMT0KU06iSWAdkRfU2DQHicbaz2muC3yo7AsIv0Pxd57rEN5ZGZN6YRa+uPyUexjLsePFoBa1DYnHENIMZwvAZfEGwE0bwclkUCH0Lw+7cRxSb4pY3hPggvpO+FABxRg+qw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; c=relaxed/simple; bh=QXk/JHBxUK/Ths9qSQMqY9AnKVsl6SgMJq6d9H2BT/U=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=YflDUGS+ILXCbJ7uWZCwtY8eEmEvOStCDydZL5Bp4w0mlh16khkw3MdwAmhSmRt0AAGvNE9zS+SdUsjZ/HVbpgtPrLe4b2QHE9eh59wlcUr+EJSmE3MPMGL7YfHu06HShTOx7avuJoj0OAU8LyLFlVozuduUzjpRmP8fff6dXYA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=KOUv8xbi; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="KOUv8xbi" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 94BA6C4AF09; Tue, 11 Feb 2025 06:23:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739254994; bh=QXk/JHBxUK/Ths9qSQMqY9AnKVsl6SgMJq6d9H2BT/U=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=KOUv8xbi9st74/o9+AtogiTH40aS0q0hLloHaZz1sRq0DuFfWVK6OEkHJ0YMRWqmh tdTAAyL2pHaiBMzpTNF7kmcuACYWZH/8EwqX4IOLF5ydzhEuzVINSRZfxm/jwzJAwX Y2TgNR9A5fQhIEN0rKhEWxt62lMyAfswm7KTMAmK1O6t6yFa24HARZK0Ca4/fnRWJg 6QfX5g8mF7V4SsCc8pzg7vWgO4ykROcaHQKTR8IfiSBkafucV0Eb6fHxCnSMLlxHy0 S3x+5UYu+kdFn1kfX3yMcpb9s7fiX/bmshKsezlmZqyYpzI0uW19bo/hPmEqQFHGsF QN7Y+3FxthBUw== Received: from mchehab by mail.kernel.org with local (Exim 4.98) (envelope-from ) id 1thjfs-00000008YBX-3XNq; Tue, 11 Feb 2025 07:23:12 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , William Breathitt Gray , linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 5/9] docs: arm: generic-counter: Allow creating cross-references for ABI Date: Tue, 11 Feb 2025 07:22:59 +0100 Message-ID: <5faafb98c331e0c99433f36dd72badcc540a1baa.1739254867.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.48.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" Now that Documentation/ABI is processed by automarkup, let it generate cross-references for the corresponding ABI file. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/generic-counter.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/driver-api/generic-counter.rst b/Documentation/d= river-api/generic-counter.rst index 71ccc30e586b..e826f16ea43d 100644 --- a/Documentation/driver-api/generic-counter.rst +++ b/Documentation/driver-api/generic-counter.rst @@ -467,7 +467,7 @@ Counter sysfs Translates counter data to the standard Counter sysfs interface format and vice versa. =20 -Please refer to the ``Documentation/ABI/testing/sysfs-bus-counter`` file +Please refer to the Documentation/ABI/testing/sysfs-bus-counter file for a detailed breakdown of the available Generic Counter interface sysfs attributes. =20 @@ -483,7 +483,7 @@ Sysfs Interface Several sysfs attributes are generated by the Generic Counter interface, and reside under the ``/sys/bus/counter/devices/counterX`` directory, where ``X`` is to the respective counter device id. Please see -``Documentation/ABI/testing/sysfs-bus-counter`` for detailed information +Documentation/ABI/testing/sysfs-bus-counter for detailed information on each Generic Counter interface sysfs attribute. =20 Through these sysfs attributes, programs and scripts may interact with --=20 2.48.1 From nobody Thu Dec 18 01:48:53 2025 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 72A7E1E9B3A; Tue, 11 Feb 2025 06:23:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; cv=none; b=Y9dRkwE/8UkAgsQmoA3K1L2AZq13u2FERpJKmOp74pO5+NgIhIoAwhYScVzGElbGiRsYjAfWLnGGvfXYmfT6ZszU2+pVVnVBB0XmTN7b+ol1IEKQKp+GIfQdN6ZS/uKjTFrs1AYafATjTb3pwhRRX5ud/GCiOmBUJGTvrbbHNqc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; c=relaxed/simple; bh=VP+0OZbabFM/0FL6qHMMCJ1i/0p2nHkpJ06PdIuFtZI=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Tb7BwY7i5jw/X/xDrnZ/R9dBg8Nn17A+oP69gbwbPN90gN4USp0uw3+VrdGnbZfi5XH5Cr+pIQrjn3d7cwabzW1dkdW+tVcsbOpo+lBiYeEvb34XxlQy7eV9NsGH20Hx8j9vIv+N6BOWewzMARkon3H0y0xv0XExRFE2VhwRU3M= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=Pjh52V0E; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="Pjh52V0E" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 98EDEC4CEE7; Tue, 11 Feb 2025 06:23:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739254994; bh=VP+0OZbabFM/0FL6qHMMCJ1i/0p2nHkpJ06PdIuFtZI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Pjh52V0E77oHC1Y+5uIoCFbvR2qJk9UAgxY7OMKVVUeI5FfHVkpd/4BhFbF7EqqvU xu6aKV9ks6DCL7yixJT0aN2KSMgiy3zPWIWQpO2+VKbkm1M+LZXfdyTudYhndTZ49k QWqh58vAh2gfHxmMs1BGp8S5xVg6kpg7OjkKzuwUP4BienTkkUs95CUMX1GIqOucy5 EpLrwSsdqpkYneK5xsBOFw3tbFZQmoiUch9979fRNnFjYezaM9pUPVAzShz+36s7ch pkbdUv21DCoPwZb7diXrNLxfcud/MwOWbgZCS8K+cQAH/SPQ6wUeA8YxB4OP8SKo5V Ay4VCA1gX0Oiw== Received: from mchehab by mail.kernel.org with local (Exim 4.98) (envelope-from ) id 1thjfs-00000008YBb-3eUT; Tue, 11 Feb 2025 07:23:12 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , Jonathan Cameron , Lars-Peter Clausen , Thorsten Scherer , linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org, Jonathan Cameron Subject: [PATCH 6/9] docs: iio: Allow creating cross-references ABI Date: Tue, 11 Feb 2025 07:23:00 +0100 Message-ID: <10e7d46360b5e5782d5c09e2706ba47c2315df4f.1739254867.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.48.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" Now that Documentation/ABI is processed by automarkup, let it generate cross-references for the corresponding ABI file. Signed-off-by: Mauro Carvalho Chehab Acked-by: Jonathan Cameron --- Documentation/driver-api/iio/core.rst | 2 +- Documentation/iio/iio_devbuf.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/driver-api/iio/core.rst b/Documentation/driver-a= pi/iio/core.rst index dfe438dc91a7..42b580fb2989 100644 --- a/Documentation/driver-api/iio/core.rst +++ b/Documentation/driver-api/iio/core.rst @@ -60,7 +60,7 @@ directory. Common attributes are: * :file:`sampling_frequency_available`, available discrete set of sampling frequency values for device. * Available standard attributes for IIO devices are described in the - :file:`Documentation/ABI/testing/sysfs-bus-iio` file in the Linux kernel + :file:Documentation/ABI/testing/sysfs-bus-iio file in the Linux kernel sources. =20 IIO device channels diff --git a/Documentation/iio/iio_devbuf.rst b/Documentation/iio/iio_devbu= f.rst index 9919e4792d0e..dca1f0200b0d 100644 --- a/Documentation/iio/iio_devbuf.rst +++ b/Documentation/iio/iio_devbuf.rst @@ -148,5 +148,5 @@ applied), however there are corner cases in which the b= uffered data may be found in a processed form. Please note that these corner cases are not addressed= by this documentation. =20 -Please see ``Documentation/ABI/testing/sysfs-bus-iio`` for a complete +Please see Documentation/ABI/testing/sysfs-bus-iio for a complete description of the attributes. --=20 2.48.1 From nobody Thu Dec 18 01:48:53 2025 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 2D7811E990A; Tue, 11 Feb 2025 06:23:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; cv=none; b=F7BYt4fEsMAKm6eNYP9jPrZdPOagTXcy/QJF65XISqrfKlIUZ2PSwCs1Db14e0Hkyp/zbAguNp9UJEBOjN6dlaK0S/NQYrSgP6zku4+4yGX9TWNWBkfGuCOZWj3qlBursp9SPJGdDj6IrsuirQT32VpCkiMC+pXq98vdRbtmFfA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; c=relaxed/simple; bh=mcoeXqisQ9cCp+d9XJhL6+xR7Bjlo3DbBhHTGHu6E1M=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=nNLE44K8NbCdjcdNnLt9h15Bz4A1eQ4sKTBxfZRuoYiqHs/nmDFVFNAuFdksYIowhIxiIy6Yu5Z+Uj9g8VNqSlOPEfdTxMBwuG0/qB4Mr7TQTukL/EZfioqkd7TnrsvjoyGH5KuuU64KIBPMc654MJgCh9wEZSXCD9y1gyWtMPg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=sVN5nM0t; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="sVN5nM0t" Received: by smtp.kernel.org (Postfix) with ESMTPSA id A7668C4CEEC; Tue, 11 Feb 2025 06:23:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739254994; bh=mcoeXqisQ9cCp+d9XJhL6+xR7Bjlo3DbBhHTGHu6E1M=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=sVN5nM0tdhhy/eqByyC8XuNz3jFo4Gp+LWSGqFAzvzn93ltbUAis/axNGLDYhLCLP Nx7PcgBa7tXmIS4bC7MZp+jyAzj79R33cbLDxxsRxQ3KWuN5to3sU8dIuZWajsxuQa pbUfRU1uSbr3tN6Ozl7U8glhoKpLHOKJlCBek50XSwrqR9kB9J9CW4HOEdBAnwgYBX b1CBjgywTTR9/QQC5jzmgyEsksAz6Cs+8sv+My6iwWqUoHxq7/Brd4IH1CE7U52xrx 0ggOHmJcmidyCfbWDACfeFpIaCS/DTxEWXjSJhoFIpTa9SgUG1gvEaYrahmrQ5yH2J /8oJzsOXNQaWQ== Received: from mchehab by mail.kernel.org with local (Exim 4.98) (envelope-from ) id 1thjfs-00000008YBf-3lxF; Tue, 11 Feb 2025 07:23:12 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , "David S. Miller" , "Mauro Carvalho Chehab" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , linux-kernel@vger.kernel.org, netdev@vger.kernel.org Subject: [PATCH 7/9] docs: networking: Allow creating cross-references statistics ABI Date: Tue, 11 Feb 2025 07:23:01 +0100 Message-ID: X-Mailer: git-send-email 2.48.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" Now that Documentation/ABI is processed by automarkup, let it generate cross-references for the corresponding ABI file. Signed-off-by: Mauro Carvalho Chehab Acked-by: Jakub Kicinski --- Documentation/networking/statistics.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/networking/statistics.rst b/Documentation/networ= king/statistics.rst index 75e017dfa825..518284e287b0 100644 --- a/Documentation/networking/statistics.rst +++ b/Documentation/networking/statistics.rst @@ -143,7 +143,7 @@ reading multiple stats as it internally performs a full= dump of and reports only the stat corresponding to the accessed file. =20 Sysfs files are documented in -`Documentation/ABI/testing/sysfs-class-net-statistics`. +Documentation/ABI/testing/sysfs-class-net-statistics. =20 =20 netlink --=20 2.48.1 From nobody Thu Dec 18 01:48:53 2025 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 2EF941E990D; Tue, 11 Feb 2025 06:23:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; cv=none; b=Br15EXORL8urjL77XRY6vDADUh+k1PjLOps89rBrSddUSbEFlTHSIuSwTGANMWobuPFLQrPWCUNYRKUpr2uJntwoBxmRjHgL0e3/7czJROal/MK063Dkcj8bYU0o63iFelnQ9zGJ8ps4zNaZIM7tTB0cytv+1sd72WNxNLDO0R0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; c=relaxed/simple; bh=PV0mWqmAdYMvl5Hv3e7UkT26+zH8oclaLfygrOMSOZ0=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=DT91AZAhRdocJ29pqICmpMo3QQNHB2Y94Qx7bW9E4oRC2uUNbPazeauI9vyI1Ojr1BFwJa3SKA02OjYXbb+5K0jQXvdz+S0eJND1vewaPzBjCYRAX6J2+Q5UF9D43ME6pUc1nghUonrhlp/e2yc53Lsd620lGUuiiKwGGhea9kU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=P4bmxKBN; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="P4bmxKBN" Received: by smtp.kernel.org (Postfix) with ESMTPSA id A83E1C4CEED; Tue, 11 Feb 2025 06:23:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739254994; bh=PV0mWqmAdYMvl5Hv3e7UkT26+zH8oclaLfygrOMSOZ0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=P4bmxKBN1vTjyVRt/N5Uo0Yjtg8QrDXmWSiGFhUKn2cumXe1O5K82V9rbBNUbEIFY nS7E9fRwKgg9FeGgTGBiZTZI3QDTWr9vVasF9aymyxBiipBbuj18dT6OF9Mq4J+uaR eg61ThuqSXLx13D5svElPqISs/NcLz1FGE2UPtIEMn1s+Tqbg4Phjm1EQPKrwhiICB 7w+CMg3oFeFK3nNO3eUa2L54c3myxiRmqW80VcMcw8ib/us63l7TIGTB8TClLWXWPg Fl9iXiDmgv4d/V9fQ83eVzG/BqpPht9DA0fVP3KKv2UyfnPbLZ7UCkQwRAZ2Vq2o5f ALe/PSGDWIOQg== Received: from mchehab by mail.kernel.org with local (Exim 4.98) (envelope-from ) id 1thjfs-00000008YBj-3t4i; Tue, 11 Feb 2025 07:23:12 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, workflows@vger.kernel.org Subject: [PATCH 8/9] docs: submit-checklist: Allow creating cross-references for ABI README Date: Tue, 11 Feb 2025 07:23:02 +0100 Message-ID: <76e60ee8717551f3d15d7c92b9c93bbf2ca8cff3.1739254867.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.48.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Content-Type: text/plain; charset="utf-8" Now that Documentation/ABI is processed by automarkup, let it generate cross-references for the ABI README file. Signed-off-by: Mauro Carvalho Chehab --- Documentation/process/submit-checklist.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/process/submit-checklist.rst b/Documentation/pro= cess/submit-checklist.rst index 88b6358258d7..2abf8831cf74 100644 --- a/Documentation/process/submit-checklist.rst +++ b/Documentation/process/submit-checklist.rst @@ -52,7 +52,7 @@ Provide documentation 4) All new module parameters are documented with ``MODULE_PARM_DESC()`` =20 5) All new userspace interfaces are documented in ``Documentation/ABI/``. - See ``Documentation/ABI/README`` for more information. + See Documentation/ABI/README for more information. Patches that change userspace interfaces should be CCed to linux-api@vger.kernel.org. =20 --=20 2.48.1 From nobody Thu Dec 18 01:48:53 2025 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 72AF71E9B3B; Tue, 11 Feb 2025 06:23:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; cv=none; b=F09eimW5aUdrTktMAJRw5u+jSWkVptZkAhv+Z6r8PpLLvSu4oYR39QdwWo+2GibE7r7pqMOrhYOozhfSJtjQWDgzPbm+Mv5Vgvo+pV+5XWEdC9bHOu+Fxwjv57xOVM5gQJsmWx5Kzc35p8K6KtGXVSyp6uE/IRAiBwkxhX7kij4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739254995; c=relaxed/simple; bh=xJJNTHLm28pOieLtRLXBCsjINp9HkQQLtgWkMVSB5X4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=NuQUwBMXN3stOUtWtChM2aequpRtN4UDRyB+Wjfbiaa+axjsmomOMv1BSFsefuuDNYoR07KIwjQQN+nJ2vmW5y9x4LNvMxfO/rhNEI7+XbskD0cakZyur0VmoTQHngVcJrdgf0/oL8V+HWt0l+1repUeCHrL6QDJoolT0gHHQU4= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=FL55aSTe; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="FL55aSTe" Received: by smtp.kernel.org (Postfix) with ESMTPSA id B26AFC4CEF0; Tue, 11 Feb 2025 06:23:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1739254994; bh=xJJNTHLm28pOieLtRLXBCsjINp9HkQQLtgWkMVSB5X4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=FL55aSTeN5bnsbco4QM1TbvJO0WsQw3bepNk4uiUiEDE7xGFPjsbuhAaxJyMfHr5g cJEIIhiWg3EK8fDk2j53hmb0wArtgfRD9tr4j3Xm37/g3DINHkvRxrOf9tZcZwaghc MQ0l36Dl4srDoPB70+Zvm8OTSQySnwc5KSoGVKMmZxnrila95sOxN59sBtNLf9xPB3 59kMltV7jnLlSNbG94xQEf5Xr+CjzJugeAv/tcqFWz5RuB7nNEH2QAAxbhmQSmBQcI cFHJ7ys5/wASU9F59vhxInMY6/eg8CQCOAjoUy1FApWId/AjpwmCmQGABEx+5wgUWC 8aGJt2FDTm1Ew== Received: from mchehab by mail.kernel.org with local (Exim 4.98) (envelope-from ) id 1thjfs-00000008YBn-40dj; Tue, 11 Feb 2025 07:23:12 +0100 From: Mauro Carvalho Chehab To: Linux Doc Mailing List , Jonathan Corbet Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , Alex Shi , Avadhut Naik , Carlos Bilbao , Federico Vaga , Hu Haowen <2023002089@link.tyut.edu.cn>, Randy Dunlap , Remington Brasga , Yanteng Si , linux-kernel@vger.kernel.org Subject: [PATCH 9/9] docs: translations: Allow creating cross-references for ABI README Date: Tue, 11 Feb 2025 07:23:03 +0100 Message-ID: <685461ca5834c0cd4f7830f354d7ee123afb3716.1739254867.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.48.1 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Sender: Mauro Carvalho Chehab Update translations to also generate cross references for the ABI readme file. Signed-off-by: Mauro Carvalho Chehab --- Documentation/translations/it_IT/process/submit-checklist.rst | 2 +- Documentation/translations/sp_SP/process/submit-checklist.rst | 2 +- Documentation/translations/zh_CN/process/submit-checklist.rst | 2 +- Documentation/translations/zh_TW/process/submit-checklist.rst | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/translations/it_IT/process/submit-checklist.rst = b/Documentation/translations/it_IT/process/submit-checklist.rst index 692be4af9c9b..3308c3084c60 100644 --- a/Documentation/translations/it_IT/process/submit-checklist.rst +++ b/Documentation/translations/it_IT/process/submit-checklist.rst @@ -58,7 +58,7 @@ Fornite documentazione 4) Tutti i nuovi parametri dei moduli sono documentati con ``MODULE_PARM_D= ESC()``. =20 5) Tutte le nuove interfacce verso lo spazio utente sono documentate in - ``Documentation/ABI/``. Leggete ``Documentation/ABI/README`` per magg= iori + ``Documentation/ABI/``. Leggete Documentation/ABI/README per maggiori informazioni. Le patch che modificano le interfacce utente dovrebbero essere inviate in copia anche a linux-api@vger.kernel.org. =20 diff --git a/Documentation/translations/sp_SP/process/submit-checklist.rst = b/Documentation/translations/sp_SP/process/submit-checklist.rst index 0d6651f9d871..3087ba80e818 100644 --- a/Documentation/translations/sp_SP/process/submit-checklist.rst +++ b/Documentation/translations/sp_SP/process/submit-checklist.rst @@ -97,7 +97,7 @@ y en otros lugares con respecto al env=C3=ADo de parches = del kernel de Linux. ``MODULE_PARM_DESC()``. =20 18) Todas las nuevas interfaces de espacio de usuario est=C3=A1n documenta= das - en ``Documentation/ABI/``. Consulte ``Documentation/ABI/README`` para + en ``Documentation/ABI/``. Consulte Documentation/ABI/README para obtener m=C3=A1s informaci=C3=B3n. Los parches que cambian las interfa= ces del espacio de usuario deben ser CCed a linux-api@vger.kernel.org. =20 diff --git a/Documentation/translations/zh_CN/process/submit-checklist.rst = b/Documentation/translations/zh_CN/process/submit-checklist.rst index 10536b74aeec..5c20a7f0936b 100644 --- a/Documentation/translations/zh_CN/process/submit-checklist.rst +++ b/Documentation/translations/zh_CN/process/submit-checklist.rst @@ -82,7 +82,7 @@ Linux=E5=86=85=E6=A0=B8=E8=A1=A5=E4=B8=81=E6=8F=90=E4=BA= =A4=E6=A3=80=E6=9F=A5=E5=8D=95 17) =E6=89=80=E6=9C=89=E6=96=B0=E7=9A=84=E6=A8=A1=E5=9D=97=E5=8F=82=E6=95= =B0=E9=83=BD=E8=AE=B0=E5=BD=95=E5=9C=A8 ``MODULE_PARM_DESC()`` =20 18) =E6=89=80=E6=9C=89=E6=96=B0=E7=9A=84=E7=94=A8=E6=88=B7=E7=A9=BA=E9=97= =B4=E6=8E=A5=E5=8F=A3=E9=83=BD=E8=AE=B0=E5=BD=95=E5=9C=A8 ``Documentation/A= BI/`` =E4=B8=AD=E3=80=82=E6=9C=89=E5=85=B3=E8=AF=A6=E7=BB=86=E4=BF=A1=E6=81= =AF=EF=BC=8C - =E8=AF=B7=E5=8F=82=E9=98=85 ``Documentation/ABI/README`` =E3=80=82=E6= =9B=B4=E6=94=B9=E7=94=A8=E6=88=B7=E7=A9=BA=E9=97=B4=E6=8E=A5=E5=8F=A3=E7=9A= =84=E8=A1=A5=E4=B8=81=E5=BA=94=E8=AF=A5=E6=8A=84=E9=80=81 + =E8=AF=B7=E5=8F=82=E9=98=85 Documentation/ABI/README =E3=80=82=E6=9B= =B4=E6=94=B9=E7=94=A8=E6=88=B7=E7=A9=BA=E9=97=B4=E6=8E=A5=E5=8F=A3=E7=9A=84= =E8=A1=A5=E4=B8=81=E5=BA=94=E8=AF=A5=E6=8A=84=E9=80=81 linux-api@vger.kernel.org=E3=80=82 =20 19) =E5=B7=B2=E9=80=9A=E8=BF=87=E8=87=B3=E5=B0=91=E6=B3=A8=E5=85=A5slab=E5= =92=8Cpage=E5=88=86=E9=85=8D=E5=A4=B1=E8=B4=A5=E8=BF=9B=E8=A1=8C=E6=A3=80= =E6=9F=A5=E3=80=82=E8=AF=B7=E5=8F=82=E9=98=85 ``Documentation/fault-injecti= on/`` =E3=80=82 diff --git a/Documentation/translations/zh_TW/process/submit-checklist.rst = b/Documentation/translations/zh_TW/process/submit-checklist.rst index 0ecb187753e4..b09d29b0cc1b 100644 --- a/Documentation/translations/zh_TW/process/submit-checklist.rst +++ b/Documentation/translations/zh_TW/process/submit-checklist.rst @@ -85,7 +85,7 @@ Linux=E5=85=A7=E6=A0=B8=E8=A3=9C=E4=B8=81=E6=8F=90=E4=BA= =A4=E6=AA=A2=E6=9F=A5=E5=96=AE 17) =E6=89=80=E6=9C=89=E6=96=B0=E7=9A=84=E6=A8=A1=E5=A1=8A=E5=8F=83=E6=95= =B8=E9=83=BD=E8=A8=98=E9=8C=84=E5=9C=A8 ``MODULE_PARM_DESC()`` =20 18) =E6=89=80=E6=9C=89=E6=96=B0=E7=9A=84=E7=94=A8=E6=88=B6=E7=A9=BA=E9=96= =93=E6=8E=A5=E5=8F=A3=E9=83=BD=E8=A8=98=E9=8C=84=E5=9C=A8 ``Documentation/A= BI/`` =E4=B8=AD=E3=80=82=E6=9C=89=E9=97=9C=E8=A9=B3=E7=B4=B0=E4=BF=A1=E6=81= =AF=EF=BC=8C - =E8=AB=8B=E5=8F=83=E9=96=B1 ``Documentation/ABI/README`` =E3=80=82=E6= =9B=B4=E6=94=B9=E7=94=A8=E6=88=B6=E7=A9=BA=E9=96=93=E6=8E=A5=E5=8F=A3=E7=9A= =84=E8=A3=9C=E4=B8=81=E6=87=89=E8=A9=B2=E6=8A=84=E9=80=81 + =E8=AB=8B=E5=8F=83=E9=96=B1 Documentation/ABI/README =E3=80=82=E6=9B= =B4=E6=94=B9=E7=94=A8=E6=88=B6=E7=A9=BA=E9=96=93=E6=8E=A5=E5=8F=A3=E7=9A=84= =E8=A3=9C=E4=B8=81=E6=87=89=E8=A9=B2=E6=8A=84=E9=80=81 linux-api@vger.kernel.org=E3=80=82 =20 19) =E5=B7=B2=E9=80=9A=E9=81=8E=E8=87=B3=E5=B0=91=E6=B3=A8=E5=85=A5slab=E5= =92=8Cpage=E5=88=86=E9=85=8D=E5=A4=B1=E6=95=97=E9=80=B2=E8=A1=8C=E6=AA=A2= =E6=9F=A5=E3=80=82=E8=AB=8B=E5=8F=83=E9=96=B1 ``Documentation/fault-injecti= on/`` =E3=80=82 --=20 2.48.1