summaryrefslogtreecommitdiff
path: root/lisp/calendar/time-date.el
diff options
context:
space:
mode:
authorLars Ingebrigtsen <larsi@gnus.org>2021-10-12 21:55:26 +0200
committerLars Ingebrigtsen <larsi@gnus.org>2021-10-12 21:55:26 +0200
commit85edcf7af5d897fcc94ef1a0efb527c4b5e2bcc5 (patch)
treea5fd5d846454840f06ebcfa92db9237f5897640e /lisp/calendar/time-date.el
parent83195c57e6136a8efdeed243e9fffbc1da344f7a (diff)
downloademacs-85edcf7af5d897fcc94ef1a0efb527c4b5e2bcc5.tar.gz
decoded-time-add doc string addition
* lisp/calendar/time-date.el (decoded-time-add): Add a usage example.
Diffstat (limited to 'lisp/calendar/time-date.el')
-rw-r--r--lisp/calendar/time-date.el6
1 files changed, 5 insertions, 1 deletions
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