git: 8ed580b1d381 - main - adjtime(2): document that delta can be NULL

From: Kyle Evans <kevans_at_FreeBSD.org>
Date: Sat, 20 Jun 2026 13:58:05 UTC
The branch main has been updated by kevans:

URL: https://cgit.FreeBSD.org/src/commit/?id=8ed580b1d3811e73e25db3d8a9fd235156c65387

commit 8ed580b1d3811e73e25db3d8a9fd235156c65387
Author:     Kyle Evans <kevans@FreeBSD.org>
AuthorDate: 2026-06-20 13:55:26 +0000
Commit:     Kyle Evans <kevans@FreeBSD.org>
CommitDate: 2026-06-20 13:57:45 +0000

    adjtime(2): document that delta can be NULL
    
    The current verbiage somewhat indicates that always adjusts the time,
    which hasn't been true as far back as I had the energy to `git blame`.
    
    Reviewed by:    imp
    Differential Revision:  https://reviews.freebsd.org/D57676
---
 lib/libsys/adjtime.2 | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/lib/libsys/adjtime.2 b/lib/libsys/adjtime.2
index ee8befe09ca9..ad2467d5ef61 100644
--- a/lib/libsys/adjtime.2
+++ b/lib/libsys/adjtime.2
@@ -25,7 +25,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd May 13, 2021
+.Dd June 19, 2026
 .Dt ADJTIME 2
 .Os
 .Sh NAME
@@ -46,6 +46,7 @@ makes small adjustments to the system time, as returned by
 advancing or retarding it
 by the time specified by the timeval
 .Fa delta .
+.Pp
 If
 .Fa delta
 is negative, the clock is
@@ -55,6 +56,13 @@ If
 .Fa delta
 is positive, a larger increment than normal
 is used.
+.Fa delta
+may also be a
+.Dv NULL
+pointer to fetch
+.Fa olddelta
+without making any adjustment.
+.Pp
 The skew used to perform the correction is generally a fraction of one percent.
 Thus, the time is always
 a monotonically increasing function.
@@ -65,7 +73,9 @@ may not be finished when
 is called again.
 If
 .Fa olddelta
-is not a null pointer,
+is not a
+.Dv NULL
+pointer,
 the structure pointed to will contain, upon return, the
 number of microseconds still to be corrected
 from the earlier call.