Commit 40be2369 authored by Thorsten Blum's avatar Thorsten Blum Committed by Jonathan Corbet

Documentation: multiple .rst files: Fix grammar and more consistent formatting

sphinx.rst:
- Remove unnecessary newline
- Fix grammar s/on/in/
- Fix grammar s/check/checks/
- Capitalize heading "The C domain"

changes.rst:
- Remove colon after "pahole" to be consistent with other entries

howto.rst:
- Fix grammar s/you will/will you/
- Hyphenate "real-world problems"
Signed-off-by: default avatarThorsten Blum <thorsten.blum@toblux.com>
Reviewed-by: default avatarRandy Dunlap <rdunlap@infradead.org>
Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/20240205000117.3285-1-thorsten.blum@toblux.com
parent 185ea767
...@@ -63,8 +63,7 @@ Image output ...@@ -63,8 +63,7 @@ Image output
------------ ------------
The kernel documentation build system contains an extension that The kernel documentation build system contains an extension that
handles images on both GraphViz and SVG formats (see handles images in both GraphViz and SVG formats (see :ref:`sphinx_kfigure`).
:ref:`sphinx_kfigure`).
For it to work, you need to install both GraphViz and ImageMagick For it to work, you need to install both GraphViz and ImageMagick
packages. If those packages are not installed, the build system will packages. If those packages are not installed, the build system will
...@@ -108,7 +107,7 @@ further info. ...@@ -108,7 +107,7 @@ further info.
Checking for Sphinx dependencies Checking for Sphinx dependencies
-------------------------------- --------------------------------
There's a script that automatically check for Sphinx dependencies. If it can There's a script that automatically checks for Sphinx dependencies. If it can
recognize your distribution, it will also give a hint about the install recognize your distribution, it will also give a hint about the install
command line options for your distro:: command line options for your distro::
...@@ -283,7 +282,7 @@ Here are some specific guidelines for the kernel documentation: ...@@ -283,7 +282,7 @@ Here are some specific guidelines for the kernel documentation:
from highlighting. For a short snippet of code embedded in the text, use \`\`. from highlighting. For a short snippet of code embedded in the text, use \`\`.
the C domain The C domain
------------ ------------
The **Sphinx C Domain** (name c) is suited for documentation of C API. E.g. a The **Sphinx C Domain** (name c) is suited for documentation of C API. E.g. a
......
...@@ -144,8 +144,8 @@ Bison ...@@ -144,8 +144,8 @@ Bison
Since Linux 4.16, the build system generates parsers Since Linux 4.16, the build system generates parsers
during build. This requires bison 2.0 or later. during build. This requires bison 2.0 or later.
pahole: pahole
------- ------
Since Linux 5.2, if CONFIG_DEBUG_INFO_BTF is selected, the build system Since Linux 5.2, if CONFIG_DEBUG_INFO_BTF is selected, the build system
generates BTF (BPF Type Format) from DWARF in vmlinux, a bit later from kernel generates BTF (BPF Type Format) from DWARF in vmlinux, a bit later from kernel
......
...@@ -351,8 +351,8 @@ Managing bug reports ...@@ -351,8 +351,8 @@ Managing bug reports
-------------------- --------------------
One of the best ways to put into practice your hacking skills is by fixing One of the best ways to put into practice your hacking skills is by fixing
bugs reported by other people. Not only you will help to make the kernel bugs reported by other people. Not only will you help to make the kernel
more stable, but you'll also learn to fix real world problems and you will more stable, but you'll also learn to fix real-world problems and you will
improve your skills, and other developers will be aware of your presence. improve your skills, and other developers will be aware of your presence.
Fixing bugs is one of the best ways to get merits among other developers, Fixing bugs is one of the best ways to get merits among other developers,
because not many people like wasting time fixing other people's bugs. because not many people like wasting time fixing other people's bugs.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment