From 8615cbffe27c223230785502939ae14498f673ae Mon Sep 17 00:00:00 2001 From: Russ Cox Date: Fri, 3 Nov 2017 19:17:43 -0400 Subject: [PATCH] time: fix Time package doc paragraph order Introduce the presence of the monotonic time reading first, before the paragraph about comparison that mentions it multiple times. Change-Id: I91e31e118be013eee6c258163a1bb2cb42501527 Reviewed-on: https://go-review.googlesource.com/76010 Run-TryBot: Russ Cox TryBot-Result: Gobot Gobot Reviewed-by: Brad Fitzpatrick Reviewed-by: Ian Lance Taylor --- src/time/time.go | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/src/time/time.go b/src/time/time.go index 0f29b0ff93..46c61371b0 100644 --- a/src/time/time.go +++ b/src/time/time.go @@ -98,6 +98,11 @@ import "errors" // change the instant in time being denoted and therefore does not affect the // computations described in earlier paragraphs. // +// In addition to the required “wall clock” reading, a Time may contain an optional +// reading of the current process's monotonic clock, to provide additional precision +// for comparison or subtraction. +// See the “Monotonic Clocks” section in the package documentation for details. +// // Note that the Go == operator compares not just the time instant but also the // Location and the monotonic clock reading. Therefore, Time values should not // be used as map or database keys without first guaranteeing that the @@ -108,11 +113,6 @@ import "errors" // correctly handles the case when only one of its arguments has a monotonic // clock reading. // -// In addition to the required “wall clock” reading, a Time may contain an optional -// reading of the current process's monotonic clock, to provide additional precision -// for comparison or subtraction. -// See the “Monotonic Clocks” section in the package documentation for details. -// type Time struct { // wall and ext encode the wall time seconds, wall time nanoseconds, // and optional monotonic clock reading in nanoseconds. -- 2.48.1