diff --git a/src/libstd/time/mod.rs b/src/libstd/time/mod.rs index 6ee867fd0da..f885733c2d1 100644 --- a/src/libstd/time/mod.rs +++ b/src/libstd/time/mod.rs @@ -22,8 +22,8 @@ pub use self::duration::Duration; mod duration; -/// A measurement of a monotonically increasing clock, -/// only meaningful within one process. +/// A measurement of a monotonically increasing clock. +/// Opaque and useful only with `Duration`. /// /// Instants are always guaranteed to be greater than any previously measured /// instant when created, and are often useful for tasks such as measuring @@ -43,8 +43,8 @@ mod duration; #[unstable(feature = "time2", reason = "recently added", issue = "29866")] pub struct Instant(time::Instant); -/// A measurement of the system clock appropriate for timestamps meaningful -/// outside one process, such as those on files on the filesystem. +/// A measurement of the system clock, useful for talking to +/// external entities like the file system or other processes. /// /// Distinct from the `Instant` type, this time measurement **is not /// monotonic**. This means that you can save a file to the file system, then