From 85edcf7af5d897fcc94ef1a0efb527c4b5e2bcc5 Mon Sep 17 00:00:00 2001 From: Lars Ingebrigtsen Date: Tue, 12 Oct 2021 21:55:26 +0200 Subject: [PATCH] decoded-time-add doc string addition * lisp/calendar/time-date.el (decoded-time-add): Add a usage example. --- lisp/calendar/time-date.el | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/lisp/calendar/time-date.el b/lisp/calendar/time-date.el index 0aa38166bc1..155c34927fd 100644 --- a/lisp/calendar/time-date.el +++ b/lisp/calendar/time-date.el @@ -406,7 +406,11 @@ entries only for the values that should be altered. For instance, if you want to \"add two months\" to TIME, then leave all other fields but the month field in DELTA nil, and make -the month field 2. The values in DELTA can be negative. +the month field 2. For instance: + + (decoded-time-add (decode-time) (make-decoded-time :month 2)) + +The values in DELTA can be negative. If applying a month/year delta leaves the time spec invalid, it is decreased to be valid (\"add one month\" to January 31st 2019 -- 2.39.5