From 6ebbc2f69825e9fdc5a5658047469ad541cf3dce Mon Sep 17 00:00:00 2001 From: Glenn Morris Date: Mon, 15 Jun 2015 20:46:01 -0400 Subject: [PATCH] * lisp/calendar/calendar.el (diary-file): Use locate-user-emacs-file. * doc/emacs/calendar.texi (Diary, Format of Diary File): Update for above diary-file change. : * etc/NEWS: Mention this. --- doc/emacs/calendar.texi | 14 +++++++------- etc/NEWS | 3 +++ lisp/calendar/calendar.el | 3 ++- 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 @@ -503,6 +503,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' 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) -- 2.39.2