diff options
| -rw-r--r-- | man/calendar.texi | 78 |
1 files changed, 57 insertions, 21 deletions
diff --git a/man/calendar.texi b/man/calendar.texi index b48b1d547de..79f2624192d 100644 --- a/man/calendar.texi +++ b/man/calendar.texi | |||
| @@ -24,9 +24,11 @@ particular date; @kbd{Mouse-3} brings up a menu of commonly used | |||
| 24 | calendar features that are independent of any particular date. To exit | 24 | calendar features that are independent of any particular date. To exit |
| 25 | the calendar, type @kbd{q}. | 25 | the calendar, type @kbd{q}. |
| 26 | 26 | ||
| 27 | @iftex | ||
| 27 | This chapter describes the basic calendar features. | 28 | This chapter describes the basic calendar features. |
| 28 | @inforef{Advanced Calendar/Diary Usage,, emacs-xtra}, for information | 29 | @xref{Advanced Calendar/Diary Usage,,, emacs-xtra}, for information |
| 29 | about more specialized features. | 30 | about more specialized features. |
| 31 | @end iftex | ||
| 30 | 32 | ||
| 31 | @menu | 33 | @menu |
| 32 | * Calendar Motion:: Moving through the calendar; selecting a date. | 34 | * Calendar Motion:: Moving through the calendar; selecting a date. |
| @@ -43,6 +45,9 @@ about more specialized features. | |||
| 43 | * Importing Diary:: Converting diary events to/from other formats. | 45 | * Importing Diary:: Converting diary events to/from other formats. |
| 44 | * Daylight Savings:: How to specify when daylight savings time is active. | 46 | * Daylight Savings:: How to specify when daylight savings time is active. |
| 45 | * Time Intervals:: Keeping track of time intervals. | 47 | * Time Intervals:: Keeping track of time intervals. |
| 48 | @ifnottex | ||
| 49 | * Advanced Calendar/Diary Usage:: Advanced Calendar/Diary customization. | ||
| 50 | @end ifnottex | ||
| 46 | @end menu | 51 | @end menu |
| 47 | 52 | ||
| 48 | @node Calendar Motion | 53 | @node Calendar Motion |
| @@ -444,14 +449,19 @@ window. | |||
| 444 | To view the distribution of holidays for all the dates shown in the | 449 | To view the distribution of holidays for all the dates shown in the |
| 445 | calendar, use the @kbd{x} command. This displays the dates that are | 450 | calendar, use the @kbd{x} command. This displays the dates that are |
| 446 | holidays in a different face (or places a @samp{*} after these dates, if | 451 | holidays in a different face (or places a @samp{*} after these dates, if |
| 447 | display with multiple faces is not available). @inforef{Calendar | 452 | display with multiple faces is not available). |
| 448 | Customizing, calendar-holiday-marker, emacs-xtra}. The command applies | 453 | @iftex |
| 449 | both to the currently visible months and to other months that | 454 | @xref{Calendar Customizing, calendar-holiday-marker,, emacs-xtra}. |
| 450 | subsequently become visible by scrolling. To turn marking off and erase | 455 | @end iftex |
| 451 | the current marks, type @kbd{u}, which also erases any diary marks | 456 | @ifnottex |
| 452 | (@pxref{Diary}). If the variable @code{mark-holidays-in-calendar} is | 457 | @xref{Calendar Customizing, calendar-holiday-marker}. |
| 453 | non-@code{nil}, creating or updating the calendar marks holidays | 458 | @end ifnottex |
| 454 | automatically. | 459 | The command applies both to the currently visible months and to |
| 460 | other months that subsequently become visible by scrolling. To turn | ||
| 461 | marking off and erase the current marks, type @kbd{u}, which also | ||
| 462 | erases any diary marks (@pxref{Diary}). If the variable | ||
| 463 | @code{mark-holidays-in-calendar} is non-@code{nil}, creating or | ||
| 464 | updating the calendar marks holidays automatically. | ||
| 455 | 465 | ||
| 456 | @kindex a @r{(Calendar mode)} | 466 | @kindex a @r{(Calendar mode)} |
| 457 | @findex list-calendar-holidays | 467 | @findex list-calendar-holidays |
| @@ -1029,14 +1039,19 @@ current date is visible). | |||
| 1029 | To get a broader view of which days are mentioned in the diary, use | 1039 | To get a broader view of which days are mentioned in the diary, use |
| 1030 | the @kbd{m} command. This displays the dates that have diary entries in | 1040 | the @kbd{m} command. This displays the dates that have diary entries in |
| 1031 | a different face (or places a @samp{+} after these dates, if display | 1041 | a different face (or places a @samp{+} after these dates, if display |
| 1032 | with multiple faces is not available). @inforef{Calendar Customizing, | 1042 | with multiple faces is not available). |
| 1033 | diary-entry-marker, emacs-xtra}. The command applies both to the | 1043 | @iftex |
| 1034 | currently visible months and to other months that subsequently become | 1044 | @xref{Calendar Customizing, diary-entry-marker,, emacs-xtra}. |
| 1035 | visible by scrolling. To turn marking off and erase the current marks, | 1045 | @end iftex |
| 1036 | type @kbd{u}, which also turns off holiday marks (@pxref{Holidays}). | 1046 | @ifnottex |
| 1037 | If the variable @code{mark-diary-entries-in-calendar} is | 1047 | @xref{Calendar Customizing, diary-entry-marker}. |
| 1038 | non-@code{nil}, creating or updating the calendar marks diary dates | 1048 | @end ifnottex |
| 1039 | automatically. | 1049 | The command applies both to the currently visible months and to |
| 1050 | other months that subsequently become visible by scrolling. To turn | ||
| 1051 | marking off and erase the current marks, type @kbd{u}, which also | ||
| 1052 | turns off holiday marks (@pxref{Holidays}). If the variable | ||
| 1053 | @code{mark-diary-entries-in-calendar} is non-@code{nil}, creating or | ||
| 1054 | updating the calendar marks diary dates automatically. | ||
| 1040 | 1055 | ||
| 1041 | @kindex s @r{(Calendar mode)} | 1056 | @kindex s @r{(Calendar mode)} |
| 1042 | @findex show-all-diary-entries | 1057 | @findex show-all-diary-entries |
| @@ -1055,7 +1070,13 @@ can customize it like @code{lpr-region} (@pxref{Printing}). | |||
| 1055 | The command @kbd{M-x diary} displays the diary entries for the current | 1070 | The command @kbd{M-x diary} displays the diary entries for the current |
| 1056 | date, independently of the calendar display, and optionally for the next | 1071 | date, independently of the calendar display, and optionally for the next |
| 1057 | few days as well; the variable @code{number-of-diary-entries} specifies | 1072 | few days as well; the variable @code{number-of-diary-entries} specifies |
| 1058 | how many days to include. @inforef{Diary Customizing,, emacs-xtra}. | 1073 | how many days to include. |
| 1074 | @iftex | ||
| 1075 | @xref{Diary Customizing,,, emacs-xtra}. | ||
| 1076 | @end iftex | ||
| 1077 | @ifnottex | ||
| 1078 | @xref{Diary Customizing, number-of-diary-entries}. | ||
| 1079 | @end ifnottex | ||
| 1059 | 1080 | ||
| 1060 | If you put @code{(diary)} in your @file{.emacs} file, this | 1081 | If you put @code{(diary)} in your @file{.emacs} file, this |
| 1061 | automatically displays a window with the day's diary entries, when you | 1082 | automatically displays a window with the day's diary entries, when you |
| @@ -1360,7 +1381,12 @@ entry applies to all months of the year.@refill | |||
| 1360 | specifying the name of a face or a single-character string to use when | 1381 | specifying the name of a face or a single-character string to use when |
| 1361 | marking the entry in the calendar. Most generally, sexp diary entries | 1382 | marking the entry in the calendar. Most generally, sexp diary entries |
| 1362 | can perform arbitrary computations to determine when they apply. | 1383 | can perform arbitrary computations to determine when they apply. |
| 1363 | @inforef{Sexp Diary Entries,, emacs-xtra}. | 1384 | @iftex |
| 1385 | @xref{Sexp Diary Entries,,, emacs-xtra}. | ||
| 1386 | @end iftex | ||
| 1387 | @ifnottex | ||
| 1388 | @inforef{Sexp Diary Entries}. | ||
| 1389 | @end ifnottex | ||
| 1364 | 1390 | ||
| 1365 | @node Appointments | 1391 | @node Appointments |
| 1366 | @section Appointments | 1392 | @section Appointments |
| @@ -1479,8 +1505,14 @@ and adds the results to an Emacs diary file. For example: | |||
| 1479 | 1505 | ||
| 1480 | @noindent | 1506 | @noindent |
| 1481 | You can use an @code{#include} directive to add the import file contents | 1507 | You can use an @code{#include} directive to add the import file contents |
| 1482 | to the main diary file, if these are different files. @inforef{Fancy Diary | 1508 | to the main diary file, if these are different files. |
| 1483 | Display,, emacs-xtra}. | 1509 | @iftex |
| 1510 | @xref{Fancy Diary Display,,, emacs-xtra}. | ||
| 1511 | @end iftex | ||
| 1512 | @ifnottex | ||
| 1513 | @xref{Fancy Diary Display}. | ||
| 1514 | @end ifnottex | ||
| 1515 | |||
| 1484 | 1516 | ||
| 1485 | @findex icalendar-export-file, icalendar-export-region | 1517 | @findex icalendar-export-file, icalendar-export-region |
| 1486 | Use @code{icalendar-export-file} to interactively export an entire | 1518 | Use @code{icalendar-export-file} to interactively export an entire |
| @@ -1608,6 +1640,10 @@ you change the value of any of timeclock's customizable variables, you | |||
| 1608 | should run the command @kbd{M-x timeclock-reread-log} to update the | 1640 | should run the command @kbd{M-x timeclock-reread-log} to update the |
| 1609 | data in Emacs from the file. | 1641 | data in Emacs from the file. |
| 1610 | 1642 | ||
| 1643 | @ifnottex | ||
| 1644 | @include cal-xtra.texi | ||
| 1645 | @end ifnottex | ||
| 1646 | |||
| 1611 | @ignore | 1647 | @ignore |
| 1612 | arch-tag: 4531ef09-9df3-449d-9c52-2b5a4a337f92 | 1648 | arch-tag: 4531ef09-9df3-449d-9c52-2b5a4a337f92 |
| 1613 | @end ignore | 1649 | @end ignore |