comparison man/calendar.texi @ 60294:8c6bb7dbf4fb

From Matt Hodges <[e-mail]>: (General Calendar): Document binding of scroll-other-window-down. (Mayan Calendar): Fix earliest date. (Time Intervals): Document timeclock-change. Fix timeclock-ask-before-exiting documentation.

60293:7b3bc20cd4d8

@item p d
Display day-in-year (@code{calendar-print-day-of-year}).
@item C-c C-l
Regenerate the calendar window (@code{redraw-calendar}).
@item SPC
Scroll the next window (@code{scroll-other-window}).
@item q
Exit from calendar (@code{exit-calendar}).
@end table

@kindex p d @r{(Calendar mode)}

(@code{redraw-calendar}) to redraw it.  (This can only happen if you use
non-Calendar-mode editing commands.)

@kindex SPC @r{(Calendar mode)}
  In Calendar mode, you can use @kbd{SPC} (@code{scroll-other-window})
to scroll the other window.  This is handy when you display a list of
holidays or diary entries in another window.

@kindex q @r{(Calendar mode)}
@findex exit-calendar
  To exit from the calendar, type @kbd{q} (@code{exit-calendar}).  This
buries all buffers related to the calendar, selecting other buffers.

@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
current three-month range.  You can use @key{SPC} in the calendar window
to scroll that list.

@findex holidays
  The command @kbd{M-x holidays} displays the list of holidays for the
current month and the preceding and succeeding months; this works even
if you don't have a calendar window.  If you want the list of holidays

@kindex g m @r{(Calendar mode)}
@findex calendar-goto-mayan-long-count-date
@noindent
Thus, the long count date 12.16.11.16.6 means 12 baktun, 16 katun, 11
tun, 16 uinal, and 6 kin.  The Emacs calendar can handle Mayan long
count dates as early as 7.17.18.13.1, but no earlier.  When you use the
@kbd{g m l} command, type the Mayan long count date with the baktun,
katun, tun, uinal, and kin separated by periods.

@findex calendar-previous-tzolkin-date
@findex calendar-next-tzolkin-date

  The timeclock feature adds up time intervals, so you can (for
instance) keep track of how much time you spend working.

@findex timeclock-in
@findex timeclock-out
@findex timeclock-workday-remaining
@findex timeclock-when-to-leave
  Use the @kbd{M-x timeclock-in} command when you start working on a
project, and @kbd{M-x timeclock-out} command when you're done.  Each
time you do this, it adds one time interval to the record of the project.

  Once you've collected data from a number of time intervals, you can use
@kbd{M-x timeclock-workday-remaining} to see how much time is left to
work today (assuming a typical average of 8 hours a day), and @kbd{M-x
timeclock-when-to-leave} which will calculate when you're ``done.''

workday in the mode line, either customize the
@code{timeclock-modeline-display} variable and set its value to
@code{t}, or invoke the @kbd{M-x timeclock-modeline-display} command.

@vindex timeclock-ask-before-exiting
  Terminating the current Emacs session might or might not mean that
you have stopped working on the project.  If you'd like Emacs to ask
you about this, set the value of the variable
@code{timeclock-ask-before-exiting} to @code{t} (via @kbd{M-x
customize}).  By default, only an explicit @kbd{M-x timeclock-out}
tells Emacs that the current interval is over.

@cindex @file{.timelog} file
@vindex timeclock-file
@findex timeclock-reread-log
  The timeclock functions work by accumulating the data in a file

60294:8c6bb7dbf4fb

@item p d
Display day-in-year (@code{calendar-print-day-of-year}).
@item C-c C-l
Regenerate the calendar window (@code{redraw-calendar}).
@item SPC
Scroll the next window up (@code{scroll-other-window}).
@item DEL
Scroll the next window down (@code{scroll-other-window-down}).
@item q
Exit from calendar (@code{exit-calendar}).
@end table

@kindex p d @r{(Calendar mode)}

(@code{redraw-calendar}) to redraw it.  (This can only happen if you use
non-Calendar-mode editing commands.)

@kindex SPC @r{(Calendar mode)}
  In Calendar mode, you can use @kbd{SPC} (@code{scroll-other-window})
and @kbd{DEL} (@code{scroll-other-window-down}) to scroll the other
window up or down, respectively.  This is handy when you display a list
of holidays or diary entries in another window.

@kindex q @r{(Calendar mode)}
@findex exit-calendar
  To exit from the calendar, type @kbd{q} (@code{exit-calendar}).  This
buries all buffers related to the calendar, selecting other buffers.

@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
current three-month range.  You can use @key{SPC} and @key{DEL} in the
calendar window to scroll that list up and down, respectively.

@findex holidays
  The command @kbd{M-x holidays} displays the list of holidays for the
current month and the preceding and succeeding months; this works even
if you don't have a calendar window.  If you want the list of holidays

@kindex g m @r{(Calendar mode)}
@findex calendar-goto-mayan-long-count-date
@noindent
Thus, the long count date 12.16.11.16.6 means 12 baktun, 16 katun, 11
tun, 16 uinal, and 6 kin.  The Emacs calendar can handle Mayan long
count dates as early as 7.17.18.13.3, but no earlier.  When you use the
@kbd{g m l} command, type the Mayan long count date with the baktun,
katun, tun, uinal, and kin separated by periods.

@findex calendar-previous-tzolkin-date
@findex calendar-next-tzolkin-date

  The timeclock feature adds up time intervals, so you can (for
instance) keep track of how much time you spend working.

@findex timeclock-in
@findex timeclock-out
@findex timeclock-change
@findex timeclock-workday-remaining
@findex timeclock-when-to-leave
  Use the @kbd{M-x timeclock-in} command when you start working on a
project, and @kbd{M-x timeclock-out} command when you're done.  Each
time you do this, it adds one time interval to the record of the
project.  You can change to working on a different project with @kbd{M-x
timeclock-change}.

  Once you've collected data from a number of time intervals, you can use
@kbd{M-x timeclock-workday-remaining} to see how much time is left to
work today (assuming a typical average of 8 hours a day), and @kbd{M-x
timeclock-when-to-leave} which will calculate when you're ``done.''

workday in the mode line, either customize the
@code{timeclock-modeline-display} variable and set its value to
@code{t}, or invoke the @kbd{M-x timeclock-modeline-display} command.

@vindex timeclock-ask-before-exiting
  Terminating the current Emacs session might or might not mean that you
have stopped working on the project and, by default, Emacs queries this.
You can, however, set the value of the variable
@code{timeclock-ask-before-exiting} to @code{nil} (via @kbd{M-x
customize}) to avoid this behaviour; then, only an explicit @kbd{M-x
timeclock-out} or @kbd{M-x timeclock-change} will tell Emacs that the
current interval is over.

@cindex @file{.timelog} file
@vindex timeclock-file
@findex timeclock-reread-log
  The timeclock functions work by accumulating the data in a file