From 26ab71043d97c1b06bdd252378b64171cb95b1a9 Mon Sep 17 00:00:00 2001
From: Christian Cunningham <cc@localhost>
Date: Fri, 19 Aug 2022 21:22:18 -0700
Subject: Updated docs

---
 src/_arch/arm/asm.rs | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

(limited to 'src/_arch/arm/asm.rs')

diff --git a/src/_arch/arm/asm.rs b/src/_arch/arm/asm.rs
index c1af5b4..5d53aa0 100644
--- a/src/_arch/arm/asm.rs
+++ b/src/_arch/arm/asm.rs
@@ -1,6 +1,10 @@
-//! Wrapping ARMv7-A Instructions
+//! # Wrapping ARMv7-A Instructions
+//!
+//! This provides bindings for assembly instructions
+//! to be used in other rust functions without `unsafe`
+//! markers everywhere.
 
-/// WFE
+/// # Wait for event
 #[inline(always)]
 pub fn wfe() {
     unsafe {
@@ -8,7 +12,7 @@ pub fn wfe() {
     }
 }
 
-/// NOP
+/// # No Operation
 #[inline(always)]
 pub fn nop() {
     unsafe {
@@ -16,7 +20,7 @@ pub fn nop() {
     }
 }
 
-/// Store u32 to address
+/// # Store u32 to memory address
 #[inline]
 pub fn store32(addr: u32, value: u32) {
 	unsafe {
@@ -24,7 +28,7 @@ pub fn store32(addr: u32, value: u32) {
 	}
 }
 
-/// Read u32 value from address
+/// # Read u32 from memory address
 #[inline]
 pub fn load32(addr: u32) -> u32 {
 	unsafe {
@@ -32,7 +36,7 @@ pub fn load32(addr: u32) -> u32 {
 	}
 }
 
-/// Wait for n cycles
+/// # Spin CPU for `n` cycles
 #[inline]
 pub fn spin_for_n_cycles(n: u32) {
 	unsafe {
-- 
cgit v1.2.1