From 4fd60b94b9a77e1983300f9fadd46f677bee567f Mon Sep 17 00:00:00 2001
From: Taeseung Sohn <paulsohn@outlook.kr>
Date: Fri, 1 Dec 2023 14:27:51 +0000
Subject: [PATCH] Clarify the exact behavior of RW1C setters

---
 src/macros.rs | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/macros.rs b/src/macros.rs
index 9fd12d6..c3dea31 100644
--- a/src/macros.rs
+++ b/src/macros.rs
@@ -113,18 +113,18 @@ macro_rules! rw1c_bit {
     ([$offset:literal]($bit:literal),$method:ident,$name:literal) => {
         bit_getter!([$offset]($bit), $method, $name);
         paste::paste! {
-            #[doc = "Clears the"]
+            #[doc = "Assigns 1 to the"]
             #[doc = $name]
-            #[doc = "bit."]
+            #[doc = "bit. On register write, this results in clearing the bit."]
             pub fn [<clear_ $method>](&mut self)->&mut Self{
                 use bit_field::BitField;
                 self.0[$offset].set_bit($bit,true);
                 self
             }
 
-            #[doc = "Set the "]
+            #[doc = "Assigns 0 to the"]
             #[doc = $name]
-            #[doc = " bit to 0, preventing the bit from being cleared on write."]
+            #[doc = "bit, preventing the bit from being cleared on write."]
             pub fn [<set_0_ $method>](&mut self) -> &mut Self {
                 use bit_field::BitField;
                 self.0[$offset].set_bit($bit,false);
@@ -135,18 +135,18 @@ macro_rules! rw1c_bit {
     ($bit:literal,$method:ident,$name:literal) => {
         bit_getter!($bit, $method, $name);
         paste::paste! {
-            #[doc = "Clears the"]
+            #[doc = "Assigns 1 to the"]
             #[doc = $name]
-            #[doc = "bit."]
+            #[doc = "bit. On register write, this results in clearing the bit."]
             pub fn [<clear_ $method>](&mut self)->&mut Self{
                 use bit_field::BitField;
                 self.0.set_bit($bit,true);
                 self
             }
 
-            #[doc = "Set the "]
+            #[doc = "Assigns 0 to the"]
             #[doc = $name]
-            #[doc = " bit to 0, preventing the bit from being cleared on write."]
+            #[doc = "bit, preventing the bit from being cleared on write."]
             pub fn [<set_0_ $method>](&mut self) -> &mut Self {
                 use bit_field::BitField;
                 self.0.set_bit($bit,false);