[PATCH] docs: clarify wording in programming-language.rst

Ariful Islam Shoikot posted 1 patch 1 month, 2 weeks ago
Documentation/process/programming-language.rst | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
[PATCH] docs: clarify wording in programming-language.rst
Posted by Ariful Islam Shoikot 1 month, 2 weeks ago
Clarify that the Linux kernel is written in C and improve
punctuation in the clang sentence.

Signed-off-by: Ariful Islam Shoikot <islamarifulshoikat@gmail.com>
---
 Documentation/process/programming-language.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/Documentation/process/programming-language.rst b/Documentation/process/programming-language.rst
index f39d1d3dd9ce..c18e307ccb56 100644
--- a/Documentation/process/programming-language.rst
+++ b/Documentation/process/programming-language.rst
@@ -3,10 +3,10 @@
 Programming Language
 ====================
 
-The kernel is written in the C programming language [c-language]_.
-More precisely, the kernel is typically compiled with ``gcc`` [gcc]_
+The Linux kernel is written in the C programming language [c-language]_.
+More precisely, it is typically compiled with ``gcc`` [gcc]_
 under ``-std=gnu11`` [gcc-c-dialect-options]_: the GNU dialect of ISO C11.
-``clang`` [clang]_ is also supported, see docs on
+``clang`` [clang]_ is also supported; see documentation on
 :ref:`Building Linux with Clang/LLVM <kbuild_llvm>`.
 
 This dialect contains many extensions to the language [gnu-extensions]_,
-- 
2.43.0
Re: [PATCH] docs: clarify wording in programming-language.rst
Posted by Jonathan Corbet 1 month, 2 weeks ago
Ariful Islam Shoikot <islamarifulshoikat@gmail.com> writes:

> Clarify that the Linux kernel is written in C and improve
> punctuation in the clang sentence.
>
> Signed-off-by: Ariful Islam Shoikot <islamarifulshoikat@gmail.com>
> ---
>  Documentation/process/programming-language.rst | 6 +++---
>  1 file changed, 3 insertions(+), 3 deletions(-)
>
> diff --git a/Documentation/process/programming-language.rst b/Documentation/process/programming-language.rst
> index f39d1d3dd9ce..c18e307ccb56 100644
> --- a/Documentation/process/programming-language.rst
> +++ b/Documentation/process/programming-language.rst
> @@ -3,10 +3,10 @@
>  Programming Language
>  ====================
>  
> -The kernel is written in the C programming language [c-language]_.
> -More precisely, the kernel is typically compiled with ``gcc`` [gcc]_
> +The Linux kernel is written in the C programming language [c-language]_.
> +More precisely, it is typically compiled with ``gcc`` [gcc]_
>  under ``-std=gnu11`` [gcc-c-dialect-options]_: the GNU dialect of ISO C11.
> -``clang`` [clang]_ is also supported, see docs on
> +``clang`` [clang]_ is also supported; see documentation on
>  :ref:`Building Linux with Clang/LLVM <kbuild_llvm>`.

So you have tidied up the language, but not addressed the fact that the
information is somewhat outdated.  Clang is a first-class option these
days, and the documentation should probably reflect that.

Oh well, I've applied this as a good start :)

Thanks,

jon
Re: [PATCH] docs: clarify wording in programming-language.rst
Posted by Randy Dunlap 1 month, 2 weeks ago

On 2/14/26 9:11 AM, Jonathan Corbet wrote:
> Ariful Islam Shoikot <islamarifulshoikat@gmail.com> writes:
> 
>> Clarify that the Linux kernel is written in C and improve
>> punctuation in the clang sentence.
>>
>> Signed-off-by: Ariful Islam Shoikot <islamarifulshoikat@gmail.com>
>> ---
>>  Documentation/process/programming-language.rst | 6 +++---
>>  1 file changed, 3 insertions(+), 3 deletions(-)
>>
>> diff --git a/Documentation/process/programming-language.rst b/Documentation/process/programming-language.rst
>> index f39d1d3dd9ce..c18e307ccb56 100644
>> --- a/Documentation/process/programming-language.rst
>> +++ b/Documentation/process/programming-language.rst
>> @@ -3,10 +3,10 @@
>>  Programming Language
>>  ====================
>>  
>> -The kernel is written in the C programming language [c-language]_.
>> -More precisely, the kernel is typically compiled with ``gcc`` [gcc]_
>> +The Linux kernel is written in the C programming language [c-language]_.
>> +More precisely, it is typically compiled with ``gcc`` [gcc]_
>>  under ``-std=gnu11`` [gcc-c-dialect-options]_: the GNU dialect of ISO C11.
>> -``clang`` [clang]_ is also supported, see docs on
>> +``clang`` [clang]_ is also supported; see documentation on
>>  :ref:`Building Linux with Clang/LLVM <kbuild_llvm>`.
> 
> So you have tidied up the language, but not addressed the fact that the
> information is somewhat outdated.  Clang is a first-class option these
> days, and the documentation should probably reflect that.
> 
> Oh well, I've applied this as a good start :)


Maybe mention Rust as well?
-- 
~Randy