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

Hridesh MG posted 4 patches 1 month, 1 week ago
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(-)
[PATCH v6 0/4] Clean up rustdocs and add new checkpatch checks
Posted by Hridesh MG 1 month, 1 week ago
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