Clean up the rustdocs as suggested by two issues[1][2]. The first issue
is to convert all rustdoc headers to plural in order to maintain
consistency and avoid situations where further additions to the doc
could render the grammar incorrect. The second issue aims to remove
consecutive empty rustdoc lines.
Also add two new checks (patches 2 and 4) to checkpatch to detect any
future occurrences of the above two issues and optionally fix them using
--fix.
This patchset is a merger of two different patchsets [3] and [4] with a
few improvements made on top of them which are listed on their
individual changelogs.
[1]: https://github.com/Rust-for-Linux/linux/issues/1110
[2]: https://github.com/Rust-for-Linux/linux/issues/1109
[3]: https://lore.kernel.org/rust-for-linux/20241002022749.390836-1-paddymills@proton.me/
[4]: https://lore.kernel.org/rust-for-linux/dbb63b5698aa507bbe3dec54b4458a3f151899d3.1727606659.git.hridesh699@gmail.com/
Hridesh MG (2):
rust: kernel: clean up empty `///` lines
checkpatch: warn on empty rust doc comments
Patrick Miller (2):
rust: make section names plural
checkpatch: warn on known non-plural rust doc headers
rust/kernel/block/mq/request.rs | 1 -
rust/kernel/init.rs | 2 +-
rust/kernel/list/arc.rs | 2 +-
rust/kernel/rbtree.rs | 1 -
rust/kernel/sync/arc.rs | 2 +-
rust/macros/lib.rs | 2 +-
scripts/checkpatch.pl | 22 ++++++++++++++++++++++
7 files changed, 26 insertions(+), 6 deletions(-)
--
2.46.1