aboutsummaryrefslogtreecommitdiff
path: root/rtic-time
diff options
context:
space:
mode:
Diffstat (limited to 'rtic-time')
-rw-r--r--rtic-time/src/lib.rs5
-rw-r--r--rtic-time/src/linked_list.rs7
-rw-r--r--rtic-time/src/monotonic.rs2
3 files changed, 9 insertions, 5 deletions
diff --git a/rtic-time/src/lib.rs b/rtic-time/src/lib.rs
index 1ed1e9d..f0135b7 100644
--- a/rtic-time/src/lib.rs
+++ b/rtic-time/src/lib.rs
@@ -1,4 +1,7 @@
-//! Crate
+//! Time-related traits & structs.
+//!
+//! This crate contains basic definitions and utilities that can be used
+//! to keep track of time.
#![no_std]
#![deny(missing_docs)]
diff --git a/rtic-time/src/linked_list.rs b/rtic-time/src/linked_list.rs
index c2a9967..b84b92d 100644
--- a/rtic-time/src/linked_list.rs
+++ b/rtic-time/src/linked_list.rs
@@ -1,11 +1,12 @@
-//! ...
-
use core::marker::PhantomPinned;
use core::pin::Pin;
use core::sync::atomic::{AtomicPtr, Ordering};
use critical_section as cs;
-/// A sorted linked list for the timer queue.
+/// An atomic sorted linked list for the timer queue.
+///
+/// Atomicity is guaranteed using very short [`critical_section`]s, so this list is _not_
+/// lock free, but it will not deadlock.
pub(crate) struct LinkedList<T> {
head: AtomicPtr<Link<T>>,
}
diff --git a/rtic-time/src/monotonic.rs b/rtic-time/src/monotonic.rs
index 513cc07..ad79bf2 100644
--- a/rtic-time/src/monotonic.rs
+++ b/rtic-time/src/monotonic.rs
@@ -1,4 +1,4 @@
-//! ...
+//! A monotonic clock / counter definition.
/// # A monotonic clock / counter definition.
///