Examples should aim to follow the usual conventions, which makes documentation more consistent with code and itself, and it should also help newcomers learn them more easily. Thus change the comments to follow them. Link: https://docs.kernel.org/rust/coding-guidelines.html#comments Signed-off-by: Miguel Ojeda --- rust/kernel/net/phy/reg.rs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/rust/kernel/net/phy/reg.rs b/rust/kernel/net/phy/reg.rs index 165bbff93e53..5a7b808915f9 100644 --- a/rust/kernel/net/phy/reg.rs +++ b/rust/kernel/net/phy/reg.rs @@ -36,9 +36,9 @@ pub trait Sealed {} /// # }, // /// # }; /// fn link_change_notify(dev: &mut Device) { -/// // read C22 BMCR register +/// // Read C22 BMCR register. /// dev.read(C22::BMCR); -/// // read C45 PMA/PMD control 1 register +/// // Read C45 PMA/PMD control 1 register. /// dev.read(C45::new(Mmd::PMAPMD, 0)); /// /// // Checks the link status as reported by registers in the C22 namespace -- 2.51.2