diff options
| -rw-r--r-- | lisp/calendar/calendar.el | 37 |
1 files changed, 19 insertions, 18 deletions
diff --git a/lisp/calendar/calendar.el b/lisp/calendar/calendar.el index 0e6450b671a..a1661e106f4 100644 --- a/lisp/calendar/calendar.el +++ b/lisp/calendar/calendar.el | |||
| @@ -226,7 +226,7 @@ and reentering it will cause these functions to be called again.") | |||
| 226 | This can be used, for example, to replace today's date with asterisks; a | 226 | This can be used, for example, to replace today's date with asterisks; a |
| 227 | function `calendar-star-date' is included for this purpose: | 227 | function `calendar-star-date' is included for this purpose: |
| 228 | (setq today-visible-calendar-hook 'calendar-star-date) | 228 | (setq today-visible-calendar-hook 'calendar-star-date) |
| 229 | It can also be used to mark the current date with calendar-today-marker; | 229 | It can also be used to mark the current date with `calendar-today-marker'; |
| 230 | a function is also provided for this: | 230 | a function is also provided for this: |
| 231 | (setq today-visible-calendar-hook 'calendar-mark-today) | 231 | (setq today-visible-calendar-hook 'calendar-mark-today) |
| 232 | 232 | ||
| @@ -285,9 +285,10 @@ instead, if you execute `european-calendar' when in the calendar, or set | |||
| 285 | To revert to the default American style from the European style, execute | 285 | To revert to the default American style from the European style, execute |
| 286 | `american-calendar' in the calendar. | 286 | `american-calendar' in the calendar. |
| 287 | 287 | ||
| 288 | A diary entry can be preceded by a diary-nonmarking-symbol (ordinarily `&') | 288 | A diary entry can be preceded by the character |
| 289 | to make that entry nonmarking--that is, it will not be marked on dates in | 289 | `diary-nonmarking-symbol' (ordinarily `&') to make that entry |
| 290 | the calendar window but will appear in a diary window. | 290 | nonmarking--that is, it will not be marked on dates in the calendar |
| 291 | window but will appear in a diary window. | ||
| 291 | 292 | ||
| 292 | Multiline diary entries are made by indenting lines after the first with | 293 | Multiline diary entries are made by indenting lines after the first with |
| 293 | either a TAB or one or more spaces. | 294 | either a TAB or one or more spaces. |
| @@ -397,7 +398,7 @@ characters with or without a period.") | |||
| 397 | (monthname " *" day ", *" year "[^0-9]") | 398 | (monthname " *" day ", *" year "[^0-9]") |
| 398 | (dayname "\\W")) | 399 | (dayname "\\W")) |
| 399 | "*List of pseudo-patterns describing the American patterns of date used. | 400 | "*List of pseudo-patterns describing the American patterns of date used. |
| 400 | See the documentation of diary-date-forms for an explanation.") | 401 | See the documentation of `diary-date-forms' for an explanation.") |
| 401 | 402 | ||
| 402 | ;;;###autoload | 403 | ;;;###autoload |
| 403 | (defvar european-date-diary-pattern | 404 | (defvar european-date-diary-pattern |
| @@ -407,7 +408,7 @@ See the documentation of diary-date-forms for an explanation.") | |||
| 407 | (day " *" monthname " *" year "[^0-9]") | 408 | (day " *" monthname " *" year "[^0-9]") |
| 408 | (dayname "\\W")) | 409 | (dayname "\\W")) |
| 409 | "*List of pseudo-patterns describing the European patterns of date used. | 410 | "*List of pseudo-patterns describing the European patterns of date used. |
| 410 | See the documentation of diary-date-forms for an explanation.") | 411 | See the documentation of `diary-date-forms' for an explanation.") |
| 411 | 412 | ||
| 412 | (defvar diary-date-forms | 413 | (defvar diary-date-forms |
| 413 | (if european-calendar-style | 414 | (if european-calendar-style |
| @@ -446,7 +447,7 @@ See the documentation of calendar-date-display-form for an explanation.") | |||
| 446 | (defvar american-calendar-display-form | 447 | (defvar american-calendar-display-form |
| 447 | '((if dayname (concat dayname ", ")) monthname " " day ", " year) | 448 | '((if dayname (concat dayname ", ")) monthname " " day ", " year) |
| 448 | "*Pseudo-pattern governing the way a date appears in the American style. | 449 | "*Pseudo-pattern governing the way a date appears in the American style. |
| 449 | See the documentation of calendar-date-display-form for an explanation.") | 450 | See the documentation of `calendar-date-display-form' for an explanation.") |
| 450 | 451 | ||
| 451 | (defvar calendar-date-display-form | 452 | (defvar calendar-date-display-form |
| 452 | (if european-calendar-style | 453 | (if european-calendar-style |
| @@ -504,7 +505,7 @@ It is to be used for diary entries that are not found in the diary file. | |||
| 504 | 505 | ||
| 505 | A function `include-other-diary-files' is provided for use as the value of | 506 | A function `include-other-diary-files' is provided for use as the value of |
| 506 | this hook. This function enables you to use shared diary files together | 507 | this hook. This function enables you to use shared diary files together |
| 507 | with your own. The files included are specified in the diary-file by lines | 508 | with your own. The files included are specified in the diary file by lines |
| 508 | of the form | 509 | of the form |
| 509 | 510 | ||
| 510 | #include \"filename\" | 511 | #include \"filename\" |
| @@ -513,7 +514,7 @@ This is recursive; that is, #include directives in files thus included are | |||
| 513 | obeyed. You can change the \"#include\" to some other string by changing | 514 | obeyed. You can change the \"#include\" to some other string by changing |
| 514 | the variable `diary-include-string'. When you use `include-other-diary-files' | 515 | the variable `diary-include-string'. When you use `include-other-diary-files' |
| 515 | as part of the list-diary-entries-hook, you will probably also want to use the | 516 | as part of the list-diary-entries-hook, you will probably also want to use the |
| 516 | function `mark-included-diary-files' as part of the mark-diary-entries-hook. | 517 | function `mark-included-diary-files' as part of `mark-diary-entries-hook'. |
| 517 | 518 | ||
| 518 | For example, you could use | 519 | For example, you could use |
| 519 | 520 | ||
| @@ -521,7 +522,7 @@ For example, you could use | |||
| 521 | '(include-other-diary-files sort-diary-entries)) | 522 | '(include-other-diary-files sort-diary-entries)) |
| 522 | (setq diary-display-hook 'fancy-diary-display) | 523 | (setq diary-display-hook 'fancy-diary-display) |
| 523 | 524 | ||
| 524 | in your .emacs file to cause the fancy diary buffer to be displayed with | 525 | in your `.emacs' file to cause the fancy diary buffer to be displayed with |
| 525 | diary entries from various included files, each day's entries sorted into | 526 | diary entries from various included files, each day's entries sorted into |
| 526 | lexicographic order.") | 527 | lexicographic order.") |
| 527 | 528 | ||
| @@ -567,14 +568,14 @@ describes the style of such diary entries.") | |||
| 567 | 568 | ||
| 568 | A function `mark-included-diary-files' is also provided for use as the | 569 | A function `mark-included-diary-files' is also provided for use as the |
| 569 | mark-diary-entries-hook; it enables you to use shared diary files together | 570 | mark-diary-entries-hook; it enables you to use shared diary files together |
| 570 | with your own. The files included are specified in the diary-file by lines | 571 | with your own. The files included are specified in the diary file by lines |
| 571 | of the form | 572 | of the form |
| 572 | #include \"filename\" | 573 | #include \"filename\" |
| 573 | This is recursive; that is, #include directives in files thus included are | 574 | This is recursive; that is, #include directives in files thus included are |
| 574 | obeyed. You can change the \"#include\" to some other string by changing the | 575 | obeyed. You can change the \"#include\" to some other string by changing the |
| 575 | variable `diary-include-string'. When you use `mark-included-diary-files' as | 576 | variable `diary-include-string'. When you use `mark-included-diary-files' as |
| 576 | part of the mark-diary-entries-hook, you will probably also want to use the | 577 | part of the mark-diary-entries-hook, you will probably also want to use the |
| 577 | function `include-other-diary-files' as part of the list-diary-entries-hook.") | 578 | function `include-other-diary-files' as part of `list-diary-entries-hook'.") |
| 578 | 579 | ||
| 579 | ;;;###autoload | 580 | ;;;###autoload |
| 580 | (defvar nongregorian-diary-marking-hook nil | 581 | (defvar nongregorian-diary-marking-hook nil |
| @@ -1185,7 +1186,7 @@ to be replaced by asterisks to highlight it whenever it is in the window." | |||
| 1185 | 1186 | ||
| 1186 | (autoload 'view-diary-entries "diary" | 1187 | (autoload 'view-diary-entries "diary" |
| 1187 | "Prepare and display a buffer with diary entries. | 1188 | "Prepare and display a buffer with diary entries. |
| 1188 | Searches the file diary-file for entries that match ARG days starting with | 1189 | Searches your diary file for entries that match ARG days starting with |
| 1189 | the date indicated by the cursor position in the displayed three-month | 1190 | the date indicated by the cursor position in the displayed three-month |
| 1190 | calendar." | 1191 | calendar." |
| 1191 | t) | 1192 | t) |
| @@ -1247,15 +1248,15 @@ calendar." | |||
| 1247 | t) | 1248 | t) |
| 1248 | 1249 | ||
| 1249 | (autoload 'show-all-diary-entries "diary" | 1250 | (autoload 'show-all-diary-entries "diary" |
| 1250 | "Show all of the diary entries in the diary-file. | 1251 | "Show all of the diary entries in the diary file. |
| 1251 | This function gets rid of the selective display of the diary-file so that | 1252 | This function gets rid of the selective display of the diary file so that |
| 1252 | all entries, not just some, are visible. If there is no diary buffer, one | 1253 | all entries, not just some, are visible. If there is no diary buffer, one |
| 1253 | is created." | 1254 | is created." |
| 1254 | t) | 1255 | t) |
| 1255 | 1256 | ||
| 1256 | (autoload 'mark-diary-entries "diary" | 1257 | (autoload 'mark-diary-entries "diary" |
| 1257 | "Mark days in the calendar window that have diary entries. | 1258 | "Mark days in the calendar window that have diary entries. |
| 1258 | Each entry in diary-file visible in the calendar window is marked." | 1259 | Each entry in diary file visible in the calendar window is marked." |
| 1259 | t) | 1260 | t) |
| 1260 | 1261 | ||
| 1261 | (autoload 'insert-diary-entry "diary-ins" | 1262 | (autoload 'insert-diary-entry "diary-ins" |
| @@ -1632,7 +1633,7 @@ The following commands control the diary: | |||
| 1632 | \\[view-diary-entries] display diary entries \\[show-all-diary-entries] show all diary entries | 1633 | \\[view-diary-entries] display diary entries \\[show-all-diary-entries] show all diary entries |
| 1633 | \\[print-diary-entries] print diary entries | 1634 | \\[print-diary-entries] print diary entries |
| 1634 | 1635 | ||
| 1635 | Displaying the diary entries causes the diary entries from the diary-file | 1636 | Displaying the diary entries causes the diary entries from the diary file |
| 1636 | \(for the date indicated by the cursor in the calendar window) to be | 1637 | \(for the date indicated by the cursor in the calendar window) to be |
| 1637 | displayed in another window. This function takes an integer argument that | 1638 | displayed in another window. This function takes an integer argument that |
| 1638 | specifies the number of days of calendar entries to be displayed, starting | 1639 | specifies the number of days of calendar entries to be displayed, starting |
| @@ -1646,7 +1647,7 @@ displayed, independently of the calendar. The number of days of entries is | |||
| 1646 | governed by number-of-diary-entries. | 1647 | governed by number-of-diary-entries. |
| 1647 | 1648 | ||
| 1648 | The format of the entries in the diary file is described in the | 1649 | The format of the entries in the diary file is described in the |
| 1649 | documentation string for the variable diary-file. | 1650 | documentation string for the variable `diary-file'. |
| 1650 | 1651 | ||
| 1651 | When diary entries are in view in the window, they can be edited. It is | 1652 | When diary entries are in view in the window, they can be edited. It is |
| 1652 | important to keep in mind that the buffer displayed contains the entire | 1653 | important to keep in mind that the buffer displayed contains the entire |