aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGlenn Morris2008-03-27 07:28:24 +0000
committerGlenn Morris2008-03-27 07:28:24 +0000
commit739d627a477191703f57ca4cfbd1bf8dc25625f9 (patch)
treec50d75d7898546f5b52845c8593b254c61e4d722
parent566f5ae682c23d64d78b5942cef6398fd54ee1f9 (diff)
downloademacs-739d627a477191703f57ca4cfbd1bf8dc25625f9.tar.gz
emacs-739d627a477191703f57ca4cfbd1bf8dc25625f9.zip
(diary-file): Doc fix.
-rw-r--r--lisp/ChangeLog2
-rw-r--r--lisp/calendar/calendar.el35
2 files changed, 15 insertions, 22 deletions
diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 5fab3c006b0..e16e2ab8efe 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -9,6 +9,8 @@
9 * calendar/cal-hebrew.el (list-hebrew-diary-entries): 9 * calendar/cal-hebrew.el (list-hebrew-diary-entries):
10 * calendar/cal-islam.el (list-islamic-diary-entries): Doc fix. 10 * calendar/cal-islam.el (list-islamic-diary-entries): Doc fix.
11 11
12 * calendar/calendar.el (diary-file): Doc fix.
13
12 * calendar/diary-lib.el (diary-face-attrs): Fix `height' regexp. 14 * calendar/diary-lib.el (diary-face-attrs): Fix `height' regexp.
13 (list-diary-entries-hook, mark-diary-entries-hook) 15 (list-diary-entries-hook, mark-diary-entries-hook)
14 (include-other-diary-files, mark-included-diary-files): Doc fixes. 16 (include-other-diary-files, mark-included-diary-files): Doc fixes.
diff --git a/lisp/calendar/calendar.el b/lisp/calendar/calendar.el
index 15e576fbcda..022eb1befce 100644
--- a/lisp/calendar/calendar.el
+++ b/lisp/calendar/calendar.el
@@ -330,7 +330,8 @@ redisplays the diary for whatever date the cursor is moved to."
330 "Name of the file in which one's personal diary of dates is kept. 330 "Name of the file in which one's personal diary of dates is kept.
331 331
332The file's entries are lines beginning with any of the forms 332The file's entries are lines beginning with any of the forms
333specified by the variable `american-date-diary-pattern', by default: 333specified by the variable `diary-date-forms', which by default
334uses the forms of `american-date-diary-pattern':
334 335
335 MONTH/DAY 336 MONTH/DAY
336 MONTH/DAY/YEAR 337 MONTH/DAY/YEAR
@@ -343,14 +344,13 @@ that date. MONTH and DAY are one or two digit numbers, YEAR is a
343number and may be written in full or abbreviated to the final two 344number and may be written in full or abbreviated to the final two
344digits (if `abbreviated-calendar-year' is non-nil). MONTHNAME 345digits (if `abbreviated-calendar-year' is non-nil). MONTHNAME
345and DAYNAME can be spelled in full (as specified by the variables 346and DAYNAME can be spelled in full (as specified by the variables
346`calendar-month-name-array' and `calendar-day-name-array'), 347`calendar-month-name-array' and `calendar-day-name-array'), or
347abbreviated (as specified by `calendar-month-abbrev-array' and 348abbreviated (as specified by `calendar-month-abbrev-array' and
348`calendar-day-abbrev-array') with or without a period, 349`calendar-day-abbrev-array') with or without a period. Case is
349capitalized or not. Any of DAY, MONTH, or MONTHNAME, YEAR can be 350ignored. Any of DAY, MONTH, or MONTHNAME, YEAR can be `*' which
350`*' which matches any day, month, or year, respectively. If the 351matches any day, month, or year, respectively. If the date does
351date does not contain a year, it is generic and applies to any 352not contain a year, it is generic and applies to any year. A
352year. A DAYNAME entry applies to the appropriate day of the week 353DAYNAME entry applies to the appropriate day of the week in every week.
353in every week.
354 354
355The European style (in which the day precedes the month) can be 355The European style (in which the day precedes the month) can be
356used instead, if you execute `european-calendar' when in the 356used instead, if you execute `european-calendar' when in the
@@ -366,10 +366,9 @@ file. The European forms (see `european-date-diary-pattern') are
366To revert to the default American style from the European style, execute 366To revert to the default American style from the European style, execute
367`american-calendar' in the calendar. 367`american-calendar' in the calendar.
368 368
369A diary entry can be preceded by the character 369A diary entry can be preceded by the character `diary-nonmarking-symbol'
370`diary-nonmarking-symbol' (ordinarily `&') to make that entry 370\(ordinarily `&') to make that entry nonmarking--that is, it will not be
371nonmarking--that is, it will not be marked on dates in the calendar 371marked on dates in the calendar window but will appear in a diary window.
372window but will appear in a diary window.
373 372
374Multiline diary entries are made by indenting lines after the first with 373Multiline diary entries are made by indenting lines after the first with
375either a TAB or one or more spaces. 374either a TAB or one or more spaces.
@@ -411,16 +410,8 @@ Diary entries can be based on Lisp sexps. For example, the diary entry
411 %%(diary-block 11 1 1990 11 10 1990) Vacation 410 %%(diary-block 11 1 1990 11 10 1990) Vacation
412 411
413causes the diary entry \"Vacation\" to appear from November 1 through 412causes the diary entry \"Vacation\" to appear from November 1 through
414November 10, 1990. Other functions available are `diary-float', 413November 10, 1990. See the documentation for the function
415`diary-anniversary', `diary-cyclic', `diary-day-of-year', 414`list-sexp-diary-entries' for more details.
416`diary-iso-date', `diary-french-date', `diary-hebrew-date',
417`diary-islamic-date', `diary-bahai-date', `diary-mayan-date',
418`diary-chinese-date', `diary-coptic-date', `diary-ethiopic-date',
419`diary-persian-date', `diary-yahrzeit', `diary-sunrise-sunset',
420`diary-phases-of-moon', `diary-parasha', `diary-omer',
421`diary-rosh-hodesh', and `diary-sabbath-candles'. See the
422documentation for the function `list-sexp-diary-entries' for more
423details.
424 415
425Diary entries based on the Hebrew, the Islamic and/or the Baha'i 416Diary entries based on the Hebrew, the Islamic and/or the Baha'i
426calendar are also possible, but because these are somewhat slow, they 417calendar are also possible, but because these are somewhat slow, they