[PATCH v6 0/4] Clean up rustdocs and add new checkpatch checks

From: Hridesh MG
Date: Tue Oct 15 2024 - 11:52:10 EST


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@xxxxxxxxx/
[4]: https://lore.kernel.org/rust-for-linux/dbb63b5698aa507bbe3dec54b4458a3f151899d3.1727606659.git.hridesh699@xxxxxxxxx/

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