comparison man/calendar.texi @ 70446:31e2bfedd75e

(Calendar/Diary, Holidays, Displaying the Diary) (Displaying the Diary, Special Diary Entries, Importing Diary): Replace inforef to emacs-xtra by conditional xref's, depending on @iftex/@ifnottex. (Calendar/Diary) [ifnottex]: Add menu item for "Advanced Calendar/Diary Usage". (Time Intervals) [ifnottex]: @include cal-xtra.texi.

70445:e8ca81ffe2d5

  @kbd{Mouse-2} in the calendar brings up a menu of operations on a
particular date; @kbd{Mouse-3} brings up a menu of commonly used
calendar features that are independent of any particular date.  To exit
the calendar, type @kbd{q}.

  This chapter describes the basic calendar features.
@inforef{Advanced Calendar/Diary Usage,, emacs-xtra}, for information
about more specialized features.

@menu
* Calendar Motion::     Moving through the calendar; selecting a date.
* Scroll Calendar::     Bringing earlier or later months onto the screen.
* Counting Days::       How many days are there between two dates?

* Diary::               Displaying events from your diary.
* Appointments::	Reminders when it's time to do something.
* Importing Diary::     Converting diary events to/from other formats.
* Daylight Savings::    How to specify when daylight savings time is active.
* Time Intervals::      Keeping track of time intervals.
@end menu

@node Calendar Motion
@section Movement in the Calendar

@findex calendar-unmark
@vindex mark-holidays-in-calendar
  To view the distribution of holidays for all the dates shown in the
calendar, use the @kbd{x} command.  This displays the dates that are
holidays in a different face (or places a @samp{*} after these dates, if
display with multiple faces is not available).  @inforef{Calendar
Customizing, calendar-holiday-marker, emacs-xtra}.  The command applies
both to the currently visible months and to other months that
subsequently become visible by scrolling.  To turn marking off and erase
the current marks, type @kbd{u}, which also erases any diary marks
(@pxref{Diary}).  If the variable @code{mark-holidays-in-calendar} is
non-@code{nil}, creating or updating the calendar marks holidays
automatically.

@kindex a @r{(Calendar mode)}
@findex list-calendar-holidays
  To get even more detailed information, use the @kbd{a} command, which
displays a separate buffer containing a list of all holidays in the

@findex mark-diary-entries
@vindex mark-diary-entries-in-calendar
  To get a broader view of which days are mentioned in the diary, use
the @kbd{m} command.  This displays the dates that have diary entries in
a different face (or places a @samp{+} after these dates, if display
with multiple faces is not available).  @inforef{Calendar Customizing,
diary-entry-marker, emacs-xtra}.  The command applies both to the
currently visible months and to other months that subsequently become
visible by scrolling.  To turn marking off and erase the current marks,
type @kbd{u}, which also turns off holiday marks (@pxref{Holidays}).
If the variable @code{mark-diary-entries-in-calendar} is
non-@code{nil}, creating or updating the calendar marks diary dates
automatically.

@kindex s @r{(Calendar mode)}
@findex show-all-diary-entries
  To see the full diary file, rather than just some of the entries, use
the @kbd{s} command.

@findex diary
  The command @kbd{M-x diary} displays the diary entries for the current
date, independently of the calendar display, and optionally for the next
few days as well; the variable @code{number-of-diary-entries} specifies
how many days to include.  @inforef{Diary Customizing,, emacs-xtra}.

  If you put @code{(diary)} in your @file{.emacs} file, this
automatically displays a window with the day's diary entries, when you
enter Emacs.  The mode line of the displayed window shows the date and
any holidays that fall on that date.

  Each of the standard sexp diary entries takes an optional parameter
specifying the name of a face or a single-character string to use when
marking the entry in the calendar.  Most generally, sexp diary entries
can perform arbitrary computations to determine when they apply.
@inforef{Sexp Diary Entries,, emacs-xtra}.

@node Appointments
@section Appointments
@cindex appointment notification

(icalendar-import-file "/here/is/calendar.ics" "/there/goes/ical-diary")
@end example

@noindent
You can use an @code{#include} directive to add the import file contents
to the main diary file, if these are different files.  @inforef{Fancy Diary
Display,, emacs-xtra}.

@findex icalendar-export-file, icalendar-export-region
  Use @code{icalendar-export-file} to interactively export an entire
Emacs diary file to iCalendar format.  To export only a part of a diary
file, mark the relevant area, and call @code{icalendar-export-region}.

@code{timeclock-file}.  If you edit the timeclock file manually, or if
you change the value of any of timeclock's customizable variables, you
should run the command @kbd{M-x timeclock-reread-log} to update the
data in Emacs from the file.

@ignore
   arch-tag: 4531ef09-9df3-449d-9c52-2b5a4a337f92
@end ignore

70446:31e2bfedd75e

  @kbd{Mouse-2} in the calendar brings up a menu of operations on a
particular date; @kbd{Mouse-3} brings up a menu of commonly used
calendar features that are independent of any particular date.  To exit
the calendar, type @kbd{q}.

@iftex
  This chapter describes the basic calendar features.
@xref{Advanced Calendar/Diary Usage,,, emacs-xtra}, for information
about more specialized features.
@end iftex

@menu
* Calendar Motion::     Moving through the calendar; selecting a date.
* Scroll Calendar::     Bringing earlier or later months onto the screen.
* Counting Days::       How many days are there between two dates?

* Diary::               Displaying events from your diary.
* Appointments::	Reminders when it's time to do something.
* Importing Diary::     Converting diary events to/from other formats.
* Daylight Savings::    How to specify when daylight savings time is active.
* Time Intervals::      Keeping track of time intervals.
@ifnottex
* Advanced Calendar/Diary Usage:: Advanced Calendar/Diary customization.
@end ifnottex
@end menu

@node Calendar Motion
@section Movement in the Calendar

@findex calendar-unmark
@vindex mark-holidays-in-calendar
  To view the distribution of holidays for all the dates shown in the
calendar, use the @kbd{x} command.  This displays the dates that are
holidays in a different face (or places a @samp{*} after these dates, if
display with multiple faces is not available).
@iftex
@xref{Calendar Customizing, calendar-holiday-marker,, emacs-xtra}.
@end iftex
@ifnottex
@xref{Calendar Customizing, calendar-holiday-marker}.
@end ifnottex
  The command applies both to the currently visible months and to
other months that subsequently become visible by scrolling.  To turn
marking off and erase the current marks, type @kbd{u}, which also
erases any diary marks (@pxref{Diary}).  If the variable
@code{mark-holidays-in-calendar} is non-@code{nil}, creating or
updating the calendar marks holidays automatically.

@kindex a @r{(Calendar mode)}
@findex list-calendar-holidays
  To get even more detailed information, use the @kbd{a} command, which
displays a separate buffer containing a list of all holidays in the

@findex mark-diary-entries
@vindex mark-diary-entries-in-calendar
  To get a broader view of which days are mentioned in the diary, use
the @kbd{m} command.  This displays the dates that have diary entries in
a different face (or places a @samp{+} after these dates, if display
with multiple faces is not available).
@iftex
@xref{Calendar Customizing, diary-entry-marker,, emacs-xtra}.
@end iftex
@ifnottex
@xref{Calendar Customizing, diary-entry-marker}.
@end ifnottex
  The command applies both to the currently visible months and to
other months that subsequently become visible by scrolling.  To turn
marking off and erase the current marks, type @kbd{u}, which also
turns off holiday marks (@pxref{Holidays}).  If the variable
@code{mark-diary-entries-in-calendar} is non-@code{nil}, creating or
updating the calendar marks diary dates automatically.

@kindex s @r{(Calendar mode)}
@findex show-all-diary-entries
  To see the full diary file, rather than just some of the entries, use
the @kbd{s} command.

@findex diary
  The command @kbd{M-x diary} displays the diary entries for the current
date, independently of the calendar display, and optionally for the next
few days as well; the variable @code{number-of-diary-entries} specifies
how many days to include.
@iftex
@xref{Diary Customizing,,, emacs-xtra}.
@end iftex
@ifnottex
@xref{Diary Customizing, number-of-diary-entries}.
@end ifnottex

  If you put @code{(diary)} in your @file{.emacs} file, this
automatically displays a window with the day's diary entries, when you
enter Emacs.  The mode line of the displayed window shows the date and
any holidays that fall on that date.

  Each of the standard sexp diary entries takes an optional parameter
specifying the name of a face or a single-character string to use when
marking the entry in the calendar.  Most generally, sexp diary entries
can perform arbitrary computations to determine when they apply.
@iftex
@xref{Sexp Diary Entries,,, emacs-xtra}.
@end iftex
@ifnottex
@inforef{Sexp Diary Entries}.
@end ifnottex

@node Appointments
@section Appointments
@cindex appointment notification

(icalendar-import-file "/here/is/calendar.ics" "/there/goes/ical-diary")
@end example

@noindent
You can use an @code{#include} directive to add the import file contents
to the main diary file, if these are different files.
@iftex
@xref{Fancy Diary Display,,, emacs-xtra}.
@end iftex
@ifnottex
@xref{Fancy Diary Display}.
@end ifnottex


@findex icalendar-export-file, icalendar-export-region
  Use @code{icalendar-export-file} to interactively export an entire
Emacs diary file to iCalendar format.  To export only a part of a diary
file, mark the relevant area, and call @code{icalendar-export-region}.

@code{timeclock-file}.  If you edit the timeclock file manually, or if
you change the value of any of timeclock's customizable variables, you
should run the command @kbd{M-x timeclock-reread-log} to update the
data in Emacs from the file.

@ifnottex
@include cal-xtra.texi
@end ifnottex

@ignore
   arch-tag: 4531ef09-9df3-449d-9c52-2b5a4a337f92
@end ignore