* [PATCH] docs: parse-headers.rst: Fix a typo
@ 2025-11-15 11:42 Ankit Khushwaha
2025-11-15 19:49 ` Randy Dunlap
2025-11-18 16:13 ` Jonathan Corbet
0 siblings, 2 replies; 3+ messages in thread
From: Ankit Khushwaha @ 2025-11-15 11:42 UTC (permalink / raw)
To: Jonathan Corbet, linux-doc, Mauro Carvalho Chehab
Cc: Randy Dunlap, Dongliang Mu, linux-kernel, linux-kernel-mentees,
Ankit Khushwaha
Replace "vantage" with "advantage" in the description of userspace API
cross-references.
Signed-off-by: Ankit Khushwaha <ankitkhushwaha.linux@gmail.com>
---
| 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
--git a/Documentation/doc-guide/parse-headers.rst b/Documentation/doc-guide/parse-headers.rst
index bd34a6d00ca9..a7bb01ff04eb 100644
--- a/Documentation/doc-guide/parse-headers.rst
+++ b/Documentation/doc-guide/parse-headers.rst
@@ -5,7 +5,7 @@ Including uAPI header files
Sometimes, it is useful to include header files and C example codes in
order to describe the userspace API and to generate cross-references
between the code and the documentation. Adding cross-references for
-userspace API files has an additional vantage: Sphinx will generate warnings
+userspace API files has an additional advantage: Sphinx will generate warnings
if a symbol is not found at the documentation. That helps to keep the
uAPI documentation in sync with the Kernel changes.
The :ref:`parse_headers.py <parse_headers>` provides a way to generate such
--
2.51.1
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [PATCH] docs: parse-headers.rst: Fix a typo
2025-11-15 11:42 [PATCH] docs: parse-headers.rst: Fix a typo Ankit Khushwaha
@ 2025-11-15 19:49 ` Randy Dunlap
2025-11-18 16:13 ` Jonathan Corbet
1 sibling, 0 replies; 3+ messages in thread
From: Randy Dunlap @ 2025-11-15 19:49 UTC (permalink / raw)
To: Ankit Khushwaha, Jonathan Corbet, linux-doc,
Mauro Carvalho Chehab
Cc: Dongliang Mu, linux-kernel, linux-kernel-mentees
On 11/15/25 3:42 AM, Ankit Khushwaha wrote:
> Replace "vantage" with "advantage" in the description of userspace API
> cross-references.
>
> Signed-off-by: Ankit Khushwaha <ankitkhushwaha.linux@gmail.com>
> ---
> Documentation/doc-guide/parse-headers.rst | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/doc-guide/parse-headers.rst b/Documentation/doc-guide/parse-headers.rst
> index bd34a6d00ca9..a7bb01ff04eb 100644
> --- a/Documentation/doc-guide/parse-headers.rst
> +++ b/Documentation/doc-guide/parse-headers.rst
> @@ -5,7 +5,7 @@ Including uAPI header files
> Sometimes, it is useful to include header files and C example codes in
> order to describe the userspace API and to generate cross-references
> between the code and the documentation. Adding cross-references for
> -userspace API files has an additional vantage: Sphinx will generate warnings
> +userspace API files has an additional advantage: Sphinx will generate warnings
Yeah, I prefer "advantage," but the definition of "vantage" also fits
here IMO.
> if a symbol is not found at the documentation. That helps to keep the
> uAPI documentation in sync with the Kernel changes.
> The :ref:`parse_headers.py <parse_headers>` provides a way to generate such
> --
> 2.51.1
>
--
~Randy
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [PATCH] docs: parse-headers.rst: Fix a typo
2025-11-15 11:42 [PATCH] docs: parse-headers.rst: Fix a typo Ankit Khushwaha
2025-11-15 19:49 ` Randy Dunlap
@ 2025-11-18 16:13 ` Jonathan Corbet
1 sibling, 0 replies; 3+ messages in thread
From: Jonathan Corbet @ 2025-11-18 16:13 UTC (permalink / raw)
To: Ankit Khushwaha, linux-doc, Mauro Carvalho Chehab
Cc: Randy Dunlap, Dongliang Mu, linux-kernel, linux-kernel-mentees,
Ankit Khushwaha
Ankit Khushwaha <ankitkhushwaha.linux@gmail.com> writes:
> Replace "vantage" with "advantage" in the description of userspace API
> cross-references.
>
> Signed-off-by: Ankit Khushwaha <ankitkhushwaha.linux@gmail.com>
> ---
> Documentation/doc-guide/parse-headers.rst | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/doc-guide/parse-headers.rst b/Documentation/doc-guide/parse-headers.rst
> index bd34a6d00ca9..a7bb01ff04eb 100644
> --- a/Documentation/doc-guide/parse-headers.rst
> +++ b/Documentation/doc-guide/parse-headers.rst
> @@ -5,7 +5,7 @@ Including uAPI header files
> Sometimes, it is useful to include header files and C example codes in
> order to describe the userspace API and to generate cross-references
> between the code and the documentation. Adding cross-references for
> -userspace API files has an additional vantage: Sphinx will generate warnings
> +userspace API files has an additional advantage: Sphinx will generate warnings
> if a symbol is not found at the documentation. That helps to keep the
Applied, thanks.
jon
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2025-11-18 16:13 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2025-11-15 11:42 [PATCH] docs: parse-headers.rst: Fix a typo Ankit Khushwaha
2025-11-15 19:49 ` Randy Dunlap
2025-11-18 16:13 ` Jonathan Corbet
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox