7.2.1 Diary

If you use Emacs's diary feature, Planner-Diary could be helpful for you. It puts all diary entries for the current day in the ‘* Diary’ section of your day plan page. This section is updated every time you display the file in Emacs. By default the diary section of past pages is not updated; it's pretty unlikely that you want to add new diary entries for the past. (see Diary)

If you want to use planner-diary.el, make sure the file is in your load path and add this to your .emacs (or _emacs):

     (require 'planner-diary)

planner-diary.el needs fancy-diary-display. To use fancy-diary-display, add this to your .emacs (or _emacs):

     (add-hook 'diary-display-hook 'fancy-diary-display)

You can use Planner-Diary in two different ways:

1. If you want the saved files to contain your entries and not just a line of Lisp, add the following lines to your .emacs (or _emacs):

             (setq planner-diary-use-diary t)
             (planner-diary-insinuate)
   

   You should also customize or set planner-day-page-template to include a ‘* Diary’:

             (setq planner-day-page-template
              "* Tasks\n\n\n* Schedule\n\n\n* Diary\n\n\n* Notes")
   

   C-c C-e updates the diary sections. C-u C-c C-e forces an update—it inserts the diary section for the day, even if the day is in the past or if there is no ‘Diary’ section in the buffer.

2. (GNU EMACS ONLY) You can put the following line of Lisp code in your day plan pages to display your diary entries:

             <lisp>(planner-diary-entries-here)</lisp>
   

   You can do this automatically for all day plan pages:

             (setq planner-day-page-template
               "* Tasks\n\n\n* Diary\n\n<lisp>(planner-diary-entries-here)</lisp>
             \n* Notes")
   

   When you open a day plan page outside Emacs, you will see the line of Lisp code and not your diary entries.

If you want to see your diary entries for more than just one day, set planner-diary-number-of-days accordingly. This works for either of the two approaches.

These diary sections are only intended for display. Editing them will not affect your diary file. If you want to add entries to your diary, you should use the usual Emacs diary and calendar methods for doing that, or call planner-diary-add-entry.

If you want to use the Cal-Desk package, simply follow the instructions in cal-desk.el. If you get the Cal-Desk layout from the Calendar buffer, you get it in the day plan buffer, too.

If you use Planner-Diary, you might consider using the Calendar support of Planner. (see Calendar/Diary) To get Calendar integration, add this to your .emacs (or _emacs):

     (planner-insinuate-calendar)

If planner-diary-create-section-flag is non-nil, sections are always inserted if necessary.

If you want to import Planner entries into your Diary file, the planner2diary.py script will accomplish this for you. To use it, execute planner2diary.py on the command line, specifying your planner directory as the first and only argument.

Options

By default, planner-diary lists only the appointments you have on that day. If you want the date headers included even when showing the diary entries for a single day, set planner-diary-include-all-output to non-nil.

Functions

planner-diary.el defines the following interactive functions:

Keys

planner-diary.el adds the following keybinding to Planner, if planner-diary-insinuate is in your .emacs (or _emacs):

• C-c C-e updates the diary sections by calling planner-diary-insert-all-diaries-maybe.

• Planner-Diary Advanced Features