diff --git a/riscv/src/register/macros.rs b/riscv/src/register/macros.rs
index 24f880f9..48d18733 100644
--- a/riscv/src/register/macros.rs
+++ b/riscv/src/register/macros.rs
@@ -1,3 +1,9 @@
+/// `RV64`: Convenience macro to wrap the `csrrs` assembly instruction for reading a CSR register.
+///
+/// This macro should generally not be called directly.
+///
+/// Instead, use the [read_csr_as] or [read_csr_as_usize] macros.
+#[macro_export]
 macro_rules! read_csr {
     ($csr_number:literal) => {
         /// Reads the CSR
@@ -18,6 +24,12 @@ macro_rules! read_csr {
     };
 }
 
+/// `RV32`: Convenience macro to wrap the `csrrs` assembly instruction for reading a CSR register.
+///
+/// This macro should generally not be called directly.
+///
+/// Instead, use the [read_csr_as_rv32] or [read_csr_as_usize_rv32] macros.
+#[macro_export]
 macro_rules! read_csr_rv32 {
     ($csr_number:literal) => {
         /// Reads the CSR
@@ -38,9 +50,13 @@ macro_rules! read_csr_rv32 {
     };
 }
 
+/// `RV64`: Convenience macro to read a CSR register value as a `register` type.
+///
+/// The `register` type must be a defined type in scope of the macro call.
+#[macro_export]
 macro_rules! read_csr_as {
     ($register:ident, $csr_number:literal) => {
-        read_csr!($csr_number);
+        $crate::read_csr!($csr_number);
 
         /// Reads the CSR
         #[inline]
@@ -52,9 +68,13 @@ macro_rules! read_csr_as {
     };
 }
 
+/// `RV32`: Convenience macro to read a CSR register value as a `register` type.
+///
+/// The `register` type must be a defined type in scope of the macro call.
+#[macro_export]
 macro_rules! read_csr_as_rv32 {
     ($register:ident, $csr_number:literal) => {
-        read_csr_rv32!($csr_number);
+        $crate::read_csr_rv32!($csr_number);
 
         /// Reads the CSR
         #[inline]
@@ -66,9 +86,11 @@ macro_rules! read_csr_as_rv32 {
     };
 }
 
+/// `RV64`: Convenience macro to read a CSR register value as a [`usize`].
+#[macro_export]
 macro_rules! read_csr_as_usize {
     ($csr_number:literal) => {
-        read_csr!($csr_number);
+        $crate::read_csr!($csr_number);
 
         /// Reads the CSR
         #[inline]
@@ -78,9 +100,11 @@ macro_rules! read_csr_as_usize {
     };
 }
 
+/// `RV32`: Convenience macro to read a CSR register value as a [`usize`].
+#[macro_export]
 macro_rules! read_csr_as_usize_rv32 {
     ($csr_number:literal) => {
-        read_csr_rv32!($csr_number);
+        $crate::read_csr_rv32!($csr_number);
 
         /// Reads the CSR
         #[inline]
@@ -90,6 +114,12 @@ macro_rules! read_csr_as_usize_rv32 {
     };
 }
 
+/// `RV64`: Convenience macro to wrap the `csrrw` assembly instruction for writing to CSR registers.
+///
+/// This macro should generally not be called directly.
+///
+/// Instead, use the [write_csr_as_usize] macro.
+#[macro_export]
 macro_rules! write_csr {
     ($csr_number:literal) => {
         /// Writes the CSR
@@ -107,6 +137,12 @@ macro_rules! write_csr {
     };
 }
 
+/// `RV32`: Convenience macro to wrap the `csrrw` assembly instruction for writing to CSR registers.
+///
+/// This macro should generally not be called directly.
+///
+/// Instead, use the [write_csr_as_usize_rv32] macro.
+#[macro_export]
 macro_rules! write_csr_rv32 {
     ($csr_number:literal) => {
         /// Writes the CSR
@@ -124,9 +160,11 @@ macro_rules! write_csr_rv32 {
     };
 }
 
+/// `RV64`: Convenience macro to write a [`usize`] value to a CSR register.
+#[macro_export]
 macro_rules! write_csr_as_usize {
     ($csr_number:literal) => {
-        write_csr!($csr_number);
+        $crate::write_csr!($csr_number);
 
         /// Writes the CSR
         #[inline]
@@ -136,9 +174,11 @@ macro_rules! write_csr_as_usize {
     };
 }
 
+/// `RV32`: Convenience macro to write a [`usize`] value to a CSR register.
+#[macro_export]
 macro_rules! write_csr_as_usize_rv32 {
     ($csr_number:literal) => {
-        write_csr_rv32!($csr_number);
+        $crate::write_csr_rv32!($csr_number);
 
         /// Writes the CSR
         #[inline]
@@ -148,6 +188,12 @@ macro_rules! write_csr_as_usize_rv32 {
     };
 }
 
+/// `RV64`: Convenience macro around the `csrrs` assembly instruction to set the CSR register.
+///
+/// This macro should generally not be called directly.
+///
+/// Instead, use the [set_csr] or [set_clear_csr] macros.
+#[macro_export]
 macro_rules! set {
     ($csr_number:literal) => {
         /// Set the CSR
@@ -165,6 +211,12 @@ macro_rules! set {
     };
 }
 
+/// `RV32`: Convenience macro around the `csrrs` assembly instruction to set the CSR register.
+///
+/// This macro should generally not be called directly.
+///
+/// Instead, use the [set_csr] or [set_clear_csr] macros.
+#[macro_export]
 macro_rules! set_rv32 {
     ($csr_number:literal) => {
         /// Set the CSR
@@ -182,6 +234,12 @@ macro_rules! set_rv32 {
     };
 }
 
+/// `RV64`: Convenience macro around the `csrrc` assembly instruction to clear the CSR register.
+///
+/// This macro should generally not be called directly.
+///
+/// Instead, use the [clear_csr] or [set_clear_csr] macros.
+#[macro_export]
 macro_rules! clear {
     ($csr_number:literal) => {
         /// Clear the CSR
@@ -199,6 +257,12 @@ macro_rules! clear {
     };
 }
 
+/// `RV32`: Convenience macro around the `csrrc` assembly instruction to clear the CSR register.
+///
+/// This macro should generally not be called directly.
+///
+/// Instead, use the [clear_csr_rv32] macro.
+#[macro_export]
 macro_rules! clear_rv32 {
     ($csr_number:literal) => {
         /// Clear the CSR
@@ -216,6 +280,8 @@ macro_rules! clear_rv32 {
     };
 }
 
+/// Convenience macro to define field setter functions for a CSR type.
+#[macro_export]
 macro_rules! set_csr {
     ($(#[$attr:meta])*, $set_field:ident, $e:expr) => {
         $(#[$attr])*
@@ -226,6 +292,8 @@ macro_rules! set_csr {
     };
 }
 
+/// Convenience macro to define field clear functions for a CSR type.
+#[macro_export]
 macro_rules! clear_csr {
     ($(#[$attr:meta])*, $clear_field:ident, $e:expr) => {
         $(#[$attr])*
@@ -236,13 +304,20 @@ macro_rules! clear_csr {
     };
 }
 
+/// Convenience macro to define field setter and clear functions for a CSR type.
+#[macro_export]
 macro_rules! set_clear_csr {
     ($(#[$attr:meta])*, $set_field:ident, $clear_field:ident, $e:expr) => {
-        set_csr!($(#[$attr])*, $set_field, $e);
-        clear_csr!($(#[$attr])*, $clear_field, $e);
+        $crate::set_csr!($(#[$attr])*, $set_field, $e);
+        $crate::clear_csr!($(#[$attr])*, $clear_field, $e);
     }
 }
 
+/// Convenience macro to read a composite value from a CSR register.
+///
+/// - `RV32`: reads 32-bits from `hi` and 32-bits from `lo` to create a 64-bit value
+/// - `RV64`: reads a 64-bit value from `lo`
+#[macro_export]
 macro_rules! read_composite_csr {
     ($hi:expr, $lo:expr) => {
         /// Reads the CSR as a 64-bit value