public inbox for linux-kernel-mentees@lists.linux-foundation.org
 help / color / mirror / Atom feed
* [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>
---
 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
 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