From nobody Wed Oct 1 20:28:51 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 5A75B2E7BDF; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=u7GRn1HqrfkX29piAPUG3TtBTQhwglQDO9Ufs6qHTZFXg7L8KAe2MG/JUtFZ3KRbJoqycpT3aNbp3hqrV4VD0aaeQGgAGiSca+k6riC57765wziFHaxr0sMff2oh7vc+g/DcQJjjVhnU2WqyJDYRq3zL4CbsKYUwP7Etafcnz/8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=0NUf4P/Q4WR/U/stb2+7dyUV24T2i6L49JbFrd1K4lI=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=SpU92kJYn58TrEEGmopDiHX0N7os7YYakeEMkrcttqlxb8a6y8aNChCHl9wfpbRiWRg0TAW1WuMoIQu1pMv/rOcWor1z7EYIpubxk+3QmPhwUKCESQ/d1dJQc4gHJpW5mBzn1xkrcfdQYgaO+zwjHqquMwPAdiZMoRtipgJtfHI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=nfM8+kFz; 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="nfM8+kFz" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 005C7C4CEF1; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=0NUf4P/Q4WR/U/stb2+7dyUV24T2i6L49JbFrd1K4lI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=nfM8+kFzQCHIpafaONhCUzNh+UoiKwIDMJiesYk5VPFcjTg6MzlECZi3aDnofHbA3 /z4VRSqyuEs2XVLCNrYDkGi9O4jdZehri2BFAuZXeEKxLCtPDs0Le+Tz/09CktDpJa 5VrzhBZE6TNMBhpcf1uqrpdhieYx7xXwYyIkq97lO2u5Snb7yA6v6aMysvEZIhjGEb FH7T61Ipai4INmYaLKYejSxKab+IBG5hKL4h82H+B+u+DDFELflLaRybVESU/vnbG6 pz8kjnJ/akuoUlg4y+0ZfpEh2hqSdwDU5t1tLpNCBpp0u6WeDt41F54QdxInPcNptd UWTQWJIVk2VNQ== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLI3-0aim; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 01/23] tools: docs: parse_data_structs.py: drop contents header Date: Wed, 1 Oct 2025 16:49:24 +0200 Message-ID: <4bf353e5248133a3b0abd82519a38453402fe7c6.1759329363.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.51.0 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" When used in practice, one may want to have multiple header files on a single rst file, like: *********************** Digital TV uAPI symbols *********************** .. contents:: Table of Contents :depth: 2 :local: Frontend =3D=3D=3D=3D=3D=3D=3D=3D .. kernel-include:: include/uapi/linux/dvb/frontend.h :generate-cross-refs: :toc: Demux =3D=3D=3D=3D=3D .. kernel-include:: include/uapi/linux/dvb/dmx.h :generate-cross-refs: :toc: ... So, don't add ..contents:: here. Signed-off-by: Mauro Carvalho Chehab --- tools/docs/lib/parse_data_structs.py | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/tools/docs/lib/parse_data_structs.py b/tools/docs/lib/parse_da= ta_structs.py index a5aa2e182052..6c868f84f029 100755 --- a/tools/docs/lib/parse_data_structs.py +++ b/tools/docs/lib/parse_data_structs.py @@ -397,16 +397,10 @@ class ParseDataStructs: =20 def gen_toc(self): """ - Create a TOC table pointing to each symbol from the header + Create a list of symbols to be part of a TOC contents table """ text =3D [] =20 - # Add header - text.append(".. contents:: Table of Contents") - text.append(" :depth: 2") - text.append(" :local:") - text.append("") - # Sort symbol types per description symbol_descriptions =3D [] for k, v in self.DEF_SYMBOL_TYPES.items(): --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 304A0275B03; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=kvu3p98+UCMt9r4T/XDG94BRgi7TVsyboAwPzaySuAu5yQULjFQcHr97A513KcBWe4Z7mLgwiIgNyUw0xoeecJwNi9FMl2bJbdNR6X+RjpiwwJkeBdXsdrF7unqInFba5+3Lw4U6ta9H1gt6jny9jlv8hl3fx4G2Isuuo81HPVA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=zUpIh7TsawGQocua17V5HvZQPsi7cqtACBD6mHMYWK8=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=PLPOTGdB89DxtES7ngZNIXaudtimy9ZmN2H4SIq/+JXgr5K6zdu7Ooy8uZR2pTXNEA1Jwka/NWFB3e+ZUgLLqAG8iuAbDyFZ7D1/rQtRrSYZcUiwrAxYTilcwpfuE/Zm0JyRzXeR5PGiia0j4Ej1R5fDwUDI1hwYCGYmrzzDIeY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=mpNusqsm; 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="mpNusqsm" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 02678C4AF0B; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=zUpIh7TsawGQocua17V5HvZQPsi7cqtACBD6mHMYWK8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=mpNusqsmJ3KrdxMODuXBevUmUUwGkKQlhSIG1+1ioeqewQzhH1a1LN2446DbVWUcl uFD2laD7v5yapugZcygArhpkHFMIMlWQdr8ca50HE1N7DBZF7H+rykeYF849KVeI5s eY2lM1DtRAju2hf6ycCLpCFNe0i+SGBzC9ElGp756XiuOrN+adRdyvnGavpEhSm8DN BPlINKgHmYk8IWe+RtbTrBnqhodufH3OHP4qW2MADWVPCiCB+7TwcOwyb3TAYgHkxK He+Q62wNoQJbij4bxoPcFRauytnwHXJZKBcphuuwGO+tQRR/3e52IVAyEVw7quomJw oMpOOt7yGjn+Q== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLI7-0i2n; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 02/23] tools: docs: parse_data_structs.py: output a line number Date: Wed, 1 Oct 2025 16:49:25 +0200 Message-ID: X-Mailer: git-send-email 2.51.0 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" Signed-off-by: Mauro Carvalho Chehab --- tools/docs/lib/parse_data_structs.py | 29 ++++++++++++++-------------- 1 file changed, 15 insertions(+), 14 deletions(-) diff --git a/tools/docs/lib/parse_data_structs.py b/tools/docs/lib/parse_da= ta_structs.py index 6c868f84f029..d28471a045f1 100755 --- a/tools/docs/lib/parse_data_structs.py +++ b/tools/docs/lib/parse_data_structs.py @@ -143,7 +143,7 @@ class ParseDataStructs: for symbol_type in self.DEF_SYMBOL_TYPES: self.symbols[symbol_type] =3D {} =20 - def store_type(self, symbol_type: str, symbol: str, + def store_type(self, ln, symbol_type: str, symbol: str, ref_name: str =3D None, replace_underscores: bool =3D T= rue): """ Stores a new symbol at self.symbols under symbol_type. @@ -172,7 +172,7 @@ class ParseDataStructs: else: ref_link =3D symbol =20 - self.symbols[symbol_type][symbol] =3D f"{prefix}{ref_link}{suffix}" + self.symbols[symbol_type][symbol] =3D (f"{prefix}{ref_link}{suffix= }", ln) =20 def store_line(self, line): """Stores a line at self.data, properly indented""" @@ -240,20 +240,20 @@ class ParseDataStructs: if is_enum: match =3D re.match(r"^\s*([_\w][\w\d_]+)\s*[\,=3D]?", = line) if match: - self.store_type("symbol", match.group(1)) + self.store_type(line_no, "symbol", match.group(1)) if "}" in line: is_enum =3D False continue =20 match =3D re.match(r"^\s*#\s*define\s+([\w_]+)\s+_IO", lin= e) if match: - self.store_type("ioctl", match.group(1), + self.store_type(line_no, "ioctl", match.group(1), replace_underscores=3DFalse) continue =20 match =3D re.match(r"^\s*#\s*define\s+([\w_]+)(\s+|$)", li= ne) if match: - self.store_type("define", match.group(1)) + self.store_type(line_no, "define", match.group(1)) continue =20 match =3D re.match(r"^\s*typedef\s+([_\w][\w\d_]+)\s+(.*)\= s+([_\w][\w\d_]+);", @@ -261,20 +261,20 @@ class ParseDataStructs: if match: name =3D match.group(2).strip() symbol =3D match.group(3) - self.store_type("typedef", symbol, ref_name=3Dname) + self.store_type(line_no, "typedef", symbol, ref_name= =3Dname) continue =20 for re_enum in self.RE_ENUMS: match =3D re_enum.match(line) if match: - self.store_type("enum", match.group(1)) + self.store_type(line_no, "enum", match.group(1)) is_enum =3D True break =20 for re_struct in self.RE_STRUCTS: match =3D re_struct.match(line) if match: - self.store_type("struct", match.group(1)) + self.store_type(line_no, "struct", match.group(1)) break =20 def process_exceptions(self, fname: str): @@ -342,7 +342,8 @@ class ParseDataStructs: =20 # Change self.symbols to use the replacement rule if old in self.symbols[c_type]: - self.symbols[c_type][old] =3D new_ref + (_, ln) =3D self.symbols[c_type][old] + self.symbols[c_type][old] =3D (new_ref, ln) else: print(f"{name}:{ln}: Warning: can't find {old} {c_type= }") =20 @@ -360,8 +361,8 @@ class ParseDataStructs: =20 print(f"{c_type}:") =20 - for symbol, ref in sorted(refs.items()): - print(f" {symbol} -> {ref}") + for symbol, (ref, ln) in sorted(refs.items()): + print(f" #{ln:<5d} {symbol} -> {ref}") =20 print() =20 @@ -384,7 +385,7 @@ class ParseDataStructs: =20 # Process all reference types for ref_dict in self.symbols.values(): - for symbol, replacement in ref_dict.items(): + for symbol, (replacement, _) in ref_dict.items(): symbol =3D re.escape(re.sub(r"([\_\`\*\<\>\&\\\\:\/])", r"= \\\1", symbol)) text =3D re.sub(fr'{start_delim}{symbol}{end_delim}', fr'\1{replacement}\2', text) @@ -420,8 +421,8 @@ class ParseDataStructs: text.append("") =20 # Sort symbols alphabetically - for symbol, ref in sorted(refs.items()): - text.append(f"* :{ref}:") + for symbol, (ref, ln) in sorted(refs.items()): + text.append(f"* {ref}: line #{ln}") =20 text.append("") # Add empty line between categories =20 --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 5A5F82DECDD; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=im3kxja3aBFwygxItvDMD2i5BcmqS0s2dNAnpZa+Ibr2+6wWDDyF0tdOhbJPM+YGjx0X5oKvsCpFosf4PjAyHUOLnIKNJcJvmsYs5yLzcaJwHNlNcsg8hBq7tEx2NeMuSM89trc83XLV9we2UN2MsU9DWcswWiIy26BhQVon89U= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=qB159IYUOz+MSNR6iulmqvylalzUczQT+mGqT4T/ngs=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=g6fkISdnrm9aaHUnfg9wLtk3IsjQiGm3Qufn8PjMlQhENFahjZW9MlQmlZvICFwcblUHu61QN1y77OPoqIMJuzYvBodETVjDos3qgdP5gZhqFu9s3hlIfngY3tFqEb4R7nhMt0C0COwtWNS5pBZVOKLXlO1XArPFSsFFz2JzEVE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=ppegjNb8; 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="ppegjNb8" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 022D0C4AF09; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=qB159IYUOz+MSNR6iulmqvylalzUczQT+mGqT4T/ngs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ppegjNb8B4VJfFLes6+pEWUlE3jpRc5heDj0Do6dQJrxxxJIMoGXbZHeXu/+LEat8 wmtZHYuntupy4g8K3gh/oa2MctkjfR310JQdPEtKAtPcvbgGUEg3XNf7X1+lVKLXeN KHqjCugHd3JOqENkjmlblzsJqsTPabEhb0CakKhBqe6uGh10tv6p6ogWmlpe+B/rxv DKc3744YL9kdOis+MN8/K0oV44uqawjKFhbBqveaXV1XYwSWzNSqc3/97e8eAnN4kN E/t4H5ISHWHeah/2FhhSDHPWZCzUUbzV8ylJatQen9Gf+p0prBeN59HhyVhTzQRw2M ANBLvK367FVYA== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLIB-0pcH; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 03/23] docs: kernel_include.py: fix line numbers for TOC Date: Wed, 1 Oct 2025 16:49:26 +0200 Message-ID: <74eed96e32f79eaaef7a99ffe7c3224fed369c27.1759329363.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.51.0 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" On TOC output, we need to embeed line numbers with ViewList. Change the parse class to produce a line-number parsed result, and adjust the output accordingly. Signed-off-by: Mauro Carvalho Chehab --- Documentation/sphinx/kernel_include.py | 36 ++++++++++++++++---------- tools/docs/lib/parse_data_structs.py | 2 +- 2 files changed, 24 insertions(+), 14 deletions(-) diff --git a/Documentation/sphinx/kernel_include.py b/Documentation/sphinx/= kernel_include.py index f94412cd17c9..ed819e9821c2 100755 --- a/Documentation/sphinx/kernel_include.py +++ b/Documentation/sphinx/kernel_include.py @@ -104,6 +104,7 @@ logger =3D logging.getLogger(__name__) =20 RE_DOMAIN_REF =3D re.compile(r'\\ :(ref|c:type|c:func):`([^<`]+)(?:<([^>]+= )>)?`\\') RE_SIMPLE_REF =3D re.compile(r'`([^`]+)`') +RE_LINENO_REF =3D re.compile(r'^\s*-\s+LINENO_(\d+):\s+(.*)') =20 def ErrorString(exc): # Shamelessly stolen from docutils return f'{exc.__class__.__name}: {exc}' @@ -242,23 +243,32 @@ class KernelInclude(Directive): # TOC output is a ReST file, not a literal. So, we can add line # numbers =20 - rawtext =3D parser.gen_toc() - - include_lines =3D statemachine.string2lines(rawtext, tab_width, - convert_whitespace=3DTru= e) - - # Append line numbers data - startline =3D self.options.get('start-line', None) + endline =3D self.options.get('end-line', None) + + relpath =3D os.path.relpath(path, srctree) =20 result =3D ViewList() - if startline and startline > 0: - offset =3D startline - 1 - else: - offset =3D 0 + for line in parser.gen_toc().split("\n"): + match =3D RE_LINENO_REF.match(line) + if not match: + result.append(line, path) + continue =20 - for ln, line in enumerate(include_lines, start=3Doffset): - result.append(line, path, ln) + ln, ref =3D match.groups() + ln =3D int(ln) + + # Filter line range if needed + if startline and (ln < startline): + continue + + if endline and (ln > endline): + continue + + # Sphinx numerates starting with zero, but text editors + # and other tools start from one + realln =3D ln + 1 + result.append(f"- {ref}: {relpath}#{realln}", path, ln) =20 self.state_machine.insert_input(result, path) =20 diff --git a/tools/docs/lib/parse_data_structs.py b/tools/docs/lib/parse_da= ta_structs.py index d28471a045f1..9ad621712103 100755 --- a/tools/docs/lib/parse_data_structs.py +++ b/tools/docs/lib/parse_data_structs.py @@ -422,7 +422,7 @@ class ParseDataStructs: =20 # Sort symbols alphabetically for symbol, (ref, ln) in sorted(refs.items()): - text.append(f"* {ref}: line #{ln}") + text.append(f"- LINENO_{ln}: {ref}") =20 text.append("") # Add empty line between categories =20 --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 A49602FDC37; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=iimyCvGeN6UYZczIrPrhmHSWpk1AnFuPhDx4oqwxkBsXTBhAimTPdfONbI46RrDQtQ87+mO3s9TKkfuyt65vK+BCywQl8IqxHG/xrGmwyn6Nx4SUMaTp1spe5tvf5mu7DvXQjWXQuqfOzdYGL2MlEQ42S2y+Ei/idKm/nDTOCe8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=7G19TBRqcSSvnXToM3u1Uoshyb2F1JhNkDvRwLoG1lg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=oJy//TvEwJKtlwtYH3c9BvAcm42TPuci/3SPWuMJVrhozaiioNq6/bP99MKxys5iq0Gs03/FWh4v/IYDtFe3aqXb2Cno/drh765ZtufB41B59nmsXxRbBhncZbikUbq/rzVauyqyJTEFlCHBDIXYfbIOKwTaPB3tgh8MvywMYmY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=h21DCwwn; 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="h21DCwwn" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 020F2C4CEFB; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=7G19TBRqcSSvnXToM3u1Uoshyb2F1JhNkDvRwLoG1lg=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=h21DCwwnNnwhWIgt4Nd/lj/Rg4FGlP3XWSWdLWAfdgLQf4PmN8DaAC3zSndlrfvfn CsqAf2f38Jcu2Bexz1Clg8HdEYscqSpXU+U9Y8z4D5DOs/CGWApyaxeVfmA+1Q1a+p 5jra5MRayKt7kU4RN4YsUzIuBiIGwZ1LiNDDDslPfAGznWaJrQJCAcgOe0qDXtiIoh JlK2a6BdpUPen0SMZwuOhdQ7Tan7v8iy3olTklAJWrOvr5VMEOBNa4usMMJlI6/IUl LR6yBikgOYGLIks7WLVpUhVsvSV0aaMLMX9pNIME134kKw5laL5AFHKoZJJTP6ItBW ON8UiGgOn65/g== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLIF-0xSI; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , Benjamin Gaignard , Hans Verkuil , Hans de Goede , Ricardo Ribalda , Yunke Cao , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 04/23] docs: kernel_include.py: propose alternatives Date: Wed, 1 Oct 2025 16:49:27 +0200 Message-ID: <4c75d277e950e619ea00ba2dea336853a4aac976.1759329363.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.51.0 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" Specially when using c::namespace, it is not hard to break a reference by forgetting to add a domain. Also, different cases and using "-"/"_" the wrong way are typical cases that people often gets wrong. We might use a more complex logic here to also check for typos, but let's keep it plain, simple. This is enough to get thos exeptions from media controller: .../include/uapi/linux/media.h:26: WARNING: Invalid xref: c:type:`media_d= evice_info`. Possible alternatives: c:type:`MC.media_device_info` (from mediactl/media-ioc-device-info) .../include/uapi/linux/media.h:149: WARNING: Invalid xref: c:type:`media_= entity_desc`. Possible alternatives: c:type:`MC.media_entity_desc` (from mediactl/media-ioc-enum-entities) .../include/uapi/linux/media.h:228: WARNING: Invalid xref: c:type:`media_= link_desc`. Possible alternatives: c:type:`MC.media_link_desc` (from mediactl/media-ioc-enum-links) .../include/uapi/linux/media.h:235: WARNING: Invalid xref: c:type:`media_= links_enum`. Possible alternatives: c:type:`MC.media_links_enum` (from mediactl/media-ioc-enum-links) .../include/uapi/linux/media.h:212: WARNING: Invalid xref: c:type:`media_= pad_desc`. Possible alternatives: c:type:`MC.media_pad_desc` (from mediactl/media-ioc-enum-links) .../include/uapi/linux/media.h:298: WARNING: Invalid xref: c:type:`media_= v2_entity`. Possible alternatives: c:type:`MC.media_v2_entity` (from mediactl/media-ioc-g-topology) .../include/uapi/linux/media.h:312: WARNING: Invalid xref: c:type:`media_= v2_interface`. Possible alternatives: c:type:`MC.media_v2_interface` (from mediactl/media-ioc-g-topology) .../include/uapi/linux/media.h:307: WARNING: Invalid xref: c:type:`media_= v2_intf_devnode`. Possible alternatives: c:type:`MC.media_v2_intf_devnode` (from mediactl/media-ioc-g-topology) .../include/uapi/linux/media.h:341: WARNING: Invalid xref: c:type:`media_= v2_link`. Possible alternatives: c:type:`MC.media_v2_link` (from mediactl/media-ioc-g-topology) .../include/uapi/linux/media.h:333: WARNING: Invalid xref: c:type:`media_= v2_pad`. Possible alternatives: c:type:`MC.media_v2_pad` (from mediactl/media-ioc-g-topology) .../include/uapi/linux/media.h:349: WARNING: Invalid xref: c:type:`media_= v2_topology`. Possible alternatives: c:type:`MC.media_v2_topology` (from mediactl/media-ioc-g-topology) Signed-off-by: Mauro Carvalho Chehab --- Documentation/sphinx/kernel_include.py | 70 ++++++++++++++++++- .../userspace-api/media/v4l/videodev.rst | 8 ++- .../media/v4l/videodev2.h.rst.exceptions | 3 + 3 files changed, 77 insertions(+), 4 deletions(-) diff --git a/Documentation/sphinx/kernel_include.py b/Documentation/sphinx/= kernel_include.py index ed819e9821c2..e8f7e7a49758 100755 --- a/Documentation/sphinx/kernel_include.py +++ b/Documentation/sphinx/kernel_include.py @@ -105,6 +105,7 @@ logger =3D logging.getLogger(__name__) RE_DOMAIN_REF =3D re.compile(r'\\ :(ref|c:type|c:func):`([^<`]+)(?:<([^>]+= )>)?`\\') RE_SIMPLE_REF =3D re.compile(r'`([^`]+)`') RE_LINENO_REF =3D re.compile(r'^\s*-\s+LINENO_(\d+):\s+(.*)') +RE_SPLIT_DOMAIN =3D re.compile(r"(.*)\.(.*)") =20 def ErrorString(exc): # Shamelessly stolen from docutils return f'{exc.__class__.__name}: {exc}' @@ -399,6 +400,67 @@ class KernelInclude(Directive): =20 reported =3D set() =20 +DOMAIN_INFO =3D {} + +def fill_domain_info(env): + """ + Get supported reference types for each Sphinx domain and C namespaces + """ + if DOMAIN_INFO: + return + + for domain_name, domain_instance in env.domains.items(): + try: + object_types =3D list(domain_instance.object_types.keys()) + DOMAIN_INFO[domain_name] =3D object_types + except AttributeError: + # Ignore domains that we can't retrieve object types, if any + pass + +def get_suggestions(app, env, node, + original_target, original_domain, original_reftype): + """Check if target exists in the other domain or with different reftyp= es.""" + original_target =3D original_target.lower() + + # Remove namespace if present + if '.' in original_target: + original_target =3D original_target.split(".")[-1] + + targets =3D set([ + original_target, + original_target.replace("-", "_"), + original_target.replace("_", "-"), + ]) + + # Propose some suggestions, if possible + # The code below checks not only variants of the target, but also it + # works when .. c:namespace:: targets setting a different C namespace + # is in place + + suggestions =3D [] + for target in sorted(targets): + for domain in DOMAIN_INFO.keys(): + domain_obj =3D env.get_domain(domain) + for name, dispname, objtype, docname, anchor, priority in doma= in_obj.get_objects(): + lower_name =3D name.lower() + + if domain =3D=3D "c": + # Check if name belongs to a different C namespace + match =3D RE_SPLIT_DOMAIN.match(name) + if match: + if target !=3D match.group(2).lower(): + continue + else: + if target !=3D lower_name: + continue + else: + if target !=3D lower_name: + continue + + suggestions.append(f"\t{domain}:{objtype}:`{name}` (from {= docname})") + + return suggestions + def check_missing_refs(app, env, node, contnode): """Check broken refs for the files it creates xrefs""" if not node.source: @@ -414,11 +476,13 @@ def check_missing_refs(app, env, node, contnode): if node.source not in xref_files: return None =20 + fill_domain_info(env) + target =3D node.get('reftarget', '') domain =3D node.get('refdomain', 'std') reftype =3D node.get('reftype', '') =20 - msg =3D f"can't link to: {domain}:{reftype}:: {target}" + msg =3D f"Invalid xref: {domain}:{reftype}:`{target}`" =20 # Don't duplicate warnings data =3D (node.source, msg) @@ -426,6 +490,10 @@ def check_missing_refs(app, env, node, contnode): return None reported.add(data) =20 + suggestions =3D get_suggestions(app, env, node, target, domain, reftyp= e) + if suggestions: + msg +=3D ". Possible alternatives:\n" + '\n'.join(suggestions) + logger.warning(msg, location=3Dnode, type=3D'ref', subtype=3D'missing') =20 return None diff --git a/Documentation/userspace-api/media/v4l/videodev.rst b/Documenta= tion/userspace-api/media/v4l/videodev.rst index cde485bc9a5f..64be44716494 100644 --- a/Documentation/userspace-api/media/v4l/videodev.rst +++ b/Documentation/userspace-api/media/v4l/videodev.rst @@ -2,10 +2,12 @@ =20 .. _videodev: =20 -******************************* -Video For Linux Two Header File -******************************* +*************************************** +Video For Linux Two Header uAPI Symbols +*************************************** =20 .. kernel-include:: include/uapi/linux/videodev2.h :generate-cross-refs: :exception-file: videodev2.h.rst.exceptions + :toc: + :warn-broken: diff --git a/Documentation/userspace-api/media/v4l/videodev2.h.rst.exceptio= ns b/Documentation/userspace-api/media/v4l/videodev2.h.rst.exceptions index 35d3456cc812..951d01bf7579 100644 --- a/Documentation/userspace-api/media/v4l/videodev2.h.rst.exceptions +++ b/Documentation/userspace-api/media/v4l/videodev2.h.rst.exceptions @@ -1,5 +1,8 @@ # SPDX-License-Identifier: GPL-2.0 =20 +# All symbols are mapped inside V4L C domain namespace +namespace V4L + # Ignore header name ignore define _UAPI__LINUX_VIDEODEV2_H =20 --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 5A6AC2E54DE; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=u3lbz6Ke6k9S6CPNz5lmZjB5izDqfi++fltYbJvjPQS/2enzbn6Q7FykefcvMmqgJu55qNvUWcv1OC4t5jScjGfuUY/fgDQa38uESiKc0wwDIpQbyVXNCbiaBSALr3Gn8CEqzigp1U1sIe4zhRhK4xUfUgrSokWhJRNR9RRlp1Y= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=3CTScuwxC9ZYFhvKDygUTwinDqi3MU7C1ktyjxp78ZU=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=g0H3kbiGArCxvL6gqGXrto52KV6RsbkucwGvKMlDvkYDrXUxzLpr9DUup2MCe/wFkOoyJOfelXI81Ef712VeHohJMeGaIg2Ku/hrRfzvp/hEIn9yR4P5KxlM1OzWpEbTKG8tVfMANp/SffyAfQKXsx17/nTenJlX5/LbnMLnTgo= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=cGx6QR84; 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="cGx6QR84" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 01FABC4CEFA; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=3CTScuwxC9ZYFhvKDygUTwinDqi3MU7C1ktyjxp78ZU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=cGx6QR846NsCLlOPyb53nZiJLHRWcoYy+OtbF50kSnwmLr+Q1R4gmKtqhqVkXRl2F kcljejHtbGFUjAmSLE9o/FaKuXl5YlzDpOmNOypCktZCtOrCy7zs4B0QUbUC6lnSCm G1yC3hLO8G4SyJ4d4TIee0yjoNQNolhUcHjXMYVqLdtKSD/TUYUgXBb+29NzhzlY/a pWH/nr/OKcyRhM4EZ9ylewbmEmJ11wca6z3Kj82slzz5m8IbfTfDypwvhz6L5u2TZP v9mfZQk3FyCJSf7OGknzMS55DOMr237gMTZHb4vzxDWHcuwJT54wygDDXrCbCmtvHc H4pq0bWitWY+Q== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLIJ-14t7; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 05/23] tools: docs: parse_data_structs: make process_exceptions two stages Date: Wed, 1 Oct 2025 16:49:28 +0200 Message-ID: X-Mailer: git-send-email 2.51.0 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" Split the logic which parses exceptions on two stages, preparing the exceptions file to have rules that will affect xref generation. For now, preserve the original API. Signed-off-by: Mauro Carvalho Chehab --- tools/docs/lib/parse_data_structs.py | 125 +++++++++++++++------------ 1 file changed, 71 insertions(+), 54 deletions(-) diff --git a/tools/docs/lib/parse_data_structs.py b/tools/docs/lib/parse_da= ta_structs.py index 9ad621712103..46535a05ea4a 100755 --- a/tools/docs/lib/parse_data_structs.py +++ b/tools/docs/lib/parse_data_structs.py @@ -140,9 +140,41 @@ class ParseDataStructs: =20 self.symbols =3D {} =20 + self.ignore =3D [] + self.replace =3D [] + for symbol_type in self.DEF_SYMBOL_TYPES: self.symbols[symbol_type] =3D {} =20 + def read_exceptions(self, fname: str): + if not fname: + return + + name =3D os.path.basename(fname) + + with open(fname, "r", encoding=3D"utf-8", errors=3D"backslashrepla= ce") as f: + for ln, line in enumerate(f): + ln +=3D 1 + line =3D line.strip() + if not line or line.startswith("#"): + continue + + # ignore rules + match =3D re.match(r"^ignore\s+(\w+)\s+(\S+)", line) + + if match: + self.ignore.append((ln, match.group(1), match.group(2)= )) + continue + + # replace rules + match =3D re.match(r"^replace\s+(\S+)\s+(\S+)\s+(\S+)", li= ne) + if match: + self.replace.append((ln, match.group(1), match.group(2= ), + match.group(3))) + continue + + sys.exit(f"{name}:{ln}: invalid line: {line}") + def store_type(self, ln, symbol_type: str, symbol: str, ref_name: str =3D None, replace_underscores: bool =3D T= rue): """ @@ -277,75 +309,60 @@ class ParseDataStructs: self.store_type(line_no, "struct", match.group(1)) break =20 - def process_exceptions(self, fname: str): + def apply_exceptions(self): """ Process exceptions file with rules to ignore or replace references. """ - if not fname: - return =20 - name =3D os.path.basename(fname) + # Handle ignore rules + for ln, c_type, symbol in self.ignore: + if c_type not in self.DEF_SYMBOL_TYPES: + sys.exit(f"{name}:{ln}: {c_type} is invalid") =20 - with open(fname, "r", encoding=3D"utf-8", errors=3D"backslashrepla= ce") as f: - for ln, line in enumerate(f): - ln +=3D 1 - line =3D line.strip() - if not line or line.startswith("#"): - continue + d =3D self.symbols[c_type] + if symbol in d: + del d[symbol] =20 - # Handle ignore rules - match =3D re.match(r"^ignore\s+(\w+)\s+(\S+)", line) - if match: - c_type =3D match.group(1) - symbol =3D match.group(2) - - if c_type not in self.DEF_SYMBOL_TYPES: - sys.exit(f"{name}:{ln}: {c_type} is invalid") - - d =3D self.symbols[c_type] - if symbol in d: - del d[symbol] - - continue - - # Handle replace rules - match =3D re.match(r"^replace\s+(\S+)\s+(\S+)\s+(\S+)", li= ne) - if not match: - sys.exit(f"{name}:{ln}: invalid line: {line}") - - c_type, old, new =3D match.groups() - - if c_type not in self.DEF_SYMBOL_TYPES: - sys.exit(f"{name}:{ln}: {c_type} is invalid") + # Handle replace rules + for ln, c_type, old, new in self.replace: + if c_type not in self.DEF_SYMBOL_TYPES: + sys.exit(f"{name}:{ln}: {c_type} is invalid") =20 - reftype =3D None + reftype =3D None =20 - # Parse reference type when the type is specified + # Parse reference type when the type is specified =20 - match =3D re.match(r"^\:c\:(data|func|macro|type)\:\`(.+)\= `", new) + match =3D re.match(r"^\:c\:(data|func|macro|type)\:\`(.+)\`", = new) + if match: + reftype =3D f":c:{match.group(1)}" + new =3D match.group(2) + else: + match =3D re.search(r"(\:ref)\:\`(.+)\`", new) if match: - reftype =3D f":c:{match.group(1)}" + reftype =3D match.group(1) new =3D match.group(2) - else: - match =3D re.search(r"(\:ref)\:\`(.+)\`", new) - if match: - reftype =3D match.group(1) - new =3D match.group(2) =20 - # If the replacement rule doesn't have a type, get default + # If the replacement rule doesn't have a type, get default + if not reftype: + reftype =3D self.DEF_SYMBOL_TYPES[c_type].get("ref_type") if not reftype: - reftype =3D self.DEF_SYMBOL_TYPES[c_type].get("ref_typ= e") - if not reftype: - reftype =3D self.DEF_SYMBOL_TYPES[c_type].get("rea= l_type") + reftype =3D self.DEF_SYMBOL_TYPES[c_type].get("real_ty= pe") =20 - new_ref =3D f"{reftype}:`{old} <{new}>`" + new_ref =3D f"{reftype}:`{old} <{new}>`" =20 - # Change self.symbols to use the replacement rule - if old in self.symbols[c_type]: - (_, ln) =3D self.symbols[c_type][old] - self.symbols[c_type][old] =3D (new_ref, ln) - else: - print(f"{name}:{ln}: Warning: can't find {old} {c_type= }") + # Change self.symbols to use the replacement rule + if old in self.symbols[c_type]: + (_, ln) =3D self.symbols[c_type][old] + self.symbols[c_type][old] =3D (new_ref, ln) + else: + print(f"{name}:{ln}: Warning: can't find {old} {c_type}") + + def process_exceptions(self, fname: str): + """ + Process exceptions file with rules to ignore or replace references. + """ + self.read_exceptions(fname) + self.apply_exceptions() =20 def debug_print(self): """ --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 5A5352773F3; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=RzND6hli3JHnP4JKAVo9yVnj/KoOsBRwe6IOqqZrHEj++3CXJ6rBjj6wDiQViAnsHwt2cN2+e/5rAHWxsnlWOlOsNWYfvvg8K+qbDqEOhyqDQYOEYWjF4CBem89BVhk5XUOfzarizAZHNgGTMG1ZX11cNfWKuGl4urrmi7tVbPc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=zSEgAo72B96PVvkyzVvVvzPA6asz0cr2DairSiNfMhM=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=GzUiVUf0CY6r/iZ1TsnbfHkCuOpFYf+FS1R7dvL65xR4hxwKx7hUUaOYUq8IOkNhPhxWkpwS6o32nTYqhNg15jeT3Sjr7E4LaTvASf8j2/OHBT1DuMbJdIRcV9l4Ax/RhsMrLbe+SWz1xVugqFnP/nIpUAmwdXHDITDTM7uQvv4= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=UBg0h8Rt; 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="UBg0h8Rt" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 01A3AC4CEF5; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=zSEgAo72B96PVvkyzVvVvzPA6asz0cr2DairSiNfMhM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=UBg0h8Rt7Yclm3TFlJ9JQ2RK5h5GTA8U4a4pB6ZrcuECEqjTOV9h4Ze+LDMlDH/Hs 0JY9d7a3B7AEXUvw3MEG01hDcC19xViNeusALoWlyI7ZQz9NEvcsMUMPicRlWj/N08 y/CxhwN5/LacDrzhbo9McqPY3OsuS2doq59/TgRaLaE1c9AA83QU0XWJPoohJp/8aO 1P7OS6thz+gA+qYtYS6YkG+1lDfbibSqeCC4qHTA7KqYJlzZ/Mg5AJwj6HCfk5/IxO r9PjaU5VLVZ/ungdJQ63Uqvex6jaUn0QV88EXPiu2ptYsXjh/Tfvk488O+99nPFeHo EyGzGOki8HrKQ== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLIN-1CHp; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 06/23] tools: docs: parse_data_structs.py: get rid of process_exceptions() Date: Wed, 1 Oct 2025 16:49:29 +0200 Message-ID: <8575bbc94ff706aa7e7cc3a188399ca17a3169e6.1759329363.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.51.0 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" Add an extra parameter to parse_file to make it handle exceptions internally, cleaning up the API. Signed-off-by: Mauro Carvalho Chehab --- Documentation/sphinx/kernel_include.py | 6 +- tools/docs/lib/parse_data_structs.py | 105 ++++++++++++------------- tools/docs/parse-headers.py | 5 +- 3 files changed, 56 insertions(+), 60 deletions(-) diff --git a/Documentation/sphinx/kernel_include.py b/Documentation/sphinx/= kernel_include.py index e8f7e7a49758..895646da7495 100755 --- a/Documentation/sphinx/kernel_include.py +++ b/Documentation/sphinx/kernel_include.py @@ -214,14 +214,16 @@ class KernelInclude(Directive): - a TOC table containing cross references. """ parser =3D ParseDataStructs() - parser.parse_file(path) =20 if 'exception-file' in self.options: source_dir =3D os.path.dirname(os.path.abspath( self.state_machine.input_lines.source( self.lineno - self.state_machine.input_offset - 1))) exceptions_file =3D os.path.join(source_dir, self.options['exc= eption-file']) - parser.process_exceptions(exceptions_file) + else: + exceptions_file =3D None + + parser.parse_file(path, exceptions_file) =20 # Store references on a symbol dict to be used at check time if 'warn-broken' in self.options: diff --git a/tools/docs/lib/parse_data_structs.py b/tools/docs/lib/parse_da= ta_structs.py index 46535a05ea4a..cbdbf7dfe785 100755 --- a/tools/docs/lib/parse_data_structs.py +++ b/tools/docs/lib/parse_data_structs.py @@ -175,6 +175,54 @@ class ParseDataStructs: =20 sys.exit(f"{name}:{ln}: invalid line: {line}") =20 + def apply_exceptions(self): + """ + Process exceptions file with rules to ignore or replace references. + """ + + # Handle ignore rules + for ln, c_type, symbol in self.ignore: + if c_type not in self.DEF_SYMBOL_TYPES: + sys.exit(f"{name}:{ln}: {c_type} is invalid") + + d =3D self.symbols[c_type] + if symbol in d: + del d[symbol] + + # Handle replace rules + for ln, c_type, old, new in self.replace: + if c_type not in self.DEF_SYMBOL_TYPES: + sys.exit(f"{name}:{ln}: {c_type} is invalid") + + reftype =3D None + + # Parse reference type when the type is specified + + match =3D re.match(r"^\:c\:(data|func|macro|type)\:\`(.+)\`", = new) + if match: + reftype =3D f":c:{match.group(1)}" + new =3D match.group(2) + else: + match =3D re.search(r"(\:ref)\:\`(.+)\`", new) + if match: + reftype =3D match.group(1) + new =3D match.group(2) + + # If the replacement rule doesn't have a type, get default + if not reftype: + reftype =3D self.DEF_SYMBOL_TYPES[c_type].get("ref_type") + if not reftype: + reftype =3D self.DEF_SYMBOL_TYPES[c_type].get("real_ty= pe") + + new_ref =3D f"{reftype}:`{old} <{new}>`" + + # Change self.symbols to use the replacement rule + if old in self.symbols[c_type]: + (_, ln) =3D self.symbols[c_type][old] + self.symbols[c_type][old] =3D (new_ref, ln) + else: + print(f"{name}:{ln}: Warning: can't find {old} {c_type}") + def store_type(self, ln, symbol_type: str, symbol: str, ref_name: str =3D None, replace_underscores: bool =3D T= rue): """ @@ -211,13 +259,15 @@ class ParseDataStructs: line =3D " " + line.expandtabs() self.data +=3D line.rstrip(" ") =20 - def parse_file(self, file_in: str): + def parse_file(self, file_in: str, exceptions: str =3D None): """Reads a C source file and get identifiers""" self.data =3D "" is_enum =3D False is_comment =3D False multiline =3D "" =20 + self.read_exceptions(exceptions) + with open(file_in, "r", encoding=3D"utf-8", errors=3D"backslashreplace") as f: for line_no, line in enumerate(f): @@ -309,59 +359,6 @@ class ParseDataStructs: self.store_type(line_no, "struct", match.group(1)) break =20 - def apply_exceptions(self): - """ - Process exceptions file with rules to ignore or replace references. - """ - - # Handle ignore rules - for ln, c_type, symbol in self.ignore: - if c_type not in self.DEF_SYMBOL_TYPES: - sys.exit(f"{name}:{ln}: {c_type} is invalid") - - d =3D self.symbols[c_type] - if symbol in d: - del d[symbol] - - # Handle replace rules - for ln, c_type, old, new in self.replace: - if c_type not in self.DEF_SYMBOL_TYPES: - sys.exit(f"{name}:{ln}: {c_type} is invalid") - - reftype =3D None - - # Parse reference type when the type is specified - - match =3D re.match(r"^\:c\:(data|func|macro|type)\:\`(.+)\`", = new) - if match: - reftype =3D f":c:{match.group(1)}" - new =3D match.group(2) - else: - match =3D re.search(r"(\:ref)\:\`(.+)\`", new) - if match: - reftype =3D match.group(1) - new =3D match.group(2) - - # If the replacement rule doesn't have a type, get default - if not reftype: - reftype =3D self.DEF_SYMBOL_TYPES[c_type].get("ref_type") - if not reftype: - reftype =3D self.DEF_SYMBOL_TYPES[c_type].get("real_ty= pe") - - new_ref =3D f"{reftype}:`{old} <{new}>`" - - # Change self.symbols to use the replacement rule - if old in self.symbols[c_type]: - (_, ln) =3D self.symbols[c_type][old] - self.symbols[c_type][old] =3D (new_ref, ln) - else: - print(f"{name}:{ln}: Warning: can't find {old} {c_type}") - - def process_exceptions(self, fname: str): - """ - Process exceptions file with rules to ignore or replace references. - """ - self.read_exceptions(fname) self.apply_exceptions() =20 def debug_print(self): diff --git a/tools/docs/parse-headers.py b/tools/docs/parse-headers.py index bfa4e46a53e3..6716c7300258 100755 --- a/tools/docs/parse-headers.py +++ b/tools/docs/parse-headers.py @@ -47,10 +47,7 @@ def main(): args =3D parser.parse_args() =20 parser =3D ParseDataStructs(debug=3Dargs.debug) - parser.parse_file(args.file_in) - - if args.file_rules: - parser.process_exceptions(args.file_rules) + parser.parse_file(args.file_in, args.file_rules) =20 parser.debug_print() parser.write_output(args.file_in, args.file_out, args.toc) --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 5C7472EA74D; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=WUkdiaplFiyFYtXajxXxAho1SUPPaJUZuwhogqDOZjMqe1La+P7hg8uEPs/5ocWx16jztzjcbjE9PYJ0QZY3H/I+fbll6d8DVEA3TrFD+n/gDd4EQqZj7c1HwZALhojEJBkwyPwlo7n1GBdywIyBMaw455qBc78z0gpgfuTVhKM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=cpudc7RxxWHkEhpC0NFFpbwb/vOwgTPsZ8i0Bb1r0y4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=foAIvAzyj0rcD3CgBHeU/Z2g1Mh7g5HS5TFpwJGl26tSd1w85V4F88uGHCJeNJl1gBOXQYBrvNVOIpZbruxoTTKF16M/AZB9nfTLqShWsRrOVa6rHP8PPwhvjzsXm466jy817sfiCZKb4bRLApK4bF4kMW8PZvcOflD4gbxzxGI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=LNTLK0bd; 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="LNTLK0bd" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 171EFC4CEFC; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=cpudc7RxxWHkEhpC0NFFpbwb/vOwgTPsZ8i0Bb1r0y4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=LNTLK0bdEFGF1PCtKmj9vCgGEdMBQprPG8h3wkc9bzMAMcFUlie4WywkPrWbm1RDX 9qXIvxVQg5LbqTGbS3/BWvcPWO1NiKXSsJmYFRzHAHZUS1Xh53BmNUou8oP4z4rAIo 7pcKOziYZHwHQPN7hLaHFxCyI3YdX2WzCdFQJJjZWZJ4GKur7EqplW8OJ4wFj7F7S8 ljwMIgWaFSZfPMW4X9XL2rKlJJ0EB/Uxd9LZtlxqiQk0WZnjDhd7nk9AhZotjUAFfr yAInPl7iu3s5Vx+R3GWhs6/YIM/v/+nUoeajugEvuQ1ZiGR+ugoJSFBxu4MFohxa+V 2ZDqaWS0YkWqw== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLIR-1JUm; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 07/23] tools: docs: parse_data_structs.py: add namespace support Date: Wed, 1 Oct 2025 16:49:30 +0200 Message-ID: X-Mailer: git-send-email 2.51.0 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" C domain supports a ".. c:namespace::" tag that allows setting a symbol namespace. This is used within the kernel to avoid warnings about duplicated symbols. This is specially important for syscalls, as each subsystem may have their own documentation for them. This is specially true for ioctl. When such tag is used, all C domain symbols have c++ style, e.g. they'll become "{namespace}.{reference}". Allow specifying C namespace at the exception files, avoiding the need of override rules for every symbol. Signed-off-by: Mauro Carvalho Chehab --- tools/docs/lib/parse_data_structs.py | 43 +++++++++++++++++++++------- 1 file changed, 32 insertions(+), 11 deletions(-) diff --git a/tools/docs/lib/parse_data_structs.py b/tools/docs/lib/parse_da= ta_structs.py index cbdbf7dfe785..0d537e989ea7 100755 --- a/tools/docs/lib/parse_data_structs.py +++ b/tools/docs/lib/parse_data_structs.py @@ -53,11 +53,19 @@ class ParseDataStructs: =20 replace =20 - Replaces how old_symbol with a new reference. The new_reference can be: + Replaces how old_symbol with a new reference. The new_reference can= be: + - A simple symbol name; - A full Sphinx reference. =20 - On both cases, can be: + 3. Namespace rules + + namespace + + Sets C namespace to be used during cross-reference generation. Can + be overridden by replace rules. + + On ignore and replace rules, can be: - ioctl: for defines that end with _IO*, e.g. ioctl definitions - define: for other defines - symbol: for symbols defined within enums; @@ -71,6 +79,8 @@ class ParseDataStructs: ignore ioctl VIDIOC_ENUM_FMT replace ioctl VIDIOC_DQBUF vidioc_qbuf replace define V4L2_EVENT_MD_FL_HAVE_FRAME_SEQ :c:type:`v4l2_event= _motion_det` + + namespace MC """ =20 # Parser regexes with multiple ways to capture enums and structs @@ -140,6 +150,7 @@ class ParseDataStructs: =20 self.symbols =3D {} =20 + self.namespace =3D None self.ignore =3D [] self.replace =3D [] =20 @@ -173,6 +184,11 @@ class ParseDataStructs: match.group(3))) continue =20 + match =3D re.match(r"^namespace\s+(\S+)", line) + if match: + self.namespace =3D match.group(1) + continue + sys.exit(f"{name}:{ln}: invalid line: {line}") =20 def apply_exceptions(self): @@ -237,18 +253,23 @@ class ParseDataStructs: ref_type =3D defs.get("ref_type") =20 # Determine ref_link based on symbol type - if ref_type: - if symbol_type =3D=3D "enum": - ref_link =3D f"{ref_type}:`{symbol}`" - else: - if not ref_name: - ref_name =3D symbol.lower() + if ref_type or self.namespace: + if not ref_name: + ref_name =3D symbol.lower() =20 - # c-type references don't support hash - if ref_type =3D=3D ":ref" and replace_underscores: - ref_name =3D ref_name.replace("_", "-") + # c-type references don't support hash + if ref_type =3D=3D ":ref" and replace_underscores: + ref_name =3D ref_name.replace("_", "-") =20 + # C domain references may have namespaces + if ref_type.startswith(":c:"): + if self.namespace: + ref_name =3D f"{self.namespace}.{ref_name}" + + if ref_type: ref_link =3D f"{ref_type}:`{symbol} <{ref_name}>`" + else: + ref_link =3D f"`{symbol} <{ref_name}>`" else: ref_link =3D symbol =20 --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 5C7FE2EAB8E; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=YaP9xUYUdLSMTYT6LiG3ar/rIP6U6Z5gIeBCJU1Dq1RY2OvfoYIIljrQHDoCsfjVxd7rZofqbNUYPmYOHY+QskXJ2igOef6ClBqJE+BHVAULXLh85IHQ+8ZeeBAep0MaWeq6D2mPEniMsaQPaM6IRC5otWTFvI3NX+KkxNXbuzc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=quJA1Nh80cs+Ipf6Dqjr1VgadIpCqZGsThtJSHhZD4c=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=BJubgdxEhuhxGEEQdw3HkobWUwgvm0uaWM2V1WZ9zfxhtQ51orL77Co7KmMBvClvvVJFqck38gNSjqLw8yB4edM930md3dMg1v1umwsCHEYjamIn8ZShAATEhCqLeA79Y7XEpNPTJ+mQPpqBSrgH68ZIehsm3HTpLKLtt6S1vs0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=rb2bdfB+; 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="rb2bdfB+" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 1A078C4CEFD; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=quJA1Nh80cs+Ipf6Dqjr1VgadIpCqZGsThtJSHhZD4c=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=rb2bdfB++M0syD5ni5OlXot3bBvsomdW944ZufewB19feYrktlCHh+aDH01Frp9iH 4SoeB63am/xxncPSCzVTUFBpKDJqr96sC+qYzO12A18I0GxtVBmRGN/eYOEiKBF7ch YhKgZ5llJ8UAUHisvpMSgZ2Dj5c6aAeZTrV3m9Py3AVklXYOrIrQQ+/8rYOLJkmjah PmUcFsvM+x9Xj4hOhymjaYBDL1Pv+jPIiiaeSHWA4S/1NrHeHV3M12Qox/hyQGBQa3 WsqKmxyMn6WJQBmQM4VB+ekUomJ/M/6QY3kBg9Fu2/oocaOgfrbw0Peh62UnKsprIC PKcQs+3c+kuXQ== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLIV-1Q66; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 08/23] tools: docs: parse_data_structs.py: accept more reftypes Date: Wed, 1 Oct 2025 16:49:31 +0200 Message-ID: <5c146923d1e3183893f290216fb1378954e2e540.1759329363.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.51.0 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" Current regex is limited to only some c-domain reftypes. There are several others. Change the code to pick the name specified there. Signed-off-by: Mauro Carvalho Chehab --- tools/docs/lib/parse_data_structs.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/docs/lib/parse_data_structs.py b/tools/docs/lib/parse_da= ta_structs.py index 0d537e989ea7..25361996cd20 100755 --- a/tools/docs/lib/parse_data_structs.py +++ b/tools/docs/lib/parse_data_structs.py @@ -214,7 +214,7 @@ class ParseDataStructs: =20 # Parse reference type when the type is specified =20 - match =3D re.match(r"^\:c\:(data|func|macro|type)\:\`(.+)\`", = new) + match =3D re.match(r"^\:c\:(\w+)\:\`(.+)\`", new) if match: reftype =3D f":c:{match.group(1)}" new =3D match.group(2) --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 86A4B2FBE13; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=hZpzKgDAZ4GyQzUUIjOhctJgQdkB7jrXnFoSgTef/vN99pGqxH+L2yS3TAEGRyO5jsOj0hJWNpkUhBoG8a1KmVGhXZQjpgacX+dInZXOPRNCxkmV/V3+JFKklMoubj2FTF1L1PB3N9BCYkAbsUhIw9v8Db56jyXiiG7qI/XjlW4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=BpmyC/Co0NOcMnA6DqxMPq8qTUiM3ZaK0OlRbzpqf08=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=lLkW/ubqxvsXQTTcxZYM4tV3YDKOt/z2sOpCHnBscCmeYXcDuV8iCpuWW4SlxAlUR7MuTGG5yg1F2ZsOcxGhKHOXW6lu7ZEybg43UyyQ5Thzg5UElzR/aSri5FYnfYGfd1CCJTfjlnHeZzf8XS21QwSjgw+FTLOEdU778zRxdtk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=G/YtICIZ; 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="G/YtICIZ" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 21B64C116D0; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=BpmyC/Co0NOcMnA6DqxMPq8qTUiM3ZaK0OlRbzpqf08=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=G/YtICIZ3cWYb8GuvlOhv4yYvwpKXuGFMAjzzaq2lyZl1ekvmv4frjMa5FuHXAzrc kc4kwA13PDK0GtzNkce3454+PtNT+E0wEcnRFGyn0Hoy4EnbYrlyTbAvkj5oazg+rU ID/BMikyxLYHCEce8UWKEbfPbXmAH8RdOwF+jVwKlyakIh/KUkaq3DzX3iO7t1V75O NSUl9tNAeUxNFAXIMejGGR9zrqwcgdKpxI93Qdb+r9dNHq5eqVm8qcJyvztOSPG9E8 vJbrZyGR2we6bMhr/P7yKS8V3piNWr/nLSCdX7u/1ZbSP/T/OtAxo1Jgk3LD/QxwUB 3PR+g6hD1WGtg== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLIZ-1Wkp; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 09/23] docs: media: dvb: use TOC instead of file contents at headers Date: Wed, 1 Oct 2025 16:49:32 +0200 Message-ID: X-Mailer: git-send-email 2.51.0 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" All we wanted were to have a way to link the comprehensive documentation with the actual symbols parsed from the header file, as this helps to identify any broken references. Use the new :toc: flag for DVB. Signed-off-by: Mauro Carvalho Chehab --- .../userspace-api/media/dvb/headers.rst | 27 +++++++++++++++---- 1 file changed, 22 insertions(+), 5 deletions(-) diff --git a/Documentation/userspace-api/media/dvb/headers.rst b/Documentat= ion/userspace-api/media/dvb/headers.rst index c75f64cf21d5..e78122944a69 100644 --- a/Documentation/userspace-api/media/dvb/headers.rst +++ b/Documentation/userspace-api/media/dvb/headers.rst @@ -1,25 +1,42 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later =20 -**************************** -Digital TV uAPI header files -**************************** - -Digital TV uAPI headers *********************** +Digital TV uAPI symbols +*********************** + +.. contents:: Table of Contents + :depth: 2 + :local: + +Frontend +=3D=3D=3D=3D=3D=3D=3D=3D =20 .. kernel-include:: include/uapi/linux/dvb/frontend.h :generate-cross-refs: :exception-file: frontend.h.rst.exceptions + :toc: + +Demux +=3D=3D=3D=3D=3D =20 .. kernel-include:: include/uapi/linux/dvb/dmx.h :generate-cross-refs: :exception-file: dmx.h.rst.exceptions + :toc: + +Conditional Access +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 .. kernel-include:: include/uapi/linux/dvb/ca.h :generate-cross-refs: :exception-file: ca.h.rst.exceptions + :toc: + +Network +=3D=3D=3D=3D=3D=3D=3D =20 .. kernel-include:: include/uapi/linux/dvb/net.h :generate-cross-refs: :exception-file: net.h.rst.exceptions + :toc: =20 --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 A33D42FDC30; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=ITOfXabg30WqIczHZs+U+zqZMdzs84TAQuRt5a+VtNExcuQXV40V0AWRUUAzozVrNnIyNMgHWuFg5f1LhQuBP5SmVjKudG0FcAYYETT/zN1g+fLJSODo/mkKHmKEl2Xa3XSzU6T9eYtlQUZCRS1yMCEDpkjms9AzlaL71CRhMSE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=U4RiYJ5NN8XuOT+nl3nJo1abaKdDCjeKGV3AxWy6uzU=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=SA7ZkJ6pxCk5yo4RXkvmKRFyc0b0qxIU+krgRdexUH0G4LWRKNt+P+E5Uuh8qx3qpXVDPKEuKacnzcMfsjiYsq0Kf4XI+xWjX+5V9yrQF6cayM5QvE9PAWIN9+/zbZUpBuL9HndtyHpgdSBqWj+Nt2MrUcqubSdZWPNo4hlKA9s= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=YxDYs+1z; 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="YxDYs+1z" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 21B2BC116C6; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=U4RiYJ5NN8XuOT+nl3nJo1abaKdDCjeKGV3AxWy6uzU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=YxDYs+1z0+p1hGwKJaOgqMkGW3Ibqjg9GAtNnUKdbaflZP427OnsqT9zJYeA8IPWM qnU0jWQOBkC3sHEECMnDvzZaQRxREebzExjrLxPxoQi41osx9eroeqxdwgV/9IgpeN y8cuZcobJxjz8Irm6IOuyWASbx3CWcmpMI2VhxIG8KqhY3ek7HZ5ILl7fgEeCuIFIR Elze/Ijy+XR4XHh828MmRlEi+3wJiR+Z0bG5OEITB3vPUxBKLgXoadpcwh4KrU1zSI UhI93s10QrXs2gG6SeU5uho8BxLsJTuP3N0bPgqfbtmpVA6BPKG0BPEL1lNfv9JrUU P2SdV2JF9BQdA== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLId-1dZf; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 10/23] docs: media: dvb: enable warnings for most headers Date: Wed, 1 Oct 2025 16:49:33 +0200 Message-ID: <9ae6556ebd47de4f066a149ab0bbe7ce27acf2c4.1759329363.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.51.0 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" Except for two exception rules and dmx.h, the other files are already handling properly cross references. Fix the two exception rules for frontend.h, as those are false-positives: include/uapi/linux/dvb/frontend.h:959: WARNING: can't link to: c:type:: FE= _GET_PROPERTY include/uapi/linux/dvb/frontend.h:933: WARNING: can't link to: c:func:: FE= _SET_FRONTEND_TUNE_MODE The dmx.h are actual issues that will require an extra patch to fill gaps. Signed-off-by: Mauro Carvalho Chehab --- .../userspace-api/media/dvb/frontend.h.rst.exceptions | 5 +++-- Documentation/userspace-api/media/dvb/headers.rst | 3 +++ 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/Documentation/userspace-api/media/dvb/frontend.h.rst.exception= s b/Documentation/userspace-api/media/dvb/frontend.h.rst.exceptions index dcaf5740de7e..cecd4087d4be 100644 --- a/Documentation/userspace-api/media/dvb/frontend.h.rst.exceptions +++ b/Documentation/userspace-api/media/dvb/frontend.h.rst.exceptions @@ -28,13 +28,14 @@ ignore define MAX_DTV_STATS ignore define DTV_IOCTL_MAX_MSGS =20 # the same reference is used for both get and set ioctls -replace ioctl FE_SET_PROPERTY :c:type:`FE_GET_PROPERTY` +replace ioctl FE_SET_PROPERTY :ref:`FE_GET_PROPERTY` +replace ioctl FE_GET_PROPERTY :ref:`FE_GET_PROPERTY` =20 # Typedefs that use the enum reference replace typedef fe_sec_voltage_t :c:type:`fe_sec_voltage` =20 # Replaces for flag constants -replace define FE_TUNE_MODE_ONESHOT :c:func:`FE_SET_FRONTEND_TUNE_MODE` +replace define FE_TUNE_MODE_ONESHOT :ref:`FE_SET_FRONTEND_TUNE_MODE` replace define LNA_AUTO dtv-lna replace define NO_STREAM_ID_FILTER dtv-stream-id =20 diff --git a/Documentation/userspace-api/media/dvb/headers.rst b/Documentat= ion/userspace-api/media/dvb/headers.rst index e78122944a69..3c492ae109ae 100644 --- a/Documentation/userspace-api/media/dvb/headers.rst +++ b/Documentation/userspace-api/media/dvb/headers.rst @@ -15,6 +15,7 @@ Frontend :generate-cross-refs: :exception-file: frontend.h.rst.exceptions :toc: + :warn-broken: =20 Demux =3D=3D=3D=3D=3D @@ -31,6 +32,7 @@ Conditional Access :generate-cross-refs: :exception-file: ca.h.rst.exceptions :toc: + :warn-broken: =20 Network =3D=3D=3D=3D=3D=3D=3D @@ -39,4 +41,5 @@ Network :generate-cross-refs: :exception-file: net.h.rst.exceptions :toc: + :warn-broken: =20 --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 88AE12FD1B4; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=jcQcWz+zJNKsmWZ9/ked2UKlbxwnBd5mAO3zQtKm41B0JU5Z6zFbeDhdqwIN7rzuD3n2zziKZEllYeOb/t3AksZtozoj22102O1UDiEqvB+B3Xf6vw0HHeadhiH246syILiSNDYdBzJ7ssMxnr/VY1tNbghXbuRPqQ12NQ1LXfc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=WG4gx5Qo+/GR9i6asjO9yctRH4XUw9ZpdhzPixKnIo4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=j/CToQl3FdLjG5Hf77UkpdwmPbGh0qzcykmX1ZS9PjvKMn6ZL4EzTgMHAbT8aYM0x69E16iVuwP3Zj5eHEHfHxpHuRWiL0dZdrYuJYAXtEQeCAbY+E1yqo+TwmsjF91rGx1/GwdTrgIAgNliFCpQrW5eMrb6eNeRilY53dOfkwc= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=Dfio1jXJ; 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="Dfio1jXJ" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 21D64C4AF0C; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=WG4gx5Qo+/GR9i6asjO9yctRH4XUw9ZpdhzPixKnIo4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Dfio1jXJn169oci4d38KEYvss9nFLEraDNNYDoCIrF6+cFj1sQMivXpgZfBp9VlkK Ty/Egds+U5KZPm3h8HrDR/u5MSJgkeiBI7H1O40e3v1il9gG0CLwRFK0+DiSkar5Q5 u6S9r+m8gE+wtkAUOatsEODNnBiS09dZ8JtdlKnO3roPWOCJ320k/cmXkoa3YPWQ5y qdLcl/tdJd+Hp4zag1uwH7h9z/dwkBIhQ7sICv7UjdeA+pXl0GLfQBoiCaEroxI3TX kLW4y0QytdbnZMFURizCTgsn5Y5czA68K2w7DloU3IPZu/TRNO/LwjDBQ2xO+XQRo2 8j7h1FkIk3xPw== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLIh-1kH0; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , Sean Young , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 11/23] docs: media: rc: use TOC instead of file contents for LIRC header Date: Wed, 1 Oct 2025 16:49:34 +0200 Message-ID: <94dc601b4777ca544489ffc6cef9a2da5fe28e0e.1759329363.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.51.0 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" All we wanted were to have a way to link the comprehensive documentation with the actual symbols parsed from the header file, as this helps to identify any broken references. Use the new :toc: flag for LIRC and enable warnings. Signed-off-by: Mauro Carvalho Chehab --- .../userspace-api/media/rc/lirc-header.rst | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/Documentation/userspace-api/media/rc/lirc-header.rst b/Documen= tation/userspace-api/media/rc/lirc-header.rst index a53328327847..ba4992625684 100644 --- a/Documentation/userspace-api/media/rc/lirc-header.rst +++ b/Documentation/userspace-api/media/rc/lirc-header.rst @@ -2,11 +2,19 @@ =20 .. _lirc_header: =20 -**************** -LIRC Header File -**************** +***************** +LIRC uAPI symbols +***************** + +.. contents:: Table of Contents + :depth: 2 + :local: + + =20 .. kernel-include:: include/uapi/linux/lirc.h :generate-cross-refs: :exception-file: lirc.h.rst.exceptions + :toc: + :warn-broken: =20 --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 88BAE2FD1C3; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=pTQvoRq+w9tscwWIi8QCxZv6kwvPzS1+loDfRsnX3+tTpGLyEmqviF+jL+VnRMtWXhbMAFxkldtuZmzu2lx7fKArcqQ7l/Jmg47miL6+ktJK7FfW8DG2GSG2gL5VQT0xr3PAZZ/IS3VDRiRvhiraapxF0iJRTleppPI2FcIZxKY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=naZuDICkTezFGayqpf9/NE/sb4ApSBYZii7vMtjwXmE=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=lxJrOIiZxbNW04sd9oTkuXrHWD4/2IG3EqXGuOJxto8aTNXINUMxyfDGC3vvIqw8WslgsxOv/6klAZ4EBuDB79442T8I5p9h3eRc3mg3DKdJQuCh56TeP5vI06lSYpY6cNCuY+ukLjOvVl1f9Vea2faQ8LjZGBJtI1xIqPHTa0Q= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=Y2FGyfm4; 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="Y2FGyfm4" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 3842BC2BCB1; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=naZuDICkTezFGayqpf9/NE/sb4ApSBYZii7vMtjwXmE=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Y2FGyfm47/9BeG5J/XMUk5PBCvaNYKcI6001sYsAsFI9IHd0aaIdvq5u6r8IiXKGw QSHti7BSiXs3BW4nuhwtBdSs3+wOFrqyNrymaoRczsR7ezCmvgAgtuJvLUoZS/34ph 99zZBi4dJH1j7g/BXDnN76gb76vp0KjxLQk8YfZzeW0IAiRFtGhrbHdsRmNEOLINXZ MXQU/wPEIb27U0cuiFt+WM7de4MywZQSTDqmebmIDpbZbwG59nNvLtEOFra1egjLoL w2u4v02/9y7GZcb+6pHiEpPvi4IgO0Ie4wCWbrv/dc0oM+tKnjKTyhJkDyNfWjBuGh w1pU14khHTy7Q== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLIl-1r2S; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 12/23] docs: media: mediactl: use TOC instead of file contents Date: Wed, 1 Oct 2025 16:49:35 +0200 Message-ID: <5c8a87be712397563fc8ca914c3d92fe675e4071.1759329363.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.51.0 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" All we wanted were to have a way to link the comprehensive documentation with the actual symbols parsed from the header file, as this helps to identify any broken references. Use the new :toc: flag for media controller and enable warnings. Here, we need to adjust the exceptions file to setup the C namespace accordingly. Signed-off-by: Mauro Carvalho Chehab --- .../userspace-api/media/mediactl/media-header.rst | 8 +++++--- .../userspace-api/media/mediactl/media.h.rst.exceptions | 3 +++ 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/Documentation/userspace-api/media/mediactl/media-header.rst b/= Documentation/userspace-api/media/mediactl/media-header.rst index d561d2845f3d..a47ac5b2e99b 100644 --- a/Documentation/userspace-api/media/mediactl/media-header.rst +++ b/Documentation/userspace-api/media/mediactl/media-header.rst @@ -2,10 +2,12 @@ =20 .. _media_header: =20 -**************************** -Media Controller Header File -**************************** +***************************** +Media controller uAPI symbols +***************************** =20 .. kernel-include:: include/uapi/linux/media.h :generate-cross-refs: :exception-file: media.h.rst.exceptions + :toc: + :warn-broken: diff --git a/Documentation/userspace-api/media/mediactl/media.h.rst.excepti= ons b/Documentation/userspace-api/media/mediactl/media.h.rst.exceptions index 9b4c26502d95..09aaec2b4718 100644 --- a/Documentation/userspace-api/media/mediactl/media.h.rst.exceptions +++ b/Documentation/userspace-api/media/mediactl/media.h.rst.exceptions @@ -1,5 +1,8 @@ # SPDX-License-Identifier: GPL-2.0 =20 +# All symbols are mapped inside MC C domain namespace +namespace MC + # Ignore header name ignore define __LINUX_MEDIA_H =20 --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 865F32F1FE9; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=in/fTi5PBu9578SbbGbkkorTgI+0SBDavhMc/Rm62pNlzdyVJ8mKK7quqMGywF3kFlnF8S4jFciq6A88ErRJQuUHzkF+l8oOo5Czf8UcGNadKN2Zo/aK+YqS4Dk6Pu5zD5bgcCmLjqc8fd/LFdtELUPb53nhuE2vDE1Ha1PLhVU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=gWTpAMgrDNjjcf3uRyjFHcg7Xl9zfe2ooTOSLm0xHCw=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=fthL3/zW23umOD+tStdpIL7UHDpDOk/QrIFsloMdP63rkaOHLiG/voXKFPPnb2M1XNC3LJlhRDj3ZUgUvc/UUsjzExjm18ZByOdanLP8yGEA6bPJsdJMPK8wyRPwUxx2y8YHLT6oPvXvUTgVUJVBX7qCt4MpZ+EpysoiL9SNcSA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=HBxgjRyq; 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="HBxgjRyq" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 359B6C2BCB0; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=gWTpAMgrDNjjcf3uRyjFHcg7Xl9zfe2ooTOSLm0xHCw=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=HBxgjRyqUkrnBXbn3U7XEwEufQPZmwMGKL7FyXfZ69ZFgZ/XQfRYMYGGnunGWtqUg 1gmWE1lMyfW9b8vt3I81X18juwK8XMuRkSWzUcWN1vwLsMEA4AHI1xmwowVz/9/+HI SSMNrfxUpCGK4IFDflvC0UDXq77LblwgcOAI3Urbym3BIvuekIOeoo9wh+8r0ORccx umFe6Uh3pqNUx14/NZQ1LmjykNE2yDqL1ujENw7UsC4moFzbv22Y+N09Qf1pyiI0rT ZWamN40UzByJWmU01w4h+wK20+WosgmOG2GZvcYXYc+reicrWWw2U61pinN4Oiq64b 6a+EOHspTioog== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLIp-1xpS; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 13/23] docs: kernel_include.py: use get_close_matches() to propose alternatives Date: Wed, 1 Oct 2025 16:49:36 +0200 Message-ID: <7365feb74cbdd6b982c87baf5863360ab98cf727.1759329363.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.51.0 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" Improve the suggestions algorithm by using get_close_matches() if no suggestions with the same name are found. As we're now building a dict, when the name is identical, but on a different domain, the search is O(1), making it a lot faster. The get_close_matches is also fast, as there is just one loop, instead of 3. This can be useful to detect typos on references, with could be the base of a futuere extension that will handle ref unmatches for the entire build, allowing someone to find typos and fix them. As difflib and get_close_matches are there since the early Python 3.x days, we don't need to handle any extra dependencies to use it. We're keeping the default values for the search, e.g. n=3D3, cutoff=3D0.6. With that, we now have things like: $ make SPHINXDIRS=3D"userspace-api/media" htmldocs ... include/uapi/linux/videodev2.h:199: WARNING: Invalid xref: c:type:`v4l2_m= emory`. Possible alternatives: c:type:`v4l2_meta_format` (from v4l/dev-meta) c:type:`v4l2_rect` (from v4l/dev-overlay) c:type:`v4l2_area` (from v4l/ext-ctrls-image-source) [ref.missing] ... include/uapi/linux/videodev2.h:1985: WARNING: Invalid xref: c:type:`V4L.v= 4l2_queryctrl`. Possible alternatives: std:label:`v4l2-queryctrl` (from v4l/vidioc-queryctrl) std:label:`v4l2-query-ext-ctrl` (from v4l/vidioc-queryctrl) At the first example, it was not a typo, but a symbol that doesn't seem to be properly documented. The second example points to v4l2-queryctrl, which is a close match for the symbol. Signed-off-by: Mauro Carvalho Chehab --- Documentation/sphinx/kernel_include.py | 62 +++++++++++++------------- 1 file changed, 30 insertions(+), 32 deletions(-) diff --git a/Documentation/sphinx/kernel_include.py b/Documentation/sphinx/= kernel_include.py index 895646da7495..75e139287d50 100755 --- a/Documentation/sphinx/kernel_include.py +++ b/Documentation/sphinx/kernel_include.py @@ -87,6 +87,8 @@ import os.path import re import sys =20 +from difflib import get_close_matches + from docutils import io, nodes, statemachine from docutils.statemachine import ViewList from docutils.parsers.rst import Directive, directives @@ -401,8 +403,8 @@ class KernelInclude(Directive): # =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D =20 reported =3D set() - DOMAIN_INFO =3D {} +all_refs =3D {} =20 def fill_domain_info(env): """ @@ -419,47 +421,43 @@ def fill_domain_info(env): # Ignore domains that we can't retrieve object types, if any pass =20 + for domain in DOMAIN_INFO.keys(): + domain_obj =3D env.get_domain(domain) + for name, dispname, objtype, docname, anchor, priority in domain_o= bj.get_objects(): + ref_name =3D name.lower() + + if domain =3D=3D "c": + if '.' in ref_name: + ref_name =3D ref_name.split(".")[-1] + + if not ref_name in all_refs: + all_refs[ref_name] =3D [] + + all_refs[ref_name].append(f"\t{domain}:{objtype}:`{name}` (fro= m {docname})") + def get_suggestions(app, env, node, original_target, original_domain, original_reftype): """Check if target exists in the other domain or with different reftyp= es.""" original_target =3D original_target.lower() =20 # Remove namespace if present - if '.' in original_target: - original_target =3D original_target.split(".")[-1] - - targets =3D set([ - original_target, - original_target.replace("-", "_"), - original_target.replace("_", "-"), - ]) - - # Propose some suggestions, if possible - # The code below checks not only variants of the target, but also it - # works when .. c:namespace:: targets setting a different C namespace - # is in place + if original_domain =3D=3D "c": + if '.' in original_target: + original_target =3D original_target.split(".")[-1] =20 suggestions =3D [] - for target in sorted(targets): - for domain in DOMAIN_INFO.keys(): - domain_obj =3D env.get_domain(domain) - for name, dispname, objtype, docname, anchor, priority in doma= in_obj.get_objects(): - lower_name =3D name.lower() =20 - if domain =3D=3D "c": - # Check if name belongs to a different C namespace - match =3D RE_SPLIT_DOMAIN.match(name) - if match: - if target !=3D match.group(2).lower(): - continue - else: - if target !=3D lower_name: - continue - else: - if target !=3D lower_name: - continue + # If name exists, propose exact name match on different domains + if original_target in all_refs: + return all_refs[original_target] =20 - suggestions.append(f"\t{domain}:{objtype}:`{name}` (from {= docname})") + # If not found, get a close match, using difflib. + # Such method is based on Ratcliff-Obershelp Algorithm, which seeks + # for a close match within a certain distance. We're using the defaults + # here, e.g. cutoff=3D0.6, proposing 3 alternatives + matches =3D get_close_matches(original_target, all_refs.keys()) + for match in matches: + suggestions +=3D all_refs[match] =20 return suggestions =20 --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 E60A0303A02; Wed, 1 Oct 2025 14:49:59 +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=1759330200; cv=none; b=eZGZ+Jgxk+/ZHNRulFy6RDA1bC9oeW0V+HWHt4LUbjHg5tbitUYglo4LVYGeTZgwWRBGc+dTVGRXLIZx6HOn3Q7ilMEh3E7lJlW8mrND/qijPlikS5Nx/WcDsZgHQUKYHxUIs1qAgkiynvasnpdWjC7MZn+pwvJ9js6keQG4YC0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330200; c=relaxed/simple; bh=tgVIMdwcdbqiKQ9uBnktU+KN5sWdbtd2DlFPZEaPvyY=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=ZSIbiE1tV5tslDv+e1PHiSDy+ReoA706BOUXgDbDpP85FylKaLZUXxrZCblqbAvLd/hvi9vkpFNXPg0LnNH4uG27OSPziGwxNtgt8+rrIH3CV89CKhT3RYgoqE/26kL4z7vdlOT6mH1edjQtcpFduTat4varJgV+h+fCA2vzCIA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=fyzts3bU; 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="fyzts3bU" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 42E2EC2BCB7; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=tgVIMdwcdbqiKQ9uBnktU+KN5sWdbtd2DlFPZEaPvyY=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=fyzts3bUWNDwxVctfF+5gyym6E06gbkVeZBTfKHEfcWC4YJfFoD6t7Cy6SjOFit5k eTEjk3rmGgWp7lM8t+U7v9ZV8VbtHHF6sg74S4x/DrWf8P+gjjd4pUfYjXSuUGvnq4 e20o9/viaJLeB9KtavYvAQBqXXXgWg7pUvWPXx8RTOEmAwZ0liEnOphb7tNIKzyoIK GMLqeXrYwnSiTu5sovLIwiGTahIlKXzCXf8ZNK46eSKumMd6n8kFPkcsExT1pteRHF GvsOJxo3UbYP9mEY/PMSNlI0EQ4vuBZg6fCNsq/qwlOqsklRsULz3Ui73yQApp5D1D kAHZbl5z9suBQ== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLIu-267v; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , =?UTF-8?q?Hanne-Lotta=20M=C3=A4enp=C3=A4=C3=A4?= , "Mauro Carvalho Chehab" , Bingbu Cao , Dafna Hirschfeld , Dan Scally , Daniel Scally , Dmitry Baryshkov , Dmitry Perchanov , Hans Verkuil , Hans de Goede , Jacopo Mondi , Jonas Karlman , Keke Li , Lad Prabhakar , Laurent Pinchart , Liu Ying , Nicolas Dufresne , Ricardo Ribalda , Sakari Ailus , Tianshu Qiu , Tomi Valkeinen , Yong Zhi , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org, linux-rockchip@lists.infradead.org Subject: [PATCH 14/23] docs: media: add missing c namespace to V4L headers Date: Wed, 1 Oct 2025 16:49:37 +0200 Message-ID: X-Mailer: git-send-email 2.51.0 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" Media references belong to V4L namespace. Fix a lot of broken links when including videodev2.h and probably fixing several other broken cross-references between different files inside media docs. Signed-off-by: Mauro Carvalho Chehab --- Documentation/userspace-api/media/v4l/app-pri.rst | 1 + Documentation/userspace-api/media/v4l/audio.rst | 1 + Documentation/userspace-api/media/v4l/biblio.rst | 1 + Documentation/userspace-api/media/v4l/capture-example.rst | 1 + Documentation/userspace-api/media/v4l/capture.c.rst | 1 + Documentation/userspace-api/media/v4l/colorspaces-defs.rst | 1 + Documentation/userspace-api/media/v4l/colorspaces-details.rst | 1 + Documentation/userspace-api/media/v4l/colorspaces.rst | 1 + Documentation/userspace-api/media/v4l/common-defs.rst | 1 + Documentation/userspace-api/media/v4l/common.rst | 1 + Documentation/userspace-api/media/v4l/compat.rst | 1 + Documentation/userspace-api/media/v4l/control.rst | 1 + Documentation/userspace-api/media/v4l/crop.rst | 1 + Documentation/userspace-api/media/v4l/depth-formats.rst | 1 + Documentation/userspace-api/media/v4l/dev-decoder.rst | 1 + Documentation/userspace-api/media/v4l/dev-encoder.rst | 1 + Documentation/userspace-api/media/v4l/dev-event.rst | 1 + Documentation/userspace-api/media/v4l/dev-mem2mem.rst | 1 + Documentation/userspace-api/media/v4l/dev-meta.rst | 1 + Documentation/userspace-api/media/v4l/dev-osd.rst | 1 + Documentation/userspace-api/media/v4l/dev-overlay.rst | 1 + Documentation/userspace-api/media/v4l/dev-radio.rst | 1 + Documentation/userspace-api/media/v4l/dev-sdr.rst | 1 + Documentation/userspace-api/media/v4l/dev-stateless-decoder.rst | 1 + Documentation/userspace-api/media/v4l/dev-subdev.rst | 1 + Documentation/userspace-api/media/v4l/dev-touch.rst | 1 + Documentation/userspace-api/media/v4l/devices.rst | 1 + Documentation/userspace-api/media/v4l/dv-timings.rst | 1 + Documentation/userspace-api/media/v4l/ext-ctrls-camera.rst | 1 + .../userspace-api/media/v4l/ext-ctrls-codec-stateless.rst | 1 + Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst | 1 + Documentation/userspace-api/media/v4l/ext-ctrls-colorimetry.rst | 1 + Documentation/userspace-api/media/v4l/ext-ctrls-detect.rst | 1 + Documentation/userspace-api/media/v4l/ext-ctrls-dv.rst | 1 + Documentation/userspace-api/media/v4l/ext-ctrls-flash.rst | 1 + Documentation/userspace-api/media/v4l/ext-ctrls-fm-rx.rst | 1 + Documentation/userspace-api/media/v4l/ext-ctrls-fm-tx.rst | 1 + .../userspace-api/media/v4l/ext-ctrls-image-process.rst | 1 + Documentation/userspace-api/media/v4l/ext-ctrls-image-source.rst | 1 + Documentation/userspace-api/media/v4l/ext-ctrls-jpeg.rst | 1 + Documentation/userspace-api/media/v4l/ext-ctrls-rf-tuner.rst | 1 + Documentation/userspace-api/media/v4l/extended-controls.rst | 1 + Documentation/userspace-api/media/v4l/field-order.rst | 1 + Documentation/userspace-api/media/v4l/fourcc.rst | 1 + Documentation/userspace-api/media/v4l/hsv-formats.rst | 1 + Documentation/userspace-api/media/v4l/libv4l.rst | 1 + Documentation/userspace-api/media/v4l/meta-formats.rst | 1 + Documentation/userspace-api/media/v4l/metafmt-c3-isp.rst | 1 + Documentation/userspace-api/media/v4l/metafmt-d4xx.rst | 1 + Documentation/userspace-api/media/v4l/metafmt-generic.rst | 1 + Documentation/userspace-api/media/v4l/metafmt-intel-ipu3.rst | 1 + Documentation/userspace-api/media/v4l/metafmt-pisp-be.rst | 1 + Documentation/userspace-api/media/v4l/metafmt-pisp-fe.rst | 1 + Documentation/userspace-api/media/v4l/metafmt-rkisp1.rst | 1 + Documentation/userspace-api/media/v4l/metafmt-uvc.rst | 1 + Documentation/userspace-api/media/v4l/metafmt-vivid.rst | 1 + Documentation/userspace-api/media/v4l/metafmt-vsp1-hgo.rst | 1 + Documentation/userspace-api/media/v4l/metafmt-vsp1-hgt.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-bayer.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-cnf4.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-compressed.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-indexed.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-intro.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-inzi.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-m420.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-packed-hsv.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-packed-yuv.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-reserved.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-rgb.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-sdr-cs08.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-sdr-cs14le.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-sdr-cu08.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-sdr-cu16le.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu16be.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu18be.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu20be.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-sdr-ru12le.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-srggb10-ipu3.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-srggb10.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-srggb10alaw8.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-srggb10dpcm8.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-srggb10p.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-srggb12.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-srggb12p.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-srggb14.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-srggb14p.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-srggb16.rst | 1 + .../userspace-api/media/v4l/pixfmt-srggb8-pisp-comp.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-srggb8.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-tch-td08.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-tch-td16.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-tch-tu08.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-tch-tu16.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-uv8.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-v4l2-mplane.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-v4l2.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-y12i.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-y16i.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-y8i.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-yuv-luma.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt-z16.rst | 1 + Documentation/userspace-api/media/v4l/pixfmt.rst | 1 + Documentation/userspace-api/media/v4l/planar-apis.rst | 1 + Documentation/userspace-api/media/v4l/querycap.rst | 1 + Documentation/userspace-api/media/v4l/sdr-formats.rst | 1 + .../userspace-api/media/v4l/selection-api-configuration.rst | 1 + Documentation/userspace-api/media/v4l/selection-api-examples.rst | 1 + Documentation/userspace-api/media/v4l/selection-api-intro.rst | 1 + Documentation/userspace-api/media/v4l/selection-api-targets.rst | 1 + .../userspace-api/media/v4l/selection-api-vs-crop-api.rst | 1 + Documentation/userspace-api/media/v4l/selection-api.rst | 1 + Documentation/userspace-api/media/v4l/selections-common.rst | 1 + Documentation/userspace-api/media/v4l/standard.rst | 1 + Documentation/userspace-api/media/v4l/subdev-formats.rst | 1 + Documentation/userspace-api/media/v4l/tch-formats.rst | 1 + Documentation/userspace-api/media/v4l/tuner.rst | 1 + Documentation/userspace-api/media/v4l/user-func.rst | 1 + Documentation/userspace-api/media/v4l/v4l2-selection-flags.rst | 1 + Documentation/userspace-api/media/v4l/v4l2-selection-targets.rst | 1 + Documentation/userspace-api/media/v4l/v4l2.rst | 1 + Documentation/userspace-api/media/v4l/v4l2grab-example.rst | 1 + Documentation/userspace-api/media/v4l/v4l2grab.c.rst | 1 + Documentation/userspace-api/media/v4l/video.rst | 1 + Documentation/userspace-api/media/v4l/videodev.rst | 1 + Documentation/userspace-api/media/v4l/yuv-formats.rst | 1 + 126 files changed, 126 insertions(+) diff --git a/Documentation/userspace-api/media/v4l/app-pri.rst b/Documentat= ion/userspace-api/media/v4l/app-pri.rst index 626a42f2e138..47d96cd64525 100644 --- a/Documentation/userspace-api/media/v4l/app-pri.rst +++ b/Documentation/userspace-api/media/v4l/app-pri.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _app-pri: =20 diff --git a/Documentation/userspace-api/media/v4l/audio.rst b/Documentatio= n/userspace-api/media/v4l/audio.rst index 17f0b1c89908..3b424440e478 100644 --- a/Documentation/userspace-api/media/v4l/audio.rst +++ b/Documentation/userspace-api/media/v4l/audio.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _audio: =20 diff --git a/Documentation/userspace-api/media/v4l/biblio.rst b/Documentati= on/userspace-api/media/v4l/biblio.rst index 856acf6a890c..9721247e66ef 100644 --- a/Documentation/userspace-api/media/v4l/biblio.rst +++ b/Documentation/userspace-api/media/v4l/biblio.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 ********** References diff --git a/Documentation/userspace-api/media/v4l/capture-example.rst b/Do= cumentation/userspace-api/media/v4l/capture-example.rst index 25891320b7ad..f018a654f59c 100644 --- a/Documentation/userspace-api/media/v4l/capture-example.rst +++ b/Documentation/userspace-api/media/v4l/capture-example.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _capture-example: =20 diff --git a/Documentation/userspace-api/media/v4l/capture.c.rst b/Document= ation/userspace-api/media/v4l/capture.c.rst index 349541b1dac0..aae17e1e844a 100644 --- a/Documentation/userspace-api/media/v4l/capture.c.rst +++ b/Documentation/userspace-api/media/v4l/capture.c.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 file: media/v4l/capture.c =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D diff --git a/Documentation/userspace-api/media/v4l/colorspaces-defs.rst b/D= ocumentation/userspace-api/media/v4l/colorspaces-defs.rst index fe9f8aa8ab9d..0b40e735f3bf 100644 --- a/Documentation/userspace-api/media/v4l/colorspaces-defs.rst +++ b/Documentation/userspace-api/media/v4l/colorspaces-defs.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 **************************** Defining Colorspaces in V4L2 diff --git a/Documentation/userspace-api/media/v4l/colorspaces-details.rst = b/Documentation/userspace-api/media/v4l/colorspaces-details.rst index 26a4ace42ca5..f29b0e3978bc 100644 --- a/Documentation/userspace-api/media/v4l/colorspaces-details.rst +++ b/Documentation/userspace-api/media/v4l/colorspaces-details.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 ******************************** Detailed Colorspace Descriptions diff --git a/Documentation/userspace-api/media/v4l/colorspaces.rst b/Docume= ntation/userspace-api/media/v4l/colorspaces.rst index 2aa0dda4fd01..11954d7cf999 100644 --- a/Documentation/userspace-api/media/v4l/colorspaces.rst +++ b/Documentation/userspace-api/media/v4l/colorspaces.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _colorspaces: =20 diff --git a/Documentation/userspace-api/media/v4l/common-defs.rst b/Docume= ntation/userspace-api/media/v4l/common-defs.rst index 6ae42ac7ddb7..329ba6ec760b 100644 --- a/Documentation/userspace-api/media/v4l/common-defs.rst +++ b/Documentation/userspace-api/media/v4l/common-defs.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _common-defs: =20 diff --git a/Documentation/userspace-api/media/v4l/common.rst b/Documentati= on/userspace-api/media/v4l/common.rst index ea0435182e44..507c35fec8ce 100644 --- a/Documentation/userspace-api/media/v4l/common.rst +++ b/Documentation/userspace-api/media/v4l/common.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _common: =20 diff --git a/Documentation/userspace-api/media/v4l/compat.rst b/Documentati= on/userspace-api/media/v4l/compat.rst index b63b8392dec6..f766ea89f9ff 100644 --- a/Documentation/userspace-api/media/v4l/compat.rst +++ b/Documentation/userspace-api/media/v4l/compat.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _compat: =20 diff --git a/Documentation/userspace-api/media/v4l/control.rst b/Documentat= ion/userspace-api/media/v4l/control.rst index 9253cc946f02..19372bb32c4b 100644 --- a/Documentation/userspace-api/media/v4l/control.rst +++ b/Documentation/userspace-api/media/v4l/control.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _control: =20 diff --git a/Documentation/userspace-api/media/v4l/crop.rst b/Documentation= /userspace-api/media/v4l/crop.rst index 3fe185e25ccf..c5f389aca275 100644 --- a/Documentation/userspace-api/media/v4l/crop.rst +++ b/Documentation/userspace-api/media/v4l/crop.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _crop: =20 diff --git a/Documentation/userspace-api/media/v4l/depth-formats.rst b/Docu= mentation/userspace-api/media/v4l/depth-formats.rst index b4f3fc229c85..bd61064d51d3 100644 --- a/Documentation/userspace-api/media/v4l/depth-formats.rst +++ b/Documentation/userspace-api/media/v4l/depth-formats.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _depth-formats: =20 diff --git a/Documentation/userspace-api/media/v4l/dev-decoder.rst b/Docume= ntation/userspace-api/media/v4l/dev-decoder.rst index ef8e8cf31f90..eb662ced0ab4 100644 --- a/Documentation/userspace-api/media/v4l/dev-decoder.rst +++ b/Documentation/userspace-api/media/v4l/dev-decoder.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 +.. c:namespace:: V4L =20 .. _decoder: =20 diff --git a/Documentation/userspace-api/media/v4l/dev-encoder.rst b/Docume= ntation/userspace-api/media/v4l/dev-encoder.rst index 6c523c69bdce..cdad276d00bc 100644 --- a/Documentation/userspace-api/media/v4l/dev-encoder.rst +++ b/Documentation/userspace-api/media/v4l/dev-encoder.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _encoder: =20 diff --git a/Documentation/userspace-api/media/v4l/dev-event.rst b/Document= ation/userspace-api/media/v4l/dev-event.rst index f34f9cf6ce6c..f61d774f0153 100644 --- a/Documentation/userspace-api/media/v4l/dev-event.rst +++ b/Documentation/userspace-api/media/v4l/dev-event.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _event: =20 diff --git a/Documentation/userspace-api/media/v4l/dev-mem2mem.rst b/Docume= ntation/userspace-api/media/v4l/dev-mem2mem.rst index 7041bb3d5b8d..6058eeaefca4 100644 --- a/Documentation/userspace-api/media/v4l/dev-mem2mem.rst +++ b/Documentation/userspace-api/media/v4l/dev-mem2mem.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _mem2mem: =20 diff --git a/Documentation/userspace-api/media/v4l/dev-meta.rst b/Documenta= tion/userspace-api/media/v4l/dev-meta.rst index 5eee9ab60395..da706d01b808 100644 --- a/Documentation/userspace-api/media/v4l/dev-meta.rst +++ b/Documentation/userspace-api/media/v4l/dev-meta.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _metadata: =20 diff --git a/Documentation/userspace-api/media/v4l/dev-osd.rst b/Documentat= ion/userspace-api/media/v4l/dev-osd.rst index 8e4be9129e75..f37450b1b631 100644 --- a/Documentation/userspace-api/media/v4l/dev-osd.rst +++ b/Documentation/userspace-api/media/v4l/dev-osd.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _osd: =20 diff --git a/Documentation/userspace-api/media/v4l/dev-overlay.rst b/Docume= ntation/userspace-api/media/v4l/dev-overlay.rst index d52977120b41..b7f4302eee6e 100644 --- a/Documentation/userspace-api/media/v4l/dev-overlay.rst +++ b/Documentation/userspace-api/media/v4l/dev-overlay.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _overlay: =20 diff --git a/Documentation/userspace-api/media/v4l/dev-radio.rst b/Document= ation/userspace-api/media/v4l/dev-radio.rst index 284ce96a1637..843a2151f470 100644 --- a/Documentation/userspace-api/media/v4l/dev-radio.rst +++ b/Documentation/userspace-api/media/v4l/dev-radio.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _radio: =20 diff --git a/Documentation/userspace-api/media/v4l/dev-sdr.rst b/Documentat= ion/userspace-api/media/v4l/dev-sdr.rst index dfdeddbca41f..99907adc0628 100644 --- a/Documentation/userspace-api/media/v4l/dev-sdr.rst +++ b/Documentation/userspace-api/media/v4l/dev-sdr.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _sdr: =20 diff --git a/Documentation/userspace-api/media/v4l/dev-stateless-decoder.rs= t b/Documentation/userspace-api/media/v4l/dev-stateless-decoder.rst index 35ed05f2695e..e311f0c13272 100644 --- a/Documentation/userspace-api/media/v4l/dev-stateless-decoder.rst +++ b/Documentation/userspace-api/media/v4l/dev-stateless-decoder.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 +.. c:namespace:: V4L =20 .. _stateless_decoder: =20 diff --git a/Documentation/userspace-api/media/v4l/dev-subdev.rst b/Documen= tation/userspace-api/media/v4l/dev-subdev.rst index 161b43f1ce66..d1ad0a2e0cfc 100644 --- a/Documentation/userspace-api/media/v4l/dev-subdev.rst +++ b/Documentation/userspace-api/media/v4l/dev-subdev.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _subdev: =20 diff --git a/Documentation/userspace-api/media/v4l/dev-touch.rst b/Document= ation/userspace-api/media/v4l/dev-touch.rst index a71b9def5d58..808957cd9afc 100644 --- a/Documentation/userspace-api/media/v4l/dev-touch.rst +++ b/Documentation/userspace-api/media/v4l/dev-touch.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _touch: =20 diff --git a/Documentation/userspace-api/media/v4l/devices.rst b/Documentat= ion/userspace-api/media/v4l/devices.rst index 8bfbad65a9d4..d4790b9ef81a 100644 --- a/Documentation/userspace-api/media/v4l/devices.rst +++ b/Documentation/userspace-api/media/v4l/devices.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _devices: =20 diff --git a/Documentation/userspace-api/media/v4l/dv-timings.rst b/Documen= tation/userspace-api/media/v4l/dv-timings.rst index 4b19bcb4bd80..9f117c82df1b 100644 --- a/Documentation/userspace-api/media/v4l/dv-timings.rst +++ b/Documentation/userspace-api/media/v4l/dv-timings.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _dv-timings: =20 diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-camera.rst b/D= ocumentation/userspace-api/media/v4l/ext-ctrls-camera.rst index cdc515c60468..b4daa7e28dc0 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-camera.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-camera.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _camera-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateles= s.rst b/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst index 0da635691fdc..497ae74379f6 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _codec-stateless-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst b/Do= cumentation/userspace-api/media/v4l/ext-ctrls-codec.rst index 4a379bd9e3fb..c8890cb5e00a 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-codec.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _codec-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-colorimetry.rs= t b/Documentation/userspace-api/media/v4l/ext-ctrls-colorimetry.rst index 1e7265155715..38a4136d7220 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-colorimetry.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-colorimetry.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _colorimetry-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-detect.rst b/D= ocumentation/userspace-api/media/v4l/ext-ctrls-detect.rst index 312c4fa94dc3..ee2b7e37c1d9 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-detect.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-detect.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _detect-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-dv.rst b/Docum= entation/userspace-api/media/v4l/ext-ctrls-dv.rst index d2794e03ac6d..5918dde83efb 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-dv.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-dv.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _dv-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-flash.rst b/Do= cumentation/userspace-api/media/v4l/ext-ctrls-flash.rst index d22c5efb806a..bd024ab461a4 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-flash.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-flash.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _flash-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-fm-rx.rst b/Do= cumentation/userspace-api/media/v4l/ext-ctrls-fm-rx.rst index ccd439e9e0e3..b7284768f7ea 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-fm-rx.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-fm-rx.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _fm-rx-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-fm-tx.rst b/Do= cumentation/userspace-api/media/v4l/ext-ctrls-fm-tx.rst index cb40cf4cc3ec..7143a4c08f78 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-fm-tx.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-fm-tx.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _fm-tx-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-image-process.= rst b/Documentation/userspace-api/media/v4l/ext-ctrls-image-process.rst index 27803dca8d3e..6d516f041ca2 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-image-process.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-image-process.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _image-process-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-image-source.r= st b/Documentation/userspace-api/media/v4l/ext-ctrls-image-source.rst index 71f23f131f97..f9c0b7ad3b4e 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-image-source.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-image-source.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _image-source-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-jpeg.rst b/Doc= umentation/userspace-api/media/v4l/ext-ctrls-jpeg.rst index 522095c08469..b114650bca5b 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-jpeg.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-jpeg.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _jpeg-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-rf-tuner.rst b= /Documentation/userspace-api/media/v4l/ext-ctrls-rf-tuner.rst index 8a6f9f0373ff..f50802a1c4d4 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-rf-tuner.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-rf-tuner.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _rf-tuner-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/extended-controls.rst b/= Documentation/userspace-api/media/v4l/extended-controls.rst index 44fcd67f20bf..5fe71da6afc0 100644 --- a/Documentation/userspace-api/media/v4l/extended-controls.rst +++ b/Documentation/userspace-api/media/v4l/extended-controls.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _extended-controls: =20 diff --git a/Documentation/userspace-api/media/v4l/field-order.rst b/Docume= ntation/userspace-api/media/v4l/field-order.rst index 9a0ed8fc550f..2a01852513b3 100644 --- a/Documentation/userspace-api/media/v4l/field-order.rst +++ b/Documentation/userspace-api/media/v4l/field-order.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _field-order: =20 diff --git a/Documentation/userspace-api/media/v4l/fourcc.rst b/Documentati= on/userspace-api/media/v4l/fourcc.rst index d3482c40da62..5cea7008814f 100644 --- a/Documentation/userspace-api/media/v4l/fourcc.rst +++ b/Documentation/userspace-api/media/v4l/fourcc.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 +.. c:namespace:: V4L =20 Guidelines for Video4Linux pixel format 4CCs =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/userspace-api/media/v4l/hsv-formats.rst b/Docume= ntation/userspace-api/media/v4l/hsv-formats.rst index d810c914b673..f0731de6f038 100644 --- a/Documentation/userspace-api/media/v4l/hsv-formats.rst +++ b/Documentation/userspace-api/media/v4l/hsv-formats.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _hsv-formats: =20 diff --git a/Documentation/userspace-api/media/v4l/libv4l.rst b/Documentati= on/userspace-api/media/v4l/libv4l.rst index f446dd2d01ac..ce7a0400891c 100644 --- a/Documentation/userspace-api/media/v4l/libv4l.rst +++ b/Documentation/userspace-api/media/v4l/libv4l.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _libv4l: =20 diff --git a/Documentation/userspace-api/media/v4l/meta-formats.rst b/Docum= entation/userspace-api/media/v4l/meta-formats.rst index 0de80328c36b..d9868ee88a07 100644 --- a/Documentation/userspace-api/media/v4l/meta-formats.rst +++ b/Documentation/userspace-api/media/v4l/meta-formats.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _meta-formats: =20 diff --git a/Documentation/userspace-api/media/v4l/metafmt-c3-isp.rst b/Doc= umentation/userspace-api/media/v4l/metafmt-c3-isp.rst index 449b45c2ec24..24359601ae25 100644 --- a/Documentation/userspace-api/media/v4l/metafmt-c3-isp.rst +++ b/Documentation/userspace-api/media/v4l/metafmt-c3-isp.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: (GPL-2.0-only OR MIT) +.. c:namespace:: V4L =20 .. _v4l2-meta-fmt-c3isp-stats: .. _v4l2-meta-fmt-c3isp-params: diff --git a/Documentation/userspace-api/media/v4l/metafmt-d4xx.rst b/Docum= entation/userspace-api/media/v4l/metafmt-d4xx.rst index 0686413b16b2..d716170bb795 100644 --- a/Documentation/userspace-api/media/v4l/metafmt-d4xx.rst +++ b/Documentation/userspace-api/media/v4l/metafmt-d4xx.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-meta-fmt-d4xx: =20 diff --git a/Documentation/userspace-api/media/v4l/metafmt-generic.rst b/Do= cumentation/userspace-api/media/v4l/metafmt-generic.rst index 78ab56b21682..c5c1abe568bc 100644 --- a/Documentation/userspace-api/media/v4l/metafmt-generic.rst +++ b/Documentation/userspace-api/media/v4l/metafmt-generic.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 **************************************************************************= ***************************************************************************= ***************************************************************************= ************************************************ V4L2_META_FMT_GENERIC_8 ('MET8'), V4L2_META_FMT_GENERIC_CSI2_10 ('MC1A'), = V4L2_META_FMT_GENERIC_CSI2_12 ('MC1C'), V4L2_META_FMT_GENERIC_CSI2_14 ('MC1= E'), V4L2_META_FMT_GENERIC_CSI2_16 ('MC1G'), V4L2_META_FMT_GENERIC_CSI2_20 = ('MC1K'), V4L2_META_FMT_GENERIC_CSI2_24 ('MC1O') diff --git a/Documentation/userspace-api/media/v4l/metafmt-intel-ipu3.rst b= /Documentation/userspace-api/media/v4l/metafmt-intel-ipu3.rst index 84d81dd7a7b5..c11d17e5a286 100644 --- a/Documentation/userspace-api/media/v4l/metafmt-intel-ipu3.rst +++ b/Documentation/userspace-api/media/v4l/metafmt-intel-ipu3.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-meta-fmt-params: .. _v4l2-meta-fmt-stat-3a: diff --git a/Documentation/userspace-api/media/v4l/metafmt-pisp-be.rst b/Do= cumentation/userspace-api/media/v4l/metafmt-pisp-be.rst index 3281fe366c86..e230177910f4 100644 --- a/Documentation/userspace-api/media/v4l/metafmt-pisp-be.rst +++ b/Documentation/userspace-api/media/v4l/metafmt-pisp-be.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 +.. c:namespace:: V4L =20 .. _v4l2-meta-fmt-rpi-be-cfg: =20 diff --git a/Documentation/userspace-api/media/v4l/metafmt-pisp-fe.rst b/Do= cumentation/userspace-api/media/v4l/metafmt-pisp-fe.rst index fddeada83e4a..a2aa5c4c2920 100644 --- a/Documentation/userspace-api/media/v4l/metafmt-pisp-fe.rst +++ b/Documentation/userspace-api/media/v4l/metafmt-pisp-fe.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 +.. c:namespace:: V4L =20 .. _v4l2-meta-fmt-rpi-fe-cfg: =20 diff --git a/Documentation/userspace-api/media/v4l/metafmt-rkisp1.rst b/Doc= umentation/userspace-api/media/v4l/metafmt-rkisp1.rst index 959f6bde8695..d3c899b0150b 100644 --- a/Documentation/userspace-api/media/v4l/metafmt-rkisp1.rst +++ b/Documentation/userspace-api/media/v4l/metafmt-rkisp1.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 +.. c:namespace:: V4L =20 .. _v4l2-meta-fmt-rk-isp1-stat-3a: =20 diff --git a/Documentation/userspace-api/media/v4l/metafmt-uvc.rst b/Docume= ntation/userspace-api/media/v4l/metafmt-uvc.rst index 4c05e9e54683..c4ae2f13e7f7 100644 --- a/Documentation/userspace-api/media/v4l/metafmt-uvc.rst +++ b/Documentation/userspace-api/media/v4l/metafmt-uvc.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-meta-fmt-uvc: =20 diff --git a/Documentation/userspace-api/media/v4l/metafmt-vivid.rst b/Docu= mentation/userspace-api/media/v4l/metafmt-vivid.rst index 7173e2c3e245..94f28736dc80 100644 --- a/Documentation/userspace-api/media/v4l/metafmt-vivid.rst +++ b/Documentation/userspace-api/media/v4l/metafmt-vivid.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-meta-fmt-vivid: =20 diff --git a/Documentation/userspace-api/media/v4l/metafmt-vsp1-hgo.rst b/D= ocumentation/userspace-api/media/v4l/metafmt-vsp1-hgo.rst index 8d886feb180c..70357899a5f0 100644 --- a/Documentation/userspace-api/media/v4l/metafmt-vsp1-hgo.rst +++ b/Documentation/userspace-api/media/v4l/metafmt-vsp1-hgo.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-meta-fmt-vsp1-hgo: =20 diff --git a/Documentation/userspace-api/media/v4l/metafmt-vsp1-hgt.rst b/D= ocumentation/userspace-api/media/v4l/metafmt-vsp1-hgt.rst index d8830ff605de..4a1575a9e728 100644 --- a/Documentation/userspace-api/media/v4l/metafmt-vsp1-hgt.rst +++ b/Documentation/userspace-api/media/v4l/metafmt-vsp1-hgt.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-meta-fmt-vsp1-hgt: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-bayer.rst b/Docum= entation/userspace-api/media/v4l/pixfmt-bayer.rst index b5ca501842b0..8b4e413177f5 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-bayer.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-bayer.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _pixfmt-bayer: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-cnf4.rst b/Docume= ntation/userspace-api/media/v4l/pixfmt-cnf4.rst index 8f469290c304..4e3e9c5f4387 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-cnf4.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-cnf4.rst @@ -1,4 +1,5 @@ .. -*- coding: utf-8; mode: rst -*- +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-CNF4: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst b/= Documentation/userspace-api/media/v4l/pixfmt-compressed.rst index 806ed73ac474..c7efb0465db6 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 ****************** Compressed Formats diff --git a/Documentation/userspace-api/media/v4l/pixfmt-indexed.rst b/Doc= umentation/userspace-api/media/v4l/pixfmt-indexed.rst index 5bd4a47c5854..08d698ebdd64 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-indexed.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-indexed.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _pixfmt-indexed: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-intro.rst b/Docum= entation/userspace-api/media/v4l/pixfmt-intro.rst index 14239ee826bf..00c1b7b0e907 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-intro.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-intro.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 ********************** Standard Image Formats diff --git a/Documentation/userspace-api/media/v4l/pixfmt-inzi.rst b/Docume= ntation/userspace-api/media/v4l/pixfmt-inzi.rst index 3115c8f6a842..0af3a303a7f0 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-inzi.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-inzi.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-INZI: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-m420.rst b/Docume= ntation/userspace-api/media/v4l/pixfmt-m420.rst index c01a949e7c11..f44a6c5eaddf 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-m420.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-m420.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-M420: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-packed-hsv.rst b/= Documentation/userspace-api/media/v4l/pixfmt-packed-hsv.rst index dd89860f50e0..d1cab3c632f1 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-packed-hsv.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-packed-hsv.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _packed-hsv: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-packed-yuv.rst b/= Documentation/userspace-api/media/v4l/pixfmt-packed-yuv.rst index 9f111ed594d2..ae7d88ae1c3d 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-packed-yuv.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-packed-yuv.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _packed-yuv: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-reserved.rst b/Do= cumentation/userspace-api/media/v4l/pixfmt-reserved.rst index ac52485252d9..1cf6c59f4bc4 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-reserved.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-reserved.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _pixfmt-reserved: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-rgb.rst b/Documen= tation/userspace-api/media/v4l/pixfmt-rgb.rst index 5ed4d62df909..cf6760bb6109 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-rgb.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-rgb.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _pixfmt-rgb: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-sdr-cs08.rst b/Do= cumentation/userspace-api/media/v4l/pixfmt-sdr-cs08.rst index bd6ee6111de4..b2dda90409d9 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-sdr-cs08.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-sdr-cs08.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-sdr-fmt-cs8: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-sdr-cs14le.rst b/= Documentation/userspace-api/media/v4l/pixfmt-sdr-cs14le.rst index ea21b288d357..df8b4b22ebce 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-sdr-cs14le.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-sdr-cs14le.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-SDR-FMT-CS14LE: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-sdr-cu08.rst b/Do= cumentation/userspace-api/media/v4l/pixfmt-sdr-cu08.rst index 45fce09d85ff..86accef8f9f4 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-sdr-cu08.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-sdr-cu08.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-sdr-fmt-cu8: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-sdr-cu16le.rst b/= Documentation/userspace-api/media/v4l/pixfmt-sdr-cu16le.rst index 7f4242f8da6f..13d8c86e9b1d 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-sdr-cu16le.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-sdr-cu16le.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-SDR-FMT-CU16LE: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu16be.rst b= /Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu16be.rst index a4d4b70ece63..9c4908d57a25 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu16be.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu16be.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-SDR-FMT-PCU16BE: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu18be.rst b= /Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu18be.rst index 3db690bd683a..56c3f2aee0a4 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu18be.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu18be.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-SDR-FMT-PCU18BE: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu20be.rst b= /Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu20be.rst index 485343cdf150..1992ee5dd2bc 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu20be.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-sdr-pcu20be.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-SDR-FMT-PCU20BE: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-sdr-ru12le.rst b/= Documentation/userspace-api/media/v4l/pixfmt-sdr-ru12le.rst index 2ad4706bfc7a..3b2a94e64bcd 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-sdr-ru12le.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-sdr-ru12le.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-SDR-FMT-RU12LE: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-srggb10-ipu3.rst = b/Documentation/userspace-api/media/v4l/pixfmt-srggb10-ipu3.rst index 3322b0600f1d..de4720dba48a 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-srggb10-ipu3.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-srggb10-ipu3.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-pix-fmt-ipu3-sbggr10: .. _v4l2-pix-fmt-ipu3-sgbrg10: diff --git a/Documentation/userspace-api/media/v4l/pixfmt-srggb10.rst b/Doc= umentation/userspace-api/media/v4l/pixfmt-srggb10.rst index a66414ab4291..6b4950ad54e0 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-srggb10.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-srggb10.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-SRGGB10: .. _v4l2-pix-fmt-sbggr10: diff --git a/Documentation/userspace-api/media/v4l/pixfmt-srggb10alaw8.rst = b/Documentation/userspace-api/media/v4l/pixfmt-srggb10alaw8.rst index a5ae1f099e68..42176c437ebe 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-srggb10alaw8.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-srggb10alaw8.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-SBGGR10ALAW8: .. _v4l2-pix-fmt-sgbrg10alaw8: diff --git a/Documentation/userspace-api/media/v4l/pixfmt-srggb10dpcm8.rst = b/Documentation/userspace-api/media/v4l/pixfmt-srggb10dpcm8.rst index f0544c6f4580..dac580181562 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-srggb10dpcm8.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-srggb10dpcm8.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-SBGGR10DPCM8: .. _v4l2-pix-fmt-sgbrg10dpcm8: diff --git a/Documentation/userspace-api/media/v4l/pixfmt-srggb10p.rst b/Do= cumentation/userspace-api/media/v4l/pixfmt-srggb10p.rst index fd5feb415531..af91f12c24e8 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-srggb10p.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-srggb10p.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-SRGGB10P: .. _v4l2-pix-fmt-sbggr10p: diff --git a/Documentation/userspace-api/media/v4l/pixfmt-srggb12.rst b/Doc= umentation/userspace-api/media/v4l/pixfmt-srggb12.rst index 15c34e1e4835..2b3212ef732f 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-srggb12.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-srggb12.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-SRGGB12: .. _v4l2-pix-fmt-sbggr12: diff --git a/Documentation/userspace-api/media/v4l/pixfmt-srggb12p.rst b/Do= cumentation/userspace-api/media/v4l/pixfmt-srggb12p.rst index 8c03aedcc00e..cffb3dfc338a 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-srggb12p.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-srggb12p.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-SRGGB12P: .. _v4l2-pix-fmt-sbggr12p: diff --git a/Documentation/userspace-api/media/v4l/pixfmt-srggb14.rst b/Doc= umentation/userspace-api/media/v4l/pixfmt-srggb14.rst index 4f5120a6c678..7a3552c045a3 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-srggb14.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-srggb14.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-SRGGB14: .. _v4l2-pix-fmt-sbggr14: diff --git a/Documentation/userspace-api/media/v4l/pixfmt-srggb14p.rst b/Do= cumentation/userspace-api/media/v4l/pixfmt-srggb14p.rst index f4f53d7dbdeb..330197aded11 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-srggb14p.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-srggb14p.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-SRGGB14P: .. _v4l2-pix-fmt-sbggr14p: diff --git a/Documentation/userspace-api/media/v4l/pixfmt-srggb16.rst b/Doc= umentation/userspace-api/media/v4l/pixfmt-srggb16.rst index 2f2f1ef430d9..dab222f49522 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-srggb16.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-srggb16.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-SRGGB16: .. _v4l2-pix-fmt-sbggr16: diff --git a/Documentation/userspace-api/media/v4l/pixfmt-srggb8-pisp-comp.= rst b/Documentation/userspace-api/media/v4l/pixfmt-srggb8-pisp-comp.rst index 5a82a15559d6..7a55a3c7c9f6 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-srggb8-pisp-comp.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-srggb8-pisp-comp.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-pix-fmt-pisp-comp1-rggb: .. _v4l2-pix-fmt-pisp-comp1-grbg: diff --git a/Documentation/userspace-api/media/v4l/pixfmt-srggb8.rst b/Docu= mentation/userspace-api/media/v4l/pixfmt-srggb8.rst index 02061c5a9778..4cb263a6ea26 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-srggb8.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-srggb8.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-SRGGB8: .. _v4l2-pix-fmt-sbggr8: diff --git a/Documentation/userspace-api/media/v4l/pixfmt-tch-td08.rst b/Do= cumentation/userspace-api/media/v4l/pixfmt-tch-td08.rst index ec89f43c60ec..37b03da07cf4 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-tch-td08.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-tch-td08.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-TCH-FMT-DELTA-TD08: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-tch-td16.rst b/Do= cumentation/userspace-api/media/v4l/pixfmt-tch-td16.rst index 7b59a6424243..66d3d7041550 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-tch-td16.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-tch-td16.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-TCH-FMT-DELTA-TD16: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-tch-tu08.rst b/Do= cumentation/userspace-api/media/v4l/pixfmt-tch-tu08.rst index 63c5264b8668..b10bb7bad025 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-tch-tu08.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-tch-tu08.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-TCH-FMT-TU08: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-tch-tu16.rst b/Do= cumentation/userspace-api/media/v4l/pixfmt-tch-tu16.rst index ade618a037a8..889298d010a1 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-tch-tu16.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-tch-tu16.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-TCH-FMT-TU16: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-uv8.rst b/Documen= tation/userspace-api/media/v4l/pixfmt-uv8.rst index ff1d73ef5dba..8fa97b57ad75 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-uv8.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-uv8.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-UV8: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-v4l2-mplane.rst b= /Documentation/userspace-api/media/v4l/pixfmt-v4l2-mplane.rst index ad4da988c3a3..7069b2a6b0b1 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-v4l2-mplane.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-v4l2-mplane.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 ****************************** Multi-planar format structures diff --git a/Documentation/userspace-api/media/v4l/pixfmt-v4l2.rst b/Docume= ntation/userspace-api/media/v4l/pixfmt-v4l2.rst index 9c423ffe02f9..995267741a26 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-v4l2.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-v4l2.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 ****************************** Single-planar format structure diff --git a/Documentation/userspace-api/media/v4l/pixfmt-y12i.rst b/Docume= ntation/userspace-api/media/v4l/pixfmt-y12i.rst index d9b539381d74..b4223ce3506c 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-y12i.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-y12i.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-Y12I: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-y16i.rst b/Docume= ntation/userspace-api/media/v4l/pixfmt-y16i.rst index 74ba9e910a38..51f216f24e41 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-y16i.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-y16i.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-Y16I: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-y8i.rst b/Documen= tation/userspace-api/media/v4l/pixfmt-y8i.rst index 770ed4749c14..c5a3648d37e5 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-y8i.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-y8i.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-Y8I: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-yuv-luma.rst b/Do= cumentation/userspace-api/media/v4l/pixfmt-yuv-luma.rst index 74df19be91f6..99bcc6d385b7 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-yuv-luma.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-yuv-luma.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _yuv-luma-only: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst b/= Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst index 6e4f399f1f88..0631919bd667 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-yuv-planar.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. planar-yuv: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt-z16.rst b/Documen= tation/userspace-api/media/v4l/pixfmt-z16.rst index 54a8cd723d1a..3ab8844d2e6f 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt-z16.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt-z16.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _V4L2-PIX-FMT-Z16: =20 diff --git a/Documentation/userspace-api/media/v4l/pixfmt.rst b/Documentati= on/userspace-api/media/v4l/pixfmt.rst index 11dab4a90630..71b29267488f 100644 --- a/Documentation/userspace-api/media/v4l/pixfmt.rst +++ b/Documentation/userspace-api/media/v4l/pixfmt.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _pixfmt: =20 diff --git a/Documentation/userspace-api/media/v4l/planar-apis.rst b/Docume= ntation/userspace-api/media/v4l/planar-apis.rst index 9207ce4283df..075754f0e423 100644 --- a/Documentation/userspace-api/media/v4l/planar-apis.rst +++ b/Documentation/userspace-api/media/v4l/planar-apis.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _planar-apis: =20 diff --git a/Documentation/userspace-api/media/v4l/querycap.rst b/Documenta= tion/userspace-api/media/v4l/querycap.rst index 15a90271af45..c96f7654c870 100644 --- a/Documentation/userspace-api/media/v4l/querycap.rst +++ b/Documentation/userspace-api/media/v4l/querycap.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _querycap: =20 diff --git a/Documentation/userspace-api/media/v4l/sdr-formats.rst b/Docume= ntation/userspace-api/media/v4l/sdr-formats.rst index d8bdfdb56911..df76b7d2aaf2 100644 --- a/Documentation/userspace-api/media/v4l/sdr-formats.rst +++ b/Documentation/userspace-api/media/v4l/sdr-formats.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _sdr-formats: =20 diff --git a/Documentation/userspace-api/media/v4l/selection-api-configurat= ion.rst b/Documentation/userspace-api/media/v4l/selection-api-configuration= .rst index fee49bf1a1c0..978c401f4252 100644 --- a/Documentation/userspace-api/media/v4l/selection-api-configuration.rst +++ b/Documentation/userspace-api/media/v4l/selection-api-configuration.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 ************* Configuration diff --git a/Documentation/userspace-api/media/v4l/selection-api-examples.r= st b/Documentation/userspace-api/media/v4l/selection-api-examples.rst index 5f8e8a1f59d7..3cf7c067f20f 100644 --- a/Documentation/userspace-api/media/v4l/selection-api-examples.rst +++ b/Documentation/userspace-api/media/v4l/selection-api-examples.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 ******** Examples diff --git a/Documentation/userspace-api/media/v4l/selection-api-intro.rst = b/Documentation/userspace-api/media/v4l/selection-api-intro.rst index 6534854ae9f7..817e660ce016 100644 --- a/Documentation/userspace-api/media/v4l/selection-api-intro.rst +++ b/Documentation/userspace-api/media/v4l/selection-api-intro.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 ************ Introduction diff --git a/Documentation/userspace-api/media/v4l/selection-api-targets.rs= t b/Documentation/userspace-api/media/v4l/selection-api-targets.rst index 50fdadd5b307..e1aaaa3a7123 100644 --- a/Documentation/userspace-api/media/v4l/selection-api-targets.rst +++ b/Documentation/userspace-api/media/v4l/selection-api-targets.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 ***************** Selection targets diff --git a/Documentation/userspace-api/media/v4l/selection-api-vs-crop-ap= i.rst b/Documentation/userspace-api/media/v4l/selection-api-vs-crop-api.rst index f57b9180012c..0c0d66a0cfe6 100644 --- a/Documentation/userspace-api/media/v4l/selection-api-vs-crop-api.rst +++ b/Documentation/userspace-api/media/v4l/selection-api-vs-crop-api.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _selection-vs-crop: =20 diff --git a/Documentation/userspace-api/media/v4l/selection-api.rst b/Docu= mentation/userspace-api/media/v4l/selection-api.rst index 0360743746dc..1320eb632272 100644 --- a/Documentation/userspace-api/media/v4l/selection-api.rst +++ b/Documentation/userspace-api/media/v4l/selection-api.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _selection-api: =20 diff --git a/Documentation/userspace-api/media/v4l/selections-common.rst b/= Documentation/userspace-api/media/v4l/selections-common.rst index 322b39cf0eba..e08da7a9b599 100644 --- a/Documentation/userspace-api/media/v4l/selections-common.rst +++ b/Documentation/userspace-api/media/v4l/selections-common.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-selections-common: =20 diff --git a/Documentation/userspace-api/media/v4l/standard.rst b/Documenta= tion/userspace-api/media/v4l/standard.rst index 1f6678325da9..53818e37db5f 100644 --- a/Documentation/userspace-api/media/v4l/standard.rst +++ b/Documentation/userspace-api/media/v4l/standard.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _standard: =20 diff --git a/Documentation/userspace-api/media/v4l/subdev-formats.rst b/Doc= umentation/userspace-api/media/v4l/subdev-formats.rst index 2a94371448dc..1904390df830 100644 --- a/Documentation/userspace-api/media/v4l/subdev-formats.rst +++ b/Documentation/userspace-api/media/v4l/subdev-formats.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-mbus-format: =20 diff --git a/Documentation/userspace-api/media/v4l/tch-formats.rst b/Docume= ntation/userspace-api/media/v4l/tch-formats.rst index 8c941ff9e200..a382d1c20eb3 100644 --- a/Documentation/userspace-api/media/v4l/tch-formats.rst +++ b/Documentation/userspace-api/media/v4l/tch-formats.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _tch-formats: =20 diff --git a/Documentation/userspace-api/media/v4l/tuner.rst b/Documentatio= n/userspace-api/media/v4l/tuner.rst index e2c53c3abdc6..c82f68d2f900 100644 --- a/Documentation/userspace-api/media/v4l/tuner.rst +++ b/Documentation/userspace-api/media/v4l/tuner.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _tuner: =20 diff --git a/Documentation/userspace-api/media/v4l/user-func.rst b/Document= ation/userspace-api/media/v4l/user-func.rst index 6f661138801c..5fc95c792408 100644 --- a/Documentation/userspace-api/media/v4l/user-func.rst +++ b/Documentation/userspace-api/media/v4l/user-func.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _user-func: =20 diff --git a/Documentation/userspace-api/media/v4l/v4l2-selection-flags.rst= b/Documentation/userspace-api/media/v4l/v4l2-selection-flags.rst index 1cb1531c1e52..6aa00b613148 100644 --- a/Documentation/userspace-api/media/v4l/v4l2-selection-flags.rst +++ b/Documentation/userspace-api/media/v4l/v4l2-selection-flags.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-selection-flags: =20 diff --git a/Documentation/userspace-api/media/v4l/v4l2-selection-targets.r= st b/Documentation/userspace-api/media/v4l/v4l2-selection-targets.rst index b46bae984f35..e9fd4b4bad42 100644 --- a/Documentation/userspace-api/media/v4l/v4l2-selection-targets.rst +++ b/Documentation/userspace-api/media/v4l/v4l2-selection-targets.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2-selection-targets: =20 diff --git a/Documentation/userspace-api/media/v4l/v4l2.rst b/Documentation= /userspace-api/media/v4l/v4l2.rst index cf8ae56a008c..caa41b14dfdc 100644 --- a/Documentation/userspace-api/media/v4l/v4l2.rst +++ b/Documentation/userspace-api/media/v4l/v4l2.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L .. include:: =20 .. _v4l2spec: diff --git a/Documentation/userspace-api/media/v4l/v4l2grab-example.rst b/D= ocumentation/userspace-api/media/v4l/v4l2grab-example.rst index b323be42c580..b2472d4b0e3f 100644 --- a/Documentation/userspace-api/media/v4l/v4l2grab-example.rst +++ b/Documentation/userspace-api/media/v4l/v4l2grab-example.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _v4l2grab-example: =20 diff --git a/Documentation/userspace-api/media/v4l/v4l2grab.c.rst b/Documen= tation/userspace-api/media/v4l/v4l2grab.c.rst index 1a55e3617ea8..c958db1e0211 100644 --- a/Documentation/userspace-api/media/v4l/v4l2grab.c.rst +++ b/Documentation/userspace-api/media/v4l/v4l2grab.c.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 file: media/v4l/v4l2grab.c =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D diff --git a/Documentation/userspace-api/media/v4l/video.rst b/Documentatio= n/userspace-api/media/v4l/video.rst index f8f69a57602c..25cb854c1101 100644 --- a/Documentation/userspace-api/media/v4l/video.rst +++ b/Documentation/userspace-api/media/v4l/video.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _video: =20 diff --git a/Documentation/userspace-api/media/v4l/videodev.rst b/Documenta= tion/userspace-api/media/v4l/videodev.rst index 64be44716494..0b71a60928fb 100644 --- a/Documentation/userspace-api/media/v4l/videodev.rst +++ b/Documentation/userspace-api/media/v4l/videodev.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _videodev: =20 diff --git a/Documentation/userspace-api/media/v4l/yuv-formats.rst b/Docume= ntation/userspace-api/media/v4l/yuv-formats.rst index 78ee406d7647..c5ef408470a5 100644 --- a/Documentation/userspace-api/media/v4l/yuv-formats.rst +++ b/Documentation/userspace-api/media/v4l/yuv-formats.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: V4L =20 .. _yuv-formats: =20 --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 B6C593019DE; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=qOQGGv+VPkXxk8fioQEwNbDG6Kjy+MAqDV73WH82Nx4tCNeOtrkvOTrck8iITyJ+PKx2154z31qZS3GpfjOZE/WC/ANKFBuSdD3Du0v/LnJRAGMNkhniUV7Fpks7p0UNWx7iVoSkSkGHMjbfxqiNe+NG3vLbeG2kCpVMy8TWo84= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=YNq1xYgFUw31uIou15okJA5ve0MNUWqz0G1RufqN5Ao=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=S7fcb1v7S1Ry11rsXM+yA3k9//AUE5RUOjgpSJ1mLri7PpO3sU58/82T3eLJa6PetyLN4I9QqUoMb5bWC+7g0w8UQ2ebbDyw5GvEdTprxMPuTsLlI1nY3VHsBLWNFP05t4Kf17hVeRO3X4PfehvJyIUF4s/W3EJOmtKkS9I+xYs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=Yj81TQF6; 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="Yj81TQF6" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 4042EC4AF10; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=YNq1xYgFUw31uIou15okJA5ve0MNUWqz0G1RufqN5Ao=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Yj81TQF6Dua6HVrsTVyh5U4Kkv2m3qvtmldkwj6H4lp95ZJ4d517lAyUXSHn6oxAZ koG65XWyPOqZTqnSbJmdnQTPnadkhoiMmP88wI/K/6tZcpu4HlMKy8o7VaG8PIoDpv ssgHXplWa1DQtQgtg4CZRXnBJbjjvarY3cO68kh9hMNyhkX69t4KLw/qvM1SB7YOBw 3//qqYtq+XJMdnOMlMD1X1xbRxahLM9PuxNzKN0Re2gzYVZ6lFGLEXKXpsfl+WNeUR GHU66K8iKTR7c5fEm7ntesKWIieO6y2lhUaUFFMmtCzh7lKhJrI0yEzcuZNfEzxjO2 MEgYDZhkjW1Qw== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLIx-2DOh; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , Benjamin Gaignard , Hans Verkuil , Hans de Goede , Ricardo Ribalda , Yunke Cao , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 15/23] docs: media: videodev2.h.rst.exceptions: fix namespace on refs Date: Wed, 1 Oct 2025 16:49:38 +0200 Message-ID: <927f9c19d90b62ffda950cdac9bba23c2ca09f53.1759329363.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.51.0 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" Media uses V4L domain, but the replace rules are not considering it. Fix them. Signed-off-by: Mauro Carvalho Chehab --- .../media/v4l/videodev2.h.rst.exceptions | 284 +++++++++--------- 1 file changed, 142 insertions(+), 142 deletions(-) diff --git a/Documentation/userspace-api/media/v4l/videodev2.h.rst.exceptio= ns b/Documentation/userspace-api/media/v4l/videodev2.h.rst.exceptions index 951d01bf7579..9bcb5ae6fbc4 100644 --- a/Documentation/userspace-api/media/v4l/videodev2.h.rst.exceptions +++ b/Documentation/userspace-api/media/v4l/videodev2.h.rst.exceptions @@ -20,155 +20,155 @@ ignore symbol V4L2_TUNER_DIGITAL_TV ignore symbol V4L2_COLORSPACE_BT878 =20 # Documented enum v4l2_field -replace symbol V4L2_FIELD_ALTERNATE :c:type:`v4l2_field` -replace symbol V4L2_FIELD_ANY :c:type:`v4l2_field` -replace symbol V4L2_FIELD_BOTTOM :c:type:`v4l2_field` -replace symbol V4L2_FIELD_INTERLACED :c:type:`v4l2_field` -replace symbol V4L2_FIELD_INTERLACED_BT :c:type:`v4l2_field` -replace symbol V4L2_FIELD_INTERLACED_TB :c:type:`v4l2_field` -replace symbol V4L2_FIELD_NONE :c:type:`v4l2_field` -replace symbol V4L2_FIELD_SEQ_BT :c:type:`v4l2_field` -replace symbol V4L2_FIELD_SEQ_TB :c:type:`v4l2_field` -replace symbol V4L2_FIELD_TOP :c:type:`v4l2_field` +replace symbol V4L2_FIELD_ALTERNATE :c:type:`V4L.v4l2_field` +replace symbol V4L2_FIELD_ANY :c:type:`V4L.v4l2_field` +replace symbol V4L2_FIELD_BOTTOM :c:type:`V4L.v4l2_field` +replace symbol V4L2_FIELD_INTERLACED :c:type:`V4L.v4l2_field` +replace symbol V4L2_FIELD_INTERLACED_BT :c:type:`V4L.v4l2_field` +replace symbol V4L2_FIELD_INTERLACED_TB :c:type:`V4L.v4l2_field` +replace symbol V4L2_FIELD_NONE :c:type:`V4L.v4l2_field` +replace symbol V4L2_FIELD_SEQ_BT :c:type:`V4L.v4l2_field` +replace symbol V4L2_FIELD_SEQ_TB :c:type:`V4L.v4l2_field` +replace symbol V4L2_FIELD_TOP :c:type:`V4L.v4l2_field` =20 # Documented enum v4l2_buf_type -replace symbol V4L2_BUF_TYPE_META_CAPTURE :c:type:`v4l2_buf_type` -replace symbol V4L2_BUF_TYPE_META_OUTPUT :c:type:`v4l2_buf_type` -replace symbol V4L2_BUF_TYPE_SDR_CAPTURE :c:type:`v4l2_buf_type` -replace symbol V4L2_BUF_TYPE_SDR_OUTPUT :c:type:`v4l2_buf_type` -replace symbol V4L2_BUF_TYPE_SLICED_VBI_CAPTURE :c:type:`v4l2_buf_type` -replace symbol V4L2_BUF_TYPE_SLICED_VBI_OUTPUT :c:type:`v4l2_buf_type` -replace symbol V4L2_BUF_TYPE_VBI_CAPTURE :c:type:`v4l2_buf_type` -replace symbol V4L2_BUF_TYPE_VBI_OUTPUT :c:type:`v4l2_buf_type` -replace symbol V4L2_BUF_TYPE_VIDEO_CAPTURE :c:type:`v4l2_buf_type` -replace symbol V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE :c:type:`v4l2_buf_type` -replace symbol V4L2_BUF_TYPE_VIDEO_OUTPUT :c:type:`v4l2_buf_type` -replace symbol V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE :c:type:`v4l2_buf_type` -replace symbol V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY :c:type:`v4l2_buf_type` -replace symbol V4L2_BUF_TYPE_VIDEO_OVERLAY :c:type:`v4l2_buf_type` +replace symbol V4L2_BUF_TYPE_META_CAPTURE :c:type:`V4L.v4l2_buf_type` +replace symbol V4L2_BUF_TYPE_META_OUTPUT :c:type:`V4L.v4l2_buf_type` +replace symbol V4L2_BUF_TYPE_SDR_CAPTURE :c:type:`V4L.v4l2_buf_type` +replace symbol V4L2_BUF_TYPE_SDR_OUTPUT :c:type:`V4L.v4l2_buf_type` +replace symbol V4L2_BUF_TYPE_SLICED_VBI_CAPTURE :c:type:`V4L.v4l2_buf_type` +replace symbol V4L2_BUF_TYPE_SLICED_VBI_OUTPUT :c:type:`V4L.v4l2_buf_type` +replace symbol V4L2_BUF_TYPE_VBI_CAPTURE :c:type:`V4L.v4l2_buf_type` +replace symbol V4L2_BUF_TYPE_VBI_OUTPUT :c:type:`V4L.v4l2_buf_type` +replace symbol V4L2_BUF_TYPE_VIDEO_CAPTURE :c:type:`V4L.v4l2_buf_type` +replace symbol V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE :c:type:`V4L.v4l2_buf_ty= pe` +replace symbol V4L2_BUF_TYPE_VIDEO_OUTPUT :c:type:`V4L.v4l2_buf_type` +replace symbol V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE :c:type:`V4L.v4l2_buf_typ= e` +replace symbol V4L2_BUF_TYPE_VIDEO_OUTPUT_OVERLAY :c:type:`V4L.v4l2_buf_ty= pe` +replace symbol V4L2_BUF_TYPE_VIDEO_OVERLAY :c:type:`V4L.v4l2_buf_type` =20 # Documented enum v4l2_tuner_type -replace symbol V4L2_TUNER_ANALOG_TV :c:type:`v4l2_tuner_type` -replace symbol V4L2_TUNER_RADIO :c:type:`v4l2_tuner_type` -replace symbol V4L2_TUNER_RF :c:type:`v4l2_tuner_type` -replace symbol V4L2_TUNER_SDR :c:type:`v4l2_tuner_type` +replace symbol V4L2_TUNER_ANALOG_TV :c:type:`V4L.v4l2_tuner_type` +replace symbol V4L2_TUNER_RADIO :c:type:`V4L.v4l2_tuner_type` +replace symbol V4L2_TUNER_RF :c:type:`V4L.v4l2_tuner_type` +replace symbol V4L2_TUNER_SDR :c:type:`V4L.v4l2_tuner_type` =20 # Documented enum v4l2_memory -replace symbol V4L2_MEMORY_DMABUF :c:type:`v4l2_memory` -replace symbol V4L2_MEMORY_MMAP :c:type:`v4l2_memory` -replace symbol V4L2_MEMORY_OVERLAY :c:type:`v4l2_memory` -replace symbol V4L2_MEMORY_USERPTR :c:type:`v4l2_memory` +replace symbol V4L2_MEMORY_DMABUF :c:type:`V4L.v4l2_memory` +replace symbol V4L2_MEMORY_MMAP :c:type:`V4L.v4l2_memory` +replace symbol V4L2_MEMORY_OVERLAY :c:type:`V4L.v4l2_memory` +replace symbol V4L2_MEMORY_USERPTR :c:type:`V4L.v4l2_memory` =20 # Documented enum v4l2_colorspace -replace symbol V4L2_COLORSPACE_470_SYSTEM_BG :c:type:`v4l2_colorspace` -replace symbol V4L2_COLORSPACE_470_SYSTEM_M :c:type:`v4l2_colorspace` -replace symbol V4L2_COLORSPACE_OPRGB :c:type:`v4l2_colorspace` -replace define V4L2_COLORSPACE_ADOBERGB :c:type:`v4l2_colorspace` -replace symbol V4L2_COLORSPACE_BT2020 :c:type:`v4l2_colorspace` -replace symbol V4L2_COLORSPACE_DCI_P3 :c:type:`v4l2_colorspace` -replace symbol V4L2_COLORSPACE_DEFAULT :c:type:`v4l2_colorspace` -replace symbol V4L2_COLORSPACE_JPEG :c:type:`v4l2_colorspace` -replace symbol V4L2_COLORSPACE_RAW :c:type:`v4l2_colorspace` -replace symbol V4L2_COLORSPACE_REC709 :c:type:`v4l2_colorspace` -replace symbol V4L2_COLORSPACE_SMPTE170M :c:type:`v4l2_colorspace` -replace symbol V4L2_COLORSPACE_SMPTE240M :c:type:`v4l2_colorspace` -replace symbol V4L2_COLORSPACE_SRGB :c:type:`v4l2_colorspace` -replace symbol V4L2_COLORSPACE_LAST :c:type:`v4l2_colorspace` +replace symbol V4L2_COLORSPACE_470_SYSTEM_BG :c:type:`V4L.v4l2_colorspace` +replace symbol V4L2_COLORSPACE_470_SYSTEM_M :c:type:`V4L.v4l2_colorspace` +replace symbol V4L2_COLORSPACE_OPRGB :c:type:`V4L.v4l2_colorspace` +replace define V4L2_COLORSPACE_ADOBERGB :c:type:`V4L.v4l2_colorspace` +replace symbol V4L2_COLORSPACE_BT2020 :c:type:`V4L.v4l2_colorspace` +replace symbol V4L2_COLORSPACE_DCI_P3 :c:type:`V4L.v4l2_colorspace` +replace symbol V4L2_COLORSPACE_DEFAULT :c:type:`V4L.v4l2_colorspace` +replace symbol V4L2_COLORSPACE_JPEG :c:type:`V4L.v4l2_colorspace` +replace symbol V4L2_COLORSPACE_RAW :c:type:`V4L.v4l2_colorspace` +replace symbol V4L2_COLORSPACE_REC709 :c:type:`V4L.v4l2_colorspace` +replace symbol V4L2_COLORSPACE_SMPTE170M :c:type:`V4L.v4l2_colorspace` +replace symbol V4L2_COLORSPACE_SMPTE240M :c:type:`V4L.v4l2_colorspace` +replace symbol V4L2_COLORSPACE_SRGB :c:type:`V4L.v4l2_colorspace` +replace symbol V4L2_COLORSPACE_LAST :c:type:`V4L.v4l2_colorspace` =20 # Documented enum v4l2_xfer_func -replace symbol V4L2_XFER_FUNC_709 :c:type:`v4l2_xfer_func` -replace symbol V4L2_XFER_FUNC_OPRGB :c:type:`v4l2_xfer_func` -replace define V4L2_XFER_FUNC_ADOBERGB :c:type:`v4l2_xfer_func` -replace symbol V4L2_XFER_FUNC_DCI_P3 :c:type:`v4l2_xfer_func` -replace symbol V4L2_XFER_FUNC_DEFAULT :c:type:`v4l2_xfer_func` -replace symbol V4L2_XFER_FUNC_NONE :c:type:`v4l2_xfer_func` -replace symbol V4L2_XFER_FUNC_SMPTE2084 :c:type:`v4l2_xfer_func` -replace symbol V4L2_XFER_FUNC_SMPTE240M :c:type:`v4l2_xfer_func` -replace symbol V4L2_XFER_FUNC_SRGB :c:type:`v4l2_xfer_func` -replace symbol V4L2_XFER_FUNC_LAST :c:type:`v4l2_xfer_func` +replace symbol V4L2_XFER_FUNC_709 :c:type:`V4L.v4l2_xfer_func` +replace symbol V4L2_XFER_FUNC_OPRGB :c:type:`V4L.v4l2_xfer_func` +replace define V4L2_XFER_FUNC_ADOBERGB :c:type:`V4L.v4l2_xfer_func` +replace symbol V4L2_XFER_FUNC_DCI_P3 :c:type:`V4L.v4l2_xfer_func` +replace symbol V4L2_XFER_FUNC_DEFAULT :c:type:`V4L.v4l2_xfer_func` +replace symbol V4L2_XFER_FUNC_NONE :c:type:`V4L.v4l2_xfer_func` +replace symbol V4L2_XFER_FUNC_SMPTE2084 :c:type:`V4L.v4l2_xfer_func` +replace symbol V4L2_XFER_FUNC_SMPTE240M :c:type:`V4L.v4l2_xfer_func` +replace symbol V4L2_XFER_FUNC_SRGB :c:type:`V4L.v4l2_xfer_func` +replace symbol V4L2_XFER_FUNC_LAST :c:type:`V4L.v4l2_xfer_func` =20 # Documented enum v4l2_ycbcr_encoding -replace symbol V4L2_YCBCR_ENC_601 :c:type:`v4l2_ycbcr_encoding` -replace symbol V4L2_YCBCR_ENC_709 :c:type:`v4l2_ycbcr_encoding` -replace symbol V4L2_YCBCR_ENC_BT2020 :c:type:`v4l2_ycbcr_encoding` -replace symbol V4L2_YCBCR_ENC_BT2020_CONST_LUM :c:type:`v4l2_ycbcr_encodin= g` -replace symbol V4L2_YCBCR_ENC_DEFAULT :c:type:`v4l2_ycbcr_encoding` -replace symbol V4L2_YCBCR_ENC_SYCC :c:type:`v4l2_ycbcr_encoding` -replace symbol V4L2_YCBCR_ENC_XV601 :c:type:`v4l2_ycbcr_encoding` -replace symbol V4L2_YCBCR_ENC_XV709 :c:type:`v4l2_ycbcr_encoding` -replace symbol V4L2_YCBCR_ENC_SMPTE240M :c:type:`v4l2_ycbcr_encoding` -replace symbol V4L2_YCBCR_ENC_LAST :c:type:`v4l2_ycbcr_encoding` +replace symbol V4L2_YCBCR_ENC_601 :c:type:`V4L.v4l2_ycbcr_encoding` +replace symbol V4L2_YCBCR_ENC_709 :c:type:`V4L.v4l2_ycbcr_encoding` +replace symbol V4L2_YCBCR_ENC_BT2020 :c:type:`V4L.v4l2_ycbcr_encoding` +replace symbol V4L2_YCBCR_ENC_BT2020_CONST_LUM :c:type:`V4L.v4l2_ycbcr_enc= oding` +replace symbol V4L2_YCBCR_ENC_DEFAULT :c:type:`V4L.v4l2_ycbcr_encoding` +replace symbol V4L2_YCBCR_ENC_SYCC :c:type:`V4L.v4l2_ycbcr_encoding` +replace symbol V4L2_YCBCR_ENC_XV601 :c:type:`V4L.v4l2_ycbcr_encoding` +replace symbol V4L2_YCBCR_ENC_XV709 :c:type:`V4L.v4l2_ycbcr_encoding` +replace symbol V4L2_YCBCR_ENC_SMPTE240M :c:type:`V4L.v4l2_ycbcr_encoding` +replace symbol V4L2_YCBCR_ENC_LAST :c:type:`V4L.v4l2_ycbcr_encoding` =20 # Documented enum v4l2_hsv_encoding -replace symbol V4L2_HSV_ENC_180 :c:type:`v4l2_hsv_encoding` -replace symbol V4L2_HSV_ENC_256 :c:type:`v4l2_hsv_encoding` +replace symbol V4L2_HSV_ENC_180 :c:type:`V4L.v4l2_hsv_encoding` +replace symbol V4L2_HSV_ENC_256 :c:type:`V4L.v4l2_hsv_encoding` =20 # Documented enum v4l2_quantization -replace symbol V4L2_QUANTIZATION_DEFAULT :c:type:`v4l2_quantization` -replace symbol V4L2_QUANTIZATION_FULL_RANGE :c:type:`v4l2_quantization` -replace symbol V4L2_QUANTIZATION_LIM_RANGE :c:type:`v4l2_quantization` +replace symbol V4L2_QUANTIZATION_DEFAULT :c:type:`V4L.v4l2_quantization` +replace symbol V4L2_QUANTIZATION_FULL_RANGE :c:type:`V4L.v4l2_quantization` +replace symbol V4L2_QUANTIZATION_LIM_RANGE :c:type:`V4L.v4l2_quantization` =20 # Documented enum v4l2_priority -replace symbol V4L2_PRIORITY_BACKGROUND :c:type:`v4l2_priority` -replace symbol V4L2_PRIORITY_DEFAULT :c:type:`v4l2_priority` -replace symbol V4L2_PRIORITY_INTERACTIVE :c:type:`v4l2_priority` -replace symbol V4L2_PRIORITY_RECORD :c:type:`v4l2_priority` -replace symbol V4L2_PRIORITY_UNSET :c:type:`v4l2_priority` +replace symbol V4L2_PRIORITY_BACKGROUND :c:type:`V4L.v4l2_priority` +replace symbol V4L2_PRIORITY_DEFAULT :c:type:`V4L.v4l2_priority` +replace symbol V4L2_PRIORITY_INTERACTIVE :c:type:`V4L.v4l2_priority` +replace symbol V4L2_PRIORITY_RECORD :c:type:`V4L.v4l2_priority` +replace symbol V4L2_PRIORITY_UNSET :c:type:`V4L.v4l2_priority` =20 # Documented enum v4l2_frmsizetypes -replace symbol V4L2_FRMSIZE_TYPE_CONTINUOUS :c:type:`v4l2_frmsizetypes` -replace symbol V4L2_FRMSIZE_TYPE_DISCRETE :c:type:`v4l2_frmsizetypes` -replace symbol V4L2_FRMSIZE_TYPE_STEPWISE :c:type:`v4l2_frmsizetypes` +replace symbol V4L2_FRMSIZE_TYPE_CONTINUOUS :c:type:`V4L.v4l2_frmsizetypes` +replace symbol V4L2_FRMSIZE_TYPE_DISCRETE :c:type:`V4L.v4l2_frmsizetypes` +replace symbol V4L2_FRMSIZE_TYPE_STEPWISE :c:type:`V4L.v4l2_frmsizetypes` =20 # Documented enum frmivaltypes -replace symbol V4L2_FRMIVAL_TYPE_CONTINUOUS :c:type:`v4l2_frmivaltypes` -replace symbol V4L2_FRMIVAL_TYPE_DISCRETE :c:type:`v4l2_frmivaltypes` -replace symbol V4L2_FRMIVAL_TYPE_STEPWISE :c:type:`v4l2_frmivaltypes` +replace symbol V4L2_FRMIVAL_TYPE_CONTINUOUS :c:type:`V4L.v4l2_frmivaltypes` +replace symbol V4L2_FRMIVAL_TYPE_DISCRETE :c:type:`V4L.v4l2_frmivaltypes` +replace symbol V4L2_FRMIVAL_TYPE_STEPWISE :c:type:`V4L.v4l2_frmivaltypes` =20 -# Documented enum :c:type:`v4l2_ctrl_type` +# Documented enum :c:type:`V4L.v4l2_ctrl_type` replace symbol V4L2_CTRL_COMPOUND_TYPES vidioc_queryctrl =20 -replace symbol V4L2_CTRL_TYPE_BITMASK :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_BOOLEAN :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_BUTTON :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_CTRL_CLASS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_INTEGER :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_INTEGER64 :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_INTEGER_MENU :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_MENU :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_STRING :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_U16 :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_U32 :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_U8 :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_MPEG2_SEQUENCE :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_MPEG2_PICTURE :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_MPEG2_QUANTISATION :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_H264_SPS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_H264_PPS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_H264_SCALING_MATRIX :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_H264_PRED_WEIGHTS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_H264_SLICE_PARAMS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_H264_DECODE_PARAMS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_HEVC_SPS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_HEVC_PPS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_HEVC_SLICE_PARAMS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_AREA :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_RECT :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_FWHT_PARAMS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_VP8_FRAME :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_VP9_COMPRESSED_HDR :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_VP9_FRAME :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_HDR10_CLL_INFO :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_HDR10_MASTERING_DISPLAY :c:type:`v4l2_ctrl_t= ype` -replace symbol V4L2_CTRL_TYPE_HEVC_SPS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_HEVC_PPS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_HEVC_SLICE_PARAMS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_HEVC_SCALING_MATRIX :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_HEVC_DECODE_PARAMS :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_AV1_SEQUENCE :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_AV1_TILE_GROUP_ENTRY :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_AV1_FRAME :c:type:`v4l2_ctrl_type` -replace symbol V4L2_CTRL_TYPE_AV1_FILM_GRAIN :c:type:`v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_BITMASK :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_BOOLEAN :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_BUTTON :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_CTRL_CLASS :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_INTEGER :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_INTEGER64 :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_INTEGER_MENU :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_MENU :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_STRING :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_U16 :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_U32 :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_U8 :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_MPEG2_SEQUENCE :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_MPEG2_PICTURE :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_MPEG2_QUANTISATION :c:type:`V4L.v4l2_ctrl_ty= pe` +replace symbol V4L2_CTRL_TYPE_H264_SPS :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_H264_PPS :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_H264_SCALING_MATRIX :c:type:`V4L.v4l2_ctrl_t= ype` +replace symbol V4L2_CTRL_TYPE_H264_PRED_WEIGHTS :c:type:`V4L.v4l2_ctrl_typ= e` +replace symbol V4L2_CTRL_TYPE_H264_SLICE_PARAMS :c:type:`V4L.v4l2_ctrl_typ= e` +replace symbol V4L2_CTRL_TYPE_H264_DECODE_PARAMS :c:type:`V4L.v4l2_ctrl_ty= pe` +replace symbol V4L2_CTRL_TYPE_HEVC_SPS :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_HEVC_PPS :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_HEVC_SLICE_PARAMS :c:type:`V4L.v4l2_ctrl_typ= e` +replace symbol V4L2_CTRL_TYPE_AREA :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_RECT :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_FWHT_PARAMS :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_VP8_FRAME :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_VP9_COMPRESSED_HDR :c:type:`V4L.v4l2_ctrl_ty= pe` +replace symbol V4L2_CTRL_TYPE_VP9_FRAME :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_HDR10_CLL_INFO :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_HDR10_MASTERING_DISPLAY :c:type:`V4L.v4l2_ct= rl_type` +replace symbol V4L2_CTRL_TYPE_HEVC_SPS :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_HEVC_PPS :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_HEVC_SLICE_PARAMS :c:type:`V4L.v4l2_ctrl_typ= e` +replace symbol V4L2_CTRL_TYPE_HEVC_SCALING_MATRIX :c:type:`V4L.v4l2_ctrl_t= ype` +replace symbol V4L2_CTRL_TYPE_HEVC_DECODE_PARAMS :c:type:`V4L.v4l2_ctrl_ty= pe` +replace symbol V4L2_CTRL_TYPE_AV1_SEQUENCE :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_AV1_TILE_GROUP_ENTRY :c:type:`V4L.v4l2_ctrl_= type` +replace symbol V4L2_CTRL_TYPE_AV1_FRAME :c:type:`V4L.v4l2_ctrl_type` +replace symbol V4L2_CTRL_TYPE_AV1_FILM_GRAIN :c:type:`V4L.v4l2_ctrl_type` =20 # V4L2 capability defines replace define V4L2_CAP_VIDEO_CAPTURE device-capabilities @@ -204,10 +204,10 @@ replace define V4L2_CAP_IO_MC device-capabilities replace define V4L2_CAP_EDID device-capabilities =20 # V4L2 pix flags -replace define V4L2_PIX_FMT_PRIV_MAGIC :c:type:`v4l2_pix_format` +replace define V4L2_PIX_FMT_PRIV_MAGIC :c:type:`V4L.v4l2_pix_format` replace define V4L2_PIX_FMT_FLAG_PREMUL_ALPHA format-flags -replace define V4L2_PIX_FMT_HM12 :c:type:`v4l2_pix_format` -replace define V4L2_PIX_FMT_SUNXI_TILED_NV12 :c:type:`v4l2_pix_format` +replace define V4L2_PIX_FMT_HM12 :c:type:`V4L.v4l2_pix_format` +replace define V4L2_PIX_FMT_SUNXI_TILED_NV12 :c:type:`V4L.v4l2_pix_format` =20 # V4L2 format flags replace define V4L2_FMT_FLAG_COMPRESSED fmtdesc-flags @@ -266,7 +266,7 @@ replace define V4L2_FBUF_FLAG_SRC_CHROMAKEY framebuffer= -flags # Used on VIDIOC_G_PARM =20 replace define V4L2_MODE_HIGHQUALITY parm-flags -replace define V4L2_CAP_TIMEPERFRAME :c:type:`v4l2_captureparm` +replace define V4L2_CAP_TIMEPERFRAME :c:type:`V4L.v4l2_captureparm` =20 # The V4L2_STD_foo are all defined at v4l2_std_id table =20 @@ -319,11 +319,11 @@ replace define V4L2_STD_ALL v4l2-std-id =20 # V4L2 DT BT timings definitions =20 -replace define V4L2_DV_PROGRESSIVE :c:type:`v4l2_bt_timings` -replace define V4L2_DV_INTERLACED :c:type:`v4l2_bt_timings` +replace define V4L2_DV_PROGRESSIVE :c:type:`V4L.v4l2_bt_timings` +replace define V4L2_DV_INTERLACED :c:type:`V4L.v4l2_bt_timings` =20 -replace define V4L2_DV_VSYNC_POS_POL :c:type:`v4l2_bt_timings` -replace define V4L2_DV_HSYNC_POS_POL :c:type:`v4l2_bt_timings` +replace define V4L2_DV_VSYNC_POS_POL :c:type:`V4L.v4l2_bt_timings` +replace define V4L2_DV_HSYNC_POS_POL :c:type:`V4L.v4l2_bt_timings` =20 replace define V4L2_DV_BT_STD_CEA861 dv-bt-standards replace define V4L2_DV_BT_STD_DMT dv-bt-standards @@ -459,11 +459,11 @@ replace define V4L2_AUDMODE_AVL audio-mode =20 # MPEG =20 -replace define V4L2_ENC_IDX_FRAME_I :c:type:`v4l2_enc_idx` -replace define V4L2_ENC_IDX_FRAME_P :c:type:`v4l2_enc_idx` -replace define V4L2_ENC_IDX_FRAME_B :c:type:`v4l2_enc_idx` -replace define V4L2_ENC_IDX_FRAME_MASK :c:type:`v4l2_enc_idx` -replace define V4L2_ENC_IDX_ENTRIES :c:type:`v4l2_enc_idx` +replace define V4L2_ENC_IDX_FRAME_I :c:type:`V4L.v4l2_enc_idx` +replace define V4L2_ENC_IDX_FRAME_P :c:type:`V4L.v4l2_enc_idx` +replace define V4L2_ENC_IDX_FRAME_B :c:type:`V4L.v4l2_enc_idx` +replace define V4L2_ENC_IDX_FRAME_MASK :c:type:`V4L.v4l2_enc_idx` +replace define V4L2_ENC_IDX_ENTRIES :c:type:`V4L.v4l2_enc_idx` =20 replace define V4L2_ENC_CMD_START encoder-cmds replace define V4L2_ENC_CMD_STOP encoder-cmds @@ -491,10 +491,10 @@ replace define V4L2_DEC_START_FMT_GOP decoder-cmds replace define V4L2_VBI_UNSYNC vbifmt-flags replace define V4L2_VBI_INTERLACED vbifmt-flags =20 -replace define V4L2_VBI_ITU_525_F1_START :c:type:`v4l2_vbi_format` -replace define V4L2_VBI_ITU_525_F2_START :c:type:`v4l2_vbi_format` -replace define V4L2_VBI_ITU_625_F1_START :c:type:`v4l2_vbi_format` -replace define V4L2_VBI_ITU_625_F2_START :c:type:`v4l2_vbi_format` +replace define V4L2_VBI_ITU_525_F1_START :c:type:`V4L.v4l2_vbi_format` +replace define V4L2_VBI_ITU_525_F2_START :c:type:`V4L.v4l2_vbi_format` +replace define V4L2_VBI_ITU_625_F1_START :c:type:`V4L.v4l2_vbi_format` +replace define V4L2_VBI_ITU_625_F2_START :c:type:`V4L.v4l2_vbi_format` =20 =20 replace define V4L2_SLICED_TELETEXT_B vbi-services @@ -530,7 +530,7 @@ replace define V4L2_EVENT_CTRL_CH_DIMENSIONS ctrl-chang= es-flags =20 replace define V4L2_EVENT_SRC_CH_RESOLUTION src-changes-flags =20 -replace define V4L2_EVENT_MD_FL_HAVE_FRAME_SEQ :c:type:`v4l2_event_motion_= det` +replace define V4L2_EVENT_MD_FL_HAVE_FRAME_SEQ :c:type:`V4L.v4l2_event_mot= ion_det` =20 replace define V4L2_EVENT_SUB_FL_SEND_INITIAL event-flags replace define V4L2_EVENT_SUB_FL_ALLOW_FEEDBACK event-flags --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 921352FD7DF; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=Dnm5BH2UnttMkGomHvZlw0eV6AoWJn6k8twiyUAiqdy2pjddC+BdFGZXWWv+eB6IFocOAZov+W+aZ+G6oK3tBkVtLoWV/dIMz1NsJnwfI96EAzkXlRf/SKfcrhyiP/5woypQejhwdWN4qdFtUZ7oVKIxhAE0oWLuC5E4fpqFd3k= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=X5d3EN269R0Mk2mv6VYfYFv/qWj0nAYOaSmF+i4NyEI=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=W/6Nm8cSjNttD3fpLMIa8XpHO+NKKGo6G5mLDyN0/PdmPhZqv4T0yvoBouGl+HBHw/swCEyHh5VKq5ur2MBNFqDU1vjcxGFN6g1Q4bobbdr2xkGNP6X2EMzPiPKGlEU9Ka5VspRcGSXHp2n27uD2k9VB9sys5Fcbebbil8iWxSE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=gUmszQtF; 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="gUmszQtF" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 4ADBBC2BCC7; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=X5d3EN269R0Mk2mv6VYfYFv/qWj0nAYOaSmF+i4NyEI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=gUmszQtFk8i8Cj2/omuVvVihBIbJ5PhpxZ0CmGRaijnCgP6yEYPWPdIoOyQW76kAX LDAIsizh7C8X1VTV/2rK2Za8GD30Eg53/PcSu9chPgF3j/h5PeR3Z2UYxsUhuPxO35 v+DvDoE1StYi73D3qmRWAgdh8DDBxaNIJJDktq2yqgdwujPD3Q1pz2ds7mTHDdCA9x VRkTb4vyW807Qj2CBxOdxkgNWdC9DXLrySRFipl4ggu6WuwIpNO2wsNQKKNm8iDgyZ NH12CGOZvQaoclWm99aSAya6PE+z9PS1uFCp557/MtVFku18zoD5bhbVCl+VcYMv/m EvIFvlBFRy8iA== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLJ1-2K9j; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , Hans Verkuil , Hans de Goede , Ricardo Ribalda , Yunke Cao , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 16/23] media: docs: add a missing reference for VIDIOC_QUERY_CTRL Date: Wed, 1 Oct 2025 16:49:39 +0200 Message-ID: <46f86be6ace28abe83ea9ce6fa6138e40185a23a.1759329363.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.51.0 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" This one is missing its c:macro definition. Signed-off-by: Mauro Carvalho Chehab --- Documentation/userspace-api/media/v4l/vidioc-queryctrl.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/userspace-api/media/v4l/vidioc-queryctrl.rst b/D= ocumentation/userspace-api/media/v4l/vidioc-queryctrl.rst index 3549417c7feb..a8d84806a3c0 100644 --- a/Documentation/userspace-api/media/v4l/vidioc-queryctrl.rst +++ b/Documentation/userspace-api/media/v4l/vidioc-queryctrl.rst @@ -15,6 +15,8 @@ VIDIOC_QUERYCTRL - VIDIOC_QUERY_EXT_CTRL - VIDIOC_QUERYME= NU - Enumerate controls Synopsis =3D=3D=3D=3D=3D=3D=3D=3D =20 +.. c:macro:: VIDIOC_QUERY_CTRL + ``int ioctl(int fd, int VIDIOC_QUERYCTRL, struct v4l2_queryctrl *argp)`` =20 .. c:macro:: VIDIOC_QUERY_EXT_CTRL --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 B8F8630215A; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=TPSj1gcQzXrILUMzdB3A5pUdM+gkmyQCaDin6fKY0ocZ8K3ynb+6+WT+Ab0Sx/Ar8CxFbv0J7y/++JfIhKn8X4XN2YI65pmEp36f+ZKJOvshlZEVzNclNT6+kD2DAMvzFK8wh5YOS3I8MBJqWsTM3bFzvmvLX24GAK7RunUu4Q0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=4SMG2xnHWkUrwcb9TUgCCE+356hByF3nNXHaJFswRdM=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=XtuFUw5jGySgOuITfaru826X2z07WGAgIRvLeOUlwCLXxt1GTdjTLr67QWhMsbfD4Ok45fe3x26BV8d8TCVCyLN3XS3E1Kh3aNAMOSaRGQzH9xEWgZH8cMlKcP+B8dB1Qx1FV1tcA/1PWS+t5l0mZhWQq7rRHNdaO5UHxWUr34E= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=DE9TZu76; 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="DE9TZu76" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 56EBEC2BCF4; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=4SMG2xnHWkUrwcb9TUgCCE+356hByF3nNXHaJFswRdM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=DE9TZu768NvMWMLIikmberUP/hL8Nae1quZpLuxH3KA2lUYvXA5KwG7G0rsy2b6YY SUqLaDMV1DVNO45cgudFF4FXiN5WFgfj2Eu0IOY6KEB2OWiOGfo1oCc0o3+nxqKoTY SXwibql4kbmsq6QpELw4j8kvldj4FS25E+L4aAVd7PgABqnyUJWZidMeQj2MLEzfMD NDR5xbZKxxXE4eVog/dnjRPkLvdPAp1IzLGG31z0t//XrervE5QKJ5EKXtP2n2+8gh JVwsUdWVnX6yXlS1jUsMF4G++1r4bIXF0L8eUj17xmEAvNetCXwHM1PcHT1klnlKkV bA1EA1DbwVLgw== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLJ5-2Qvb; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , Benjamin Gaignard , Hans Verkuil , Hans de Goede , Ricardo Ribalda , Yunke Cao , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 17/23] media: docs: videodev2.h.rst.exceptions: ignore struct __kernel_v4l2_timeval Date: Wed, 1 Oct 2025 16:49:40 +0200 Message-ID: X-Mailer: git-send-email 2.51.0 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" This is an ancillary struct used for year-2038 compat logic. It is not meant to be used directly on userspace. Signed-off-by: Mauro Carvalho Chehab --- Documentation/userspace-api/media/v4l/videodev2.h.rst.exceptions | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/userspace-api/media/v4l/videodev2.h.rst.exceptio= ns b/Documentation/userspace-api/media/v4l/videodev2.h.rst.exceptions index 9bcb5ae6fbc4..c41693115db6 100644 --- a/Documentation/userspace-api/media/v4l/videodev2.h.rst.exceptions +++ b/Documentation/userspace-api/media/v4l/videodev2.h.rst.exceptions @@ -18,6 +18,7 @@ ignore define _UAPI__LINUX_VIDEODEV2_H ignore symbol V4L2_BUF_TYPE_PRIVATE ignore symbol V4L2_TUNER_DIGITAL_TV ignore symbol V4L2_COLORSPACE_BT878 +ignore struct __kernel_v4l2_timeval =20 # Documented enum v4l2_field replace symbol V4L2_FIELD_ALTERNATE :c:type:`V4L.v4l2_field` --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 C285E302160; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=TDiKxbaP0l1CHag4kvHMoDJr02cgdzMr/VOOiCxsfjdjAm7Cr2Es5OZyQ/zmnNI0B7x+wD5i6mbez2c4M+2NiRFC6ShlQsvUrp50210j8OGWZ3dtcCQjvmmJlW53p3+DK+RQaW1V0GjzNuhEdfnQYqqaddLVf8+TiUut43B0DEE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=7Ul388q4W4vgu8zu3WDz0+o84z4buoASZ5zF95dEgJM=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=bV/MPiquCSYB8krMqeBkwuktPhbi6ay0P/xJdd9tdBOzGT9SUW2d14WxwgE9LYibzCxSE1dZHnq25xLrD14bW1aJ2jMZjVFMzRyVKdPXTRdXJeH2W5YqnMc4zYpEkg3LdFDf1tow4vvBw0X2RrhPPBFNUs7VreANumWqKUUptX0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=Fv5CxC1U; 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="Fv5CxC1U" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 5A7F2C19422; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=7Ul388q4W4vgu8zu3WDz0+o84z4buoASZ5zF95dEgJM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Fv5CxC1UIrrKvLO+T3Q8sSZhZPzxSIUP+WjUgczZyWKRM32nOeUnW/GKo63Oe43kH mLrjeVor5EsN5FN8m0Cdd5ahNpA6Ya6QnAvXRCvaVpPnT3sBL9iibNZ5BKxD/vjlYA GqzEEdbp7CAciMpHEXPblSkzFw9BeM9huJjMfK1Bixwbt7Tda3eWB9qZmM3hB8LM53 QNHnIyt0fW6l6+6jNtDHu285fmpFHMFNtWuMsII1jxJCDjz1xM8ouVJybpWkreAyXm ipNnKi3INvJcTPGIKTv0oB0jsDLfNzQcAPQqlvv3hSgUyTkxDUmbRYJwPSR7NON0q/ PDFgXfeyFpx0A== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLJ9-2Xkr; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , Hans Verkuil , Hans de Goede , Ricardo Ribalda , Yunke Cao , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 18/23] media: docs: add some C domain missing references Date: Wed, 1 Oct 2025 16:49:41 +0200 Message-ID: X-Mailer: git-send-email 2.51.0 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" Some enum/struct fields don't contain C domain references. Add them to avoid broken xrefs. Signed-off-by: Mauro Carvalho Chehab --- Documentation/userspace-api/media/v4l/buffer.rst | 2 ++ Documentation/userspace-api/media/v4l/vidioc-queryctrl.rst | 6 ++++++ 2 files changed, 8 insertions(+) diff --git a/Documentation/userspace-api/media/v4l/buffer.rst b/Documentati= on/userspace-api/media/v4l/buffer.rst index 856874341882..94dc2719e907 100644 --- a/Documentation/userspace-api/media/v4l/buffer.rst +++ b/Documentation/userspace-api/media/v4l/buffer.rst @@ -667,6 +667,8 @@ Buffer Flags exposure of the frame has begun. This is only valid for the ``V4L2_BUF_TYPE_VIDEO_CAPTURE`` buffer type. =20 +.. c:enum:: v4l2_memory + .. raw:: latex =20 \normalsize diff --git a/Documentation/userspace-api/media/v4l/vidioc-queryctrl.rst b/D= ocumentation/userspace-api/media/v4l/vidioc-queryctrl.rst index a8d84806a3c0..c8baa9430c14 100644 --- a/Documentation/userspace-api/media/v4l/vidioc-queryctrl.rst +++ b/Documentation/userspace-api/media/v4l/vidioc-queryctrl.rst @@ -100,6 +100,8 @@ See also the examples in :ref:`control`. =20 .. _v4l2-queryctrl: =20 +.. c:struct:: v4l2_queryctrl + .. cssclass:: longtable =20 .. flat-table:: struct v4l2_queryctrl @@ -180,6 +182,8 @@ See also the examples in :ref:`control`. =20 .. cssclass:: longtable =20 +.. c:struct:: v4l2_query_ext_ctrl + .. flat-table:: struct v4l2_query_ext_ctrl :header-rows: 0 :stub-columns: 0 @@ -278,6 +282,8 @@ See also the examples in :ref:`control`. =20 .. _v4l2-querymenu: =20 +.. c:struct:: v4l2_querymenu + .. flat-table:: struct v4l2_querymenu :header-rows: 0 :stub-columns: 0 --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 C4759302163; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=iyjh4jfHkaIty4ei3X0z3mbUQvYSHlV47l9uYgkyCt+OyplrsWHBnEXa1zq4pz+R6QMB4lZ2dnC/tFSzAabvP4m3l+mn+sX13kQcPDAa/iddN+mqlB9gr3Gxtoa2qtVOVMT4bci1JDasGNosD+5C/sxvydAXXhlow4v29lxmHZA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=ryC8RulKkWB40Miwek8Lr0KemhOIqsU1f4WZR3x9IME=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=NOfQMwzaikc9Woy9wSVXh1r6w7QctofC1KTi/gpySefxGUBIs0BUkG/qFHODC6gZvV2F3eBN3PBsATyuKWjwnXMDEFGbO7tiwnn2DrvKSw6Wf+lKBdXL9j6u74VEYpYEmnNE4dfTPpkxwCzD45/6AP57BGE+rQErXBhymo7h4K0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=jZY55qP6; 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="jZY55qP6" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 60921C19424; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=ryC8RulKkWB40Miwek8Lr0KemhOIqsU1f4WZR3x9IME=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=jZY55qP6ezdCokgfPTWICBwJRibtd/l9u6v6M70CroGrDjiSvj43Bpx7fd5ZP5eBL PMsCvIlertcHckeSQL7N71Xy/7rvqke0mbnCGrKFOlpelsegR9PJL6P9CwbX4Yi1S4 3h6kdBVu8145lSR+kQKVHTfD17HROSd84I0MxKOnsNdMb83ywWdwQ3AWEXV9/j0A/U 3iqQhMhGml5m3AeyJwI1M52Sd6iBAshMztJLAz71HU8Jk8OeVJ9CKkePg0Zm2eoeFA jpBpfj7CtbeiS6yg4GQnVVDni9arUxtc5QfvKbCca8s9fipsHughTn3zwCht5P61Vl yUrOYqp/kbf1w== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLJD-2eTv; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , Hans Verkuil , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 19/23] docs: cec: cec.h.rst.exceptions: fix broken references from cec.h Date: Wed, 1 Oct 2025 16:49:42 +0200 Message-ID: X-Mailer: git-send-email 2.51.0 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" All references there belong to CEC namespace. Signed-off-by: Mauro Carvalho Chehab --- Documentation/userspace-api/media/cec/cec.h.rst.exceptions | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/userspace-api/media/cec/cec.h.rst.exceptions b/D= ocumentation/userspace-api/media/cec/cec.h.rst.exceptions index 15fa1752d4ef..65e8be062bdb 100644 --- a/Documentation/userspace-api/media/cec/cec.h.rst.exceptions +++ b/Documentation/userspace-api/media/cec/cec.h.rst.exceptions @@ -1,5 +1,8 @@ # SPDX-License-Identifier: GPL-2.0 =20 +# All symbols belong to CEC namespace +namespace CEC + # Ignore header name ignore define _CEC_UAPI_H =20 --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 B45403019C5; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=JwqXeaWgXnZr9djoUI4d6rO7XuV9nBZUjaBdjJ6c6rZCaPzKURvWkRsJwzDVenS3KnIhi53Y0el7U+NKtxvIktwNMt3cLZeDM/y4C/ZnZ2wyOPmFrIb43JD73ptaLJhB5VEVO2zXoF7xK/tEERPO4WFzcavi5E90Fp2vTC0tgMo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=wOiB4fdcRKJl1c/eblFRQcSPxB6yer1N0ORSeW5mvjQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=pVTDCXk8agsNR3uroABwpOotv2VC2KEe4bknsUBywY+aaFGQ3Rw86KreMmnV1SmCFTzBCHOeoqgW0INT83sQHUbPeKr1hhToG8EitAvHp1hZEHRvFmo0wC7NF63qmmonusMpQYwvC6dJgBdKVeD94RbIXvqPiWUeDb0KKW23jj8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=F9FWHeWl; 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="F9FWHeWl" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 629A2C2BCF7; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=wOiB4fdcRKJl1c/eblFRQcSPxB6yer1N0ORSeW5mvjQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=F9FWHeWlxIrEXOoYWUxxTdb4R1DcZuJMYTfMszPWXHiiKux82i8DppxAEia3SW+Bi NdNm7oJMA1wLFkBh5NGvNbyVszaaMFYQHk+ZspnycotjTHX4IH2bkz2I/FuY4wN62N xkuyX1NPDJj9e1hmf1wyBRPDB4mp1YMRRlOfeDKj3ehlkeiYjJHuU6Jg50xk67YFTx 80p10awlyZTdXGO/0XG8cvcr5/mQe3+KdwFJD3RVErSYRVhtkRo9iyugSkg8LwmlbY wp8N/lh1p/nhnxu1UlSRSib+FPDzo5vM3mI9X0esQXk7ZDgCMdXxakOMlT7bcuKTeQ 8HVvfGx7C9i0A== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLJH-2lK7; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , Hans Verkuil , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 20/23] docs: cec: show broken xrefs and show TOC instead of cec.h content Date: Wed, 1 Oct 2025 16:49:43 +0200 Message-ID: X-Mailer: git-send-email 2.51.0 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" Enable xref broken warnings. While here, change the output to only show cross-references, as there's no need to show the entire cec.h header at the docs. Signed-off-by: Mauro Carvalho Chehab --- Documentation/userspace-api/media/cec/cec-header.rst | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/Documentation/userspace-api/media/cec/cec-header.rst b/Documen= tation/userspace-api/media/cec/cec-header.rst index f67003bb8740..648498bc7d6f 100644 --- a/Documentation/userspace-api/media/cec/cec-header.rst +++ b/Documentation/userspace-api/media/cec/cec-header.rst @@ -2,10 +2,12 @@ =20 .. _cec_header: =20 -*************** -CEC Header File -*************** +**************** +CEC uAPI Symbols +**************** =20 .. kernel-include:: include/uapi/linux/cec.h :generate-cross-refs: :exception-file: cec.h.rst.exceptions + :toc: + :warn-broken: --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 B43D53019BD; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=TJ94bLyv031LSoPLdtXok/c2TRLkOiKPelq1nqN7umM0ha9yRDo0DOVwtk2QknrCPB3ip+q744RDANXKqK1RRi0DBNXYGm7mluJ8SplhySbewwg+8819iO99c4iZFy9N+NWC+hbsjvshbUylZd+XvcNVACaUIzYtVhtcjH6FJv0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=2zQBGsH/cQXuSIu370Y/F/Txa7NKJUp+V61gWvu03sI=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=qgiojU17AGk5JuRO81P9dQ+APwAHgS95wHGo65Zxmtoo4UnbNkZzv0Rh+SYh7qTrhlsmyDsBxSiyu154vhjmfFvtYK+ijg73fKKpMpLHXxgGaH03luUgqNI+R79iQlC3hGRBbCBJLT70tPtVuyO+N0lo0CVyfwtFZSPYmQsegWM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=M2E02E62; 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="M2E02E62" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6572BC19421; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=2zQBGsH/cQXuSIu370Y/F/Txa7NKJUp+V61gWvu03sI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=M2E02E62Tnh7kRqXwqu2KPXjxVdmXilDVM8BD5pXSSKje4NsN9YpbGGOh5pyP+LM0 UVateF+pvDQQoTaiaK1tvsxYxNQjyXWT2Yk1jJqfUoOBUIYwyF0N+LnBKPDogHfFpA F9rVctumhkP0kCjs+9yK1M8hFP4bxadwwu0s9xngMJR9elS09s2j185o7ueu1CI9Uw tiEOj5okUwlUoUG3itwJryIl1qEsE7IkecUAMpoZKMYlea3gyuKJCsWzTP3VwrkLpp wQRYuRkpIfx+FAS2W6VblALHgNsuEDxXLkn7reUKKtMQ7QacugHEuTzu3JqM3LsFgn eYOwFF7bSxT2w== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLJL-2rwu; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 21/23] docs: media: dmx_types: place kerneldoc at the right namespace Date: Wed, 1 Oct 2025 16:49:44 +0200 Message-ID: <27fcc036fb5c80bda8116029e1964ad229208095.1759329363.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.51.0 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" The DVB documentation is using DTV.dmx for all demux symbols. Use such domain for kernel-doc documentation. Signed-off-by: Mauro Carvalho Chehab --- Documentation/userspace-api/media/dvb/dmx_types.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/userspace-api/media/dvb/dmx_types.rst b/Document= ation/userspace-api/media/dvb/dmx_types.rst index 33458fbb84ab..dd76010696c8 100644 --- a/Documentation/userspace-api/media/dvb/dmx_types.rst +++ b/Documentation/userspace-api/media/dvb/dmx_types.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later +.. c:namespace:: DTV.dmx =20 .. _dmx_types: =20 --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 B444F3019C4; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=MPorb5Z2wqAZA2Kq7LRKKY7YTl7WEJP8sE0ylTAcL542G64ZFHUHAG7T9sjP8gGL8Mz7ihLZiR6v9J1sxC6paedgnVjNWZtERT3Kqr6x2Bfc1rfeqq/xWikSiSKUj7XZmhRJWMFnx6o/zmDI2Z3ibt6xaaBVaxWfePoXR6voYQ0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=5hYRfD9Ktb0lpUHhpM1IvPTtV3P7mHzM9DQlrfcOk14=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=ouYbNFFmqzudz0PCHsNC1/cO/fNzDw5/JqR2eH6UezqmqDiaTExBHV90W4ECXsY00q4yBf74S7nOQ5zXquHxWlT2R+6syuA6WJAiP+VesFaS2WO+Pn439In4DJ9lrZjOpN5h5WqbzNIFcmTqYQX8LwHeZGmgXpthQWgeCF5Ecps= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=BQkAa7rT; 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="BQkAa7rT" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6EA8AC2BC86; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=5hYRfD9Ktb0lpUHhpM1IvPTtV3P7mHzM9DQlrfcOk14=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=BQkAa7rTV9cJmoFcaPy0lQIqv9lfF0zkm7Hq34mIm1s/2rlKOeRoAG4LvYf2jxqPs HIay3ckQ9e1SJomPyk7BNBNV7xYZ55zDD/s1OGzFCTN0T/LH9zuCvJJr/o5F38KvxA prmxcZp9hrc2ivuCQs6aecFgDFRNszrydGuIkGah7PnxXGFBSMPejO5bDmPRZxx4w1 CsTqYKoMMaGU6f07+6yi4ei9Kch5pQy1SinROOzJUDKXbfPuszXjWjzjKWHiM2+skl /OQxm7A/ZD20BRICMPffWRPxBFnGMRQZDfj/yNl51SaVDHmlr0k0IghwvoXLm3fQ+9 YrrsFu1+og5rw== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLJP-2yw1; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 22/23] docs: media: dvb: headers: warn about broken cross references Date: Wed, 1 Oct 2025 16:49:45 +0200 Message-ID: <8f98dde399df8b937dadf09168194bacce682c7d.1759329363.git.mchehab+huawei@kernel.org> X-Mailer: git-send-email 2.51.0 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" Enable cross-reference warnings for demux header. Signed-off-by: Mauro Carvalho Chehab --- Documentation/userspace-api/media/dvb/headers.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/userspace-api/media/dvb/headers.rst b/Documentat= ion/userspace-api/media/dvb/headers.rst index 3c492ae109ae..6d69622bf1e0 100644 --- a/Documentation/userspace-api/media/dvb/headers.rst +++ b/Documentation/userspace-api/media/dvb/headers.rst @@ -24,6 +24,7 @@ Demux :generate-cross-refs: :exception-file: dmx.h.rst.exceptions :toc: + :warn-broken: =20 Conditional Access =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 2.51.0 From nobody Wed Oct 1 20:28:51 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 B45F73019CB; Wed, 1 Oct 2025 14:49:59 +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=1759330199; cv=none; b=TvqIzJM/ECLFvohMX9+bMTmT+hL+nJdrG6TMJpHGQkBaI7ZACS5LXf1WTO5UK90GJq1/tNyY3+V0lfF1wJ+jpMQ8ot5uZYOyZypalIMzH1OEunaCeD01Hea5vDWBPTJjQDh5jG9366A4zSOWQl9Rphviqj8VshlUw+JXCEDv9uU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759330199; c=relaxed/simple; bh=BpMhPlmacPMtC88QM9VcKjSXx46z3R2YSyY969DUK20=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=SZeRIWvpxiZ6Q+um7A4Bzd7xSij1CLHKlAiNzj+BpZ/sy7do52eBwAX00Y2VyD7s3011r9+R5DdxIXFKaDRRzCPbJhwQH5fkApaVoMpGXcknQa63mBrzR/ZKW2FSOg/8D+8PA3X6naKjMgbZuAJgq0DQwpLJRxxut7OVSMrNCdI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=ZoOFDW4g; 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="ZoOFDW4g" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 73267C4AF16; Wed, 1 Oct 2025 14:49:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1759330199; bh=BpMhPlmacPMtC88QM9VcKjSXx46z3R2YSyY969DUK20=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ZoOFDW4gXeIqus/L69QLXhUu/pfBgDNdnTYUAmniTybkIoJBj7LNHtYouoOoMmoZ4 3BU1hYfGfhiq60cMW0KmB5ukLjsQ3JF00HCyW5dsgLtz5aXfP/ULHZcIoCIIZRgTz6 xpIURT5Nu/1jW+drQR/c5Wq0SQRBNAEjUlYasgVivN3MbRjiTvY3bIXjIwWoRtyPbm hBLO4dsGadDwXqd8XIJRsAwNiIE4rcMrSv2Q2f2oEtQcriMjIMYBuYieNaqZ73NRy6 4X4nLz1iRmSYXxxrG1ZBxKc1KDz0XgalWCpwtysxbdDsUlD+fGB7GcYdfiF1f15sUA sS5J/tootvdLw== Received: from mchehab by mail.kernel.org with local (Exim 4.98.2) (envelope-from ) id 1v3y9V-0000000BLJT-3665; Wed, 01 Oct 2025 16:49:57 +0200 From: Mauro Carvalho Chehab To: "Jonathan Corbet" , Linux Doc Mailing List Cc: Mauro Carvalho Chehab , "Mauro Carvalho Chehab" , linux-kernel@vger.kernel.org, linux-media@vger.kernel.org Subject: [PATCH 23/23] docs: media: dvb: fix dmx.h.rst.exceptions Date: Wed, 1 Oct 2025 16:49:46 +0200 Message-ID: X-Mailer: git-send-email 2.51.0 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" There are lots of broken links on dmx. Those are mostly linked to namespace handling. Yet, some symbols were pointed to the wrong locations, and there are some definitions that aren't needed. Signed-off-by: Mauro Carvalho Chehab --- .../media/dvb/dmx.h.rst.exceptions | 82 +++++++++---------- 1 file changed, 39 insertions(+), 43 deletions(-) diff --git a/Documentation/userspace-api/media/dvb/dmx.h.rst.exceptions b/D= ocumentation/userspace-api/media/dvb/dmx.h.rst.exceptions index afc14d384b83..2c219388d123 100644 --- a/Documentation/userspace-api/media/dvb/dmx.h.rst.exceptions +++ b/Documentation/userspace-api/media/dvb/dmx.h.rst.exceptions @@ -1,34 +1,36 @@ # SPDX-License-Identifier: GPL-2.0 =20 +# All symbols belone to this namespace +namespace DTV.dmx + # Ignore header name ignore define _UAPI_DVBDMX_H_ =20 # Ignore limit constants ignore define DMX_FILTER_SIZE =20 -# dmx_pes_type_t enum symbols -replace enum dmx_ts_pes :c:type:`dmx_pes_type` -replace symbol DMX_PES_AUDIO0 :c:type:`dmx_pes_type` -replace symbol DMX_PES_VIDEO0 :c:type:`dmx_pes_type` -replace symbol DMX_PES_TELETEXT0 :c:type:`dmx_pes_type` -replace symbol DMX_PES_SUBTITLE0 :c:type:`dmx_pes_type` -replace symbol DMX_PES_PCR0 :c:type:`dmx_pes_type` -replace symbol DMX_PES_AUDIO1 :c:type:`dmx_pes_type` -replace symbol DMX_PES_VIDEO1 :c:type:`dmx_pes_type` -replace symbol DMX_PES_TELETEXT1 :c:type:`dmx_pes_type` -replace symbol DMX_PES_SUBTITLE1 :c:type:`dmx_pes_type` -replace symbol DMX_PES_PCR1 :c:type:`dmx_pes_type` -replace symbol DMX_PES_AUDIO2 :c:type:`dmx_pes_type` -replace symbol DMX_PES_VIDEO2 :c:type:`dmx_pes_type` -replace symbol DMX_PES_TELETEXT2 :c:type:`dmx_pes_type` -replace symbol DMX_PES_SUBTITLE2 :c:type:`dmx_pes_type` -replace symbol DMX_PES_PCR2 :c:type:`dmx_pes_type` -replace symbol DMX_PES_AUDIO3 :c:type:`dmx_pes_type` -replace symbol DMX_PES_VIDEO3 :c:type:`dmx_pes_type` -replace symbol DMX_PES_TELETEXT3 :c:type:`dmx_pes_type` -replace symbol DMX_PES_SUBTITLE3 :c:type:`dmx_pes_type` -replace symbol DMX_PES_PCR3 :c:type:`dmx_pes_type` -replace symbol DMX_PES_OTHER :c:type:`dmx_pes_type` +# dmx_ts_pes_type_t enum symbols +replace symbol DMX_PES_AUDIO0 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_VIDEO0 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_TELETEXT0 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_SUBTITLE0 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_PCR0 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_AUDIO1 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_VIDEO1 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_TELETEXT1 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_SUBTITLE1 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_PCR1 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_AUDIO2 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_VIDEO2 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_TELETEXT2 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_SUBTITLE2 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_PCR2 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_AUDIO3 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_VIDEO3 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_TELETEXT3 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_SUBTITLE3 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_PCR3 :c:type:`DTV.dmx.dmx_ts_pes` +replace symbol DMX_PES_OTHER :c:type:`DTV.dmx.dmx_ts_pes` =20 # Ignore obsolete symbols ignore define DMX_PES_AUDIO @@ -38,29 +40,23 @@ ignore define DMX_PES_SUBTITLE ignore define DMX_PES_PCR =20 # dmx_input_t symbols -replace enum dmx_input :c:type:`dmx_input` -replace symbol DMX_IN_FRONTEND :c:type:`dmx_input` -replace symbol DMX_IN_DVR :c:type:`dmx_input` +replace symbol DMX_IN_FRONTEND :c:enum:`DTV.dmx.dmx_input` +replace symbol DMX_IN_DVR :c:enum:`DTV.dmx.dmx_input` =20 # Flags for struct dmx_sct_filter_params -replace define DMX_CHECK_CRC :c:type:`dmx_sct_filter_params` -replace define DMX_ONESHOT :c:type:`dmx_sct_filter_params` -replace define DMX_IMMEDIATE_START :c:type:`dmx_sct_filter_params` +replace define DMX_CHECK_CRC :c:type:`DTV.dmx.dmx_sct_filter_params` +replace define DMX_ONESHOT :c:type:`DTV.dmx.dmx_sct_filter_params` +replace define DMX_IMMEDIATE_START :c:type:`DTV.dmx.dmx_sct_filter_params` =20 -# some typedefs should point to struct/enums -replace typedef dmx_filter_t :c:type:`dmx_filter` -replace typedef dmx_pes_type_t :c:type:`dmx_pes_type` -replace typedef dmx_input_t :c:type:`dmx_input` +replace symbol DMX_BUFFER_FLAG_HAD_CRC32_DISCARD :c:type:`DTV.dmx.dmx_buff= er_flags` +replace symbol DMX_BUFFER_FLAG_TEI :c:type:`DTV.dmx.dmx_buffer_flags` +replace symbol DMX_BUFFER_PKT_COUNTER_MISMATCH :c:type:`DTV.dmx.dmx_buffer= _flags` +replace symbol DMX_BUFFER_FLAG_DISCONTINUITY_DETECTED :c:type:`DTV.dmx.dmx= _buffer_flags` +replace symbol DMX_BUFFER_FLAG_DISCONTINUITY_INDICATOR :c:type:`DTV.dmx.dm= x_buffer_flags` =20 -replace symbol DMX_BUFFER_FLAG_HAD_CRC32_DISCARD :c:type:`dmx_buffer_flags` -replace symbol DMX_BUFFER_FLAG_TEI :c:type:`dmx_buffer_flags` -replace symbol DMX_BUFFER_PKT_COUNTER_MISMATCH :c:type:`dmx_buffer_flags` -replace symbol DMX_BUFFER_FLAG_DISCONTINUITY_DETECTED :c:type:`dmx_buffer_= flags` -replace symbol DMX_BUFFER_FLAG_DISCONTINUITY_INDICATOR :c:type:`dmx_buffer= _flags` - -replace symbol DMX_OUT_DECODER :c:type:`dmx_output` -replace symbol DMX_OUT_TAP :c:type:`dmx_output` -replace symbol DMX_OUT_TS_TAP :c:type:`dmx_output` -replace symbol DMX_OUT_TSDEMUX_TAP :c:type:`dmx_output` +replace symbol DMX_OUT_DECODER :c:type:`DTV.dmx.dmx_output` +replace symbol DMX_OUT_TAP :c:type:`DTV.dmx.dmx_output` +replace symbol DMX_OUT_TS_TAP :c:type:`DTV.dmx.dmx_output` +replace symbol DMX_OUT_TSDEMUX_TAP :c:type:`DTV.dmx.dmx_output` =20 replace ioctl DMX_DQBUF dmx_qbuf --=20 2.51.0