From: Edward M. Reingold <reingold@emr.cs.iit.edu>
Date: Tue, 25 Nov 1997 22:24:13 +0000 (+0000)
Subject: Describe diary-remind and diary-date.
X-Git-Tag: emacs-20.3~2718
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7f76473d5886fd609f43135454801365c38ff011;p=emacs.git

Describe diary-remind and diary-date.
---

diff --git a/lispref/calendar.texi b/lispref/calendar.texi
index 8e42a530f25..661e638fe7e 100644
--- a/lispref/calendar.texi
+++ b/lispref/calendar.texi
@@ -763,6 +763,44 @@ Renew medication (5th time)
 @noindent
 in the fancy diary display on September 8, 1990.
 
+  There is an early reminder diary sexp that includes its entry in the
+diary not only on the date of occurrence, but also on earlier dates.
+For example, if you want a reminder a week before your anniversary, you
+can use
+
+@findex diary-remind
+@smallexample
+%%(diary-remind '(diary-anniversary 12 22 1968) 7) Ruth & Ed's anniversary
+@end smallexample
+
+@noindent
+and your diary will show 
+@smallexample
+Ruth & Ed's anniversary
+@end smallexample
+@noindent
+both on December 15 and on December 22.
+
+@findex diary-date
+  The function @code{diary-date} applies to dates described by a month,
+day, year combination, each of which can be an integer, a list of
+integers, or @code{t}. The value @code{t} means all values.  For
+example,
+
+@smallexample
+%%(diary-date '(10 11 12) 22 t) Rake leaves
+@end smallexample
+
+@noindent
+causes your diary to show
+
+@smallexample
+Rake leaves
+@end smallexample
+
+@noindent
+on October 22, November 22, and December 22 of any year.
+
   The generality of sexp diary entries lets you specify any diary entry
 that you can describe algorithmically.  A sexp diary entry contains an
 expression that computes whether the entry applies to any given date.