summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/emacs/calendar.texi14
-rw-r--r--etc/NEWS3
-rw-r--r--lisp/calendar/calendar.el3
3 files changed, 12 insertions, 8 deletions
diff --git a/doc/emacs/calendar.texi b/doc/emacs/calendar.texi
index 03a484b338d..93671364a88 100644
--- a/doc/emacs/calendar.texi
+++ b/doc/emacs/calendar.texi
@@ -925,8 +925,9 @@ events for today, for the immediate future, or for any specified
date.
The name of the diary file is specified by the variable
-@code{diary-file}; @file{~/diary} is the default. Here's an example
-showing what that file looks like:
+@code{diary-file}. The default is @file{~/.emacs.d/diary}, though for
+compatibility with older versions Emacs will use @file{~/diary} if it
+exists. Here's an example showing what the file looks like:
@example
12/22/2012 Twentieth wedding anniversary!!
@@ -1068,11 +1069,10 @@ diary-mail-entries}. A prefix argument specifies how many days
@vindex diary-file
Your @dfn{diary file} is a file that records events associated with
particular dates. The name of the diary file is specified by the
-variable @code{diary-file}; @file{~/diary} is the default. The
-@code{calendar} utility program supports a subset of the format allowed
-by the Emacs diary facilities, so you can use that utility to view the
-diary file, with reasonable results aside from the entries it cannot
-understand.
+variable @code{diary-file}. The @code{calendar} utility program
+supports a subset of the format allowed by the Emacs diary facilities,
+so you can use that utility to view the diary file, with reasonable
+results aside from the entries it cannot understand.
Each entry in the diary file describes one event and consists of one
or more lines. An entry always begins with a date specification at the
diff --git a/etc/NEWS b/etc/NEWS
index 76b477244e3..cdfd748805a 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -504,6 +504,9 @@ hash-table and arrays. All functions are prefixed with "map-".
** Calendar and diary
+++
+*** The default `diary-file' is now located in .emacs.d.
+
++++
*** New commands to insert diary entries with Chinese dates:
`diary-chinese-insert-anniversary-entry' `diary-chinese-insert-entry'
`diary-chinese-insert-monthly-entry', `diary-chinese-insert-yearly-entry'.
diff --git a/lisp/calendar/calendar.el b/lisp/calendar/calendar.el
index 233d2cfcd22..fd2580e385e 100644
--- a/lisp/calendar/calendar.el
+++ b/lisp/calendar/calendar.el
@@ -566,7 +566,7 @@ See also `calendar-intermonth-header'."
'font-lock-face 'font-lock-function-name-face)))
:version "23.1")
-(defcustom diary-file "~/diary"
+(defcustom diary-file (locate-user-emacs-file "diary" "diary")
"Name of the file in which one's personal diary of dates is kept.
The file's entries are lines beginning with any of the forms
@@ -653,6 +653,7 @@ documentation of these hooks for details.
Diary files can contain directives to include the contents of other files; for
details, see the documentation for the variable `diary-list-entries-hook'."
+ :version "25.1" ; ~/diary -> locate-user-emacs-file
:type 'file
:group 'diary)