diff options
| author | Xue Fuqiao | 2013-07-31 19:38:13 +0800 |
|---|---|---|
| committer | Xue Fuqiao | 2013-07-31 19:38:13 +0800 |
| commit | 65b36413e6b448ae689ff7477e7d2d45ef60c76a (patch) | |
| tree | 2b3d9792a8c1ee6be2cc1c2593ea4c3f934b8c3f | |
| parent | 6c8a6e149b41085639df186e063df2875b76cbdb (diff) | |
| download | emacs-65b36413e6b448ae689ff7477e7d2d45ef60c76a.tar.gz emacs-65b36413e6b448ae689ff7477e7d2d45ef60c76a.zip | |
Move the documentation of Mayan calendar to cal-xtra.texi.
* doc/emacs/cal-xtra.texi (Advanced Calendar/Diary Usage): Update menu.
(Mayan Calendar): Move here from calendar.texi.
* doc/emacs/emacs.texi (Top): Update menu.
| -rw-r--r-- | doc/emacs/ChangeLog | 6 | ||||
| -rw-r--r-- | doc/emacs/cal-xtra.texi | 94 | ||||
| -rw-r--r-- | doc/emacs/calendar.texi | 88 | ||||
| -rw-r--r-- | doc/emacs/emacs.texi | 2 |
4 files changed, 101 insertions, 89 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index f134bd03ef9..b8d78425cae 100644 --- a/doc/emacs/ChangeLog +++ b/doc/emacs/ChangeLog | |||
| @@ -1,3 +1,9 @@ | |||
| 1 | 2013-07-31 Xue Fuqiao <xfq.free@gmail.com> | ||
| 2 | |||
| 3 | * cal-xtra.texi (Advanced Calendar/Diary Usage): Update menu. | ||
| 4 | (Mayan Calendar): Move here from calendar.texi. | ||
| 5 | * emacs.texi (Top): Update menu. | ||
| 6 | |||
| 1 | 2013-07-30 Xue Fuqiao <xfq.free@gmail.com> | 7 | 2013-07-30 Xue Fuqiao <xfq.free@gmail.com> |
| 2 | 8 | ||
| 3 | * emacs.texi (Top): Add menu entry. | 9 | * emacs.texi (Top): Add menu entry. |
diff --git a/doc/emacs/cal-xtra.texi b/doc/emacs/cal-xtra.texi index 1b182327d33..5c964bbb369 100644 --- a/doc/emacs/cal-xtra.texi +++ b/doc/emacs/cal-xtra.texi | |||
| @@ -17,6 +17,7 @@ your personal tastes. | |||
| 17 | @menu | 17 | @menu |
| 18 | * Calendar Customizing:: Calendar layout and hooks. | 18 | * Calendar Customizing:: Calendar layout and hooks. |
| 19 | * Holiday Customizing:: Defining your own holidays. | 19 | * Holiday Customizing:: Defining your own holidays. |
| 20 | * Mayan Calendar:: Moving to a date specified in a Mayan calendar. | ||
| 20 | * Date Display Format:: Changing the format. | 21 | * Date Display Format:: Changing the format. |
| 21 | * Time Display Format:: Changing the format. | 22 | * Time Display Format:: Changing the format. |
| 22 | * Diary Customizing:: Defaults you can set. | 23 | * Diary Customizing:: Defaults you can set. |
| @@ -260,6 +261,99 @@ visible in the calendar window, with descriptive strings, like this: | |||
| 260 | (((6 4 2012) "Lunar Eclipse") ((11 13 2012) "Solar Eclipse") ... ) | 261 | (((6 4 2012) "Lunar Eclipse") ((11 13 2012) "Solar Eclipse") ... ) |
| 261 | @end smallexample | 262 | @end smallexample |
| 262 | 263 | ||
| 264 | @node Mayan Calendar | ||
| 265 | @subsection Converting from the Mayan Calendar | ||
| 266 | @cindex Mayan calendar | ||
| 267 | |||
| 268 | Here are the commands to select dates based on the Mayan calendar: | ||
| 269 | |||
| 270 | @table @kbd | ||
| 271 | @item g m l | ||
| 272 | Move to a date specified by the long count calendar | ||
| 273 | (@code{calendar-mayan-goto-long-count-date}). | ||
| 274 | @item g m n t | ||
| 275 | Move to the next occurrence of a place in the | ||
| 276 | tzolkin calendar (@code{calendar-mayan-next-tzolkin-date}). | ||
| 277 | @item g m p t | ||
| 278 | Move to the previous occurrence of a place in the | ||
| 279 | tzolkin calendar (@code{calendar-mayan-previous-tzolkin-date}). | ||
| 280 | @item g m n h | ||
| 281 | Move to the next occurrence of a place in the | ||
| 282 | haab calendar (@code{calendar-mayan-next-haab-date}). | ||
| 283 | @item g m p h | ||
| 284 | Move to the previous occurrence of a place in the | ||
| 285 | haab calendar (@code{calendar-mayan-previous-haab-date}). | ||
| 286 | @item g m n c | ||
| 287 | Move to the next occurrence of a place in the | ||
| 288 | calendar round (@code{calendar-mayan-next-calendar-round-date}). | ||
| 289 | @item g m p c | ||
| 290 | Move to the previous occurrence of a place in the | ||
| 291 | calendar round (@code{calendar-mayan-previous-calendar-round-date}). | ||
| 292 | @end table | ||
| 293 | |||
| 294 | @cindex Mayan long count | ||
| 295 | To understand these commands, you need to understand the Mayan calendars. | ||
| 296 | The @dfn{long count} is a counting of days with these units: | ||
| 297 | |||
| 298 | @display | ||
| 299 | 1 kin = 1 day@ @ @ 1 uinal = 20 kin@ @ @ 1 tun = 18 uinal | ||
| 300 | 1 katun = 20 tun@ @ @ 1 baktun = 20 katun | ||
| 301 | @end display | ||
| 302 | |||
| 303 | @kindex g m @r{(Calendar mode)} | ||
| 304 | @findex calendar-mayan-goto-long-count-date | ||
| 305 | @noindent | ||
| 306 | Thus, the long count date 12.16.11.16.6 means 12 baktun, 16 katun, 11 | ||
| 307 | tun, 16 uinal, and 6 kin. The Emacs calendar can handle Mayan long | ||
| 308 | count dates as early as 7.17.18.13.3, but no earlier. When you use the | ||
| 309 | @kbd{g m l} command, type the Mayan long count date with the baktun, | ||
| 310 | katun, tun, uinal, and kin separated by periods. | ||
| 311 | |||
| 312 | @findex calendar-mayan-previous-tzolkin-date | ||
| 313 | @findex calendar-mayan-next-tzolkin-date | ||
| 314 | @cindex Mayan tzolkin calendar | ||
| 315 | The Mayan tzolkin calendar is a cycle of 260 days formed by a pair of | ||
| 316 | independent cycles of 13 and 20 days. Since this cycle repeats | ||
| 317 | endlessly, Emacs provides commands to move backward and forward to the | ||
| 318 | previous or next point in the cycle. Type @kbd{g m p t} to go to the | ||
| 319 | previous tzolkin date; Emacs asks you for a tzolkin date and moves point | ||
| 320 | to the previous occurrence of that date. Similarly, type @kbd{g m n t} | ||
| 321 | to go to the next occurrence of a tzolkin date. | ||
| 322 | |||
| 323 | @findex calendar-mayan-previous-haab-date | ||
| 324 | @findex calendar-mayan-next-haab-date | ||
| 325 | @cindex Mayan haab calendar | ||
| 326 | The Mayan haab calendar is a cycle of 365 days arranged as 18 months | ||
| 327 | of 20 days each, followed by a 5-day monthless period. Like the tzolkin | ||
| 328 | cycle, this cycle repeats endlessly, and there are commands to move | ||
| 329 | backward and forward to the previous or next point in the cycle. Type | ||
| 330 | @kbd{g m p h} to go to the previous haab date; Emacs asks you for a haab | ||
| 331 | date and moves point to the previous occurrence of that date. | ||
| 332 | Similarly, type @kbd{g m n h} to go to the next occurrence of a haab | ||
| 333 | date. | ||
| 334 | |||
| 335 | @c This is omitted because it is too long for smallbook format. | ||
| 336 | @c @findex calendar-mayan-previous-calendar-round-date | ||
| 337 | @findex calendar-mayan-next-calendar-round-date | ||
| 338 | @cindex Mayan calendar round | ||
| 339 | The Maya also used the combination of the tzolkin date and the haab | ||
| 340 | date. This combination is a cycle of about 52 years called a | ||
| 341 | @emph{calendar round}. If you type @kbd{g m p c}, Emacs asks you for | ||
| 342 | both a haab and a tzolkin date and then moves point to the previous | ||
| 343 | occurrence of that combination. Use @kbd{g m n c} to move point to the | ||
| 344 | next occurrence of a combination. These commands signal an error if the | ||
| 345 | haab/tzolkin date combination you have typed is impossible. | ||
| 346 | |||
| 347 | Emacs uses strict completion | ||
| 348 | @iftex | ||
| 349 | (@pxref{Completion Exit,,, emacs, the Emacs Manual}) | ||
| 350 | @end iftex | ||
| 351 | @ifnottex | ||
| 352 | (@pxref{Completion Exit}) | ||
| 353 | @end ifnottex | ||
| 354 | whenever it asks you to type a Mayan name, so you don't have to worry | ||
| 355 | about spelling. | ||
| 356 | |||
| 263 | @node Date Display Format | 357 | @node Date Display Format |
| 264 | @subsection Date Display Format | 358 | @subsection Date Display Format |
| 265 | @vindex calendar-date-display-form | 359 | @vindex calendar-date-display-form |
diff --git a/doc/emacs/calendar.texi b/doc/emacs/calendar.texi index 075d753ae7a..88f46984207 100644 --- a/doc/emacs/calendar.texi +++ b/doc/emacs/calendar.texi | |||
| @@ -678,7 +678,6 @@ and from several other calendars. | |||
| 678 | (aside from Gregorian). | 678 | (aside from Gregorian). |
| 679 | * To Other Calendar:: Converting the selected date to various calendars. | 679 | * To Other Calendar:: Converting the selected date to various calendars. |
| 680 | * From Other Calendar:: Moving to a date specified in another calendar. | 680 | * From Other Calendar:: Moving to a date specified in another calendar. |
| 681 | * Mayan Calendar:: Moving to a date specified in a Mayan calendar. | ||
| 682 | @end menu | 681 | @end menu |
| 683 | 682 | ||
| 684 | @c FIXME perhaps most of the details should be moved to cal-xtra. | 683 | @c FIXME perhaps most of the details should be moved to cal-xtra. |
| @@ -913,93 +912,6 @@ years for the date given by point. If you are not in the calendar, | |||
| 913 | this command first asks you for the date of death and the range of | 912 | this command first asks you for the date of death and the range of |
| 914 | years, and then displays the list of yahrzeit dates. | 913 | years, and then displays the list of yahrzeit dates. |
| 915 | 914 | ||
| 916 | @c FIXME move to emacs-xtra. | ||
| 917 | @node Mayan Calendar | ||
| 918 | @subsection Converting from the Mayan Calendar | ||
| 919 | |||
| 920 | Here are the commands to select dates based on the Mayan calendar: | ||
| 921 | |||
| 922 | @table @kbd | ||
| 923 | @item g m l | ||
| 924 | Move to a date specified by the long count calendar | ||
| 925 | (@code{calendar-mayan-goto-long-count-date}). | ||
| 926 | @item g m n t | ||
| 927 | Move to the next occurrence of a place in the | ||
| 928 | tzolkin calendar (@code{calendar-mayan-next-tzolkin-date}). | ||
| 929 | @item g m p t | ||
| 930 | Move to the previous occurrence of a place in the | ||
| 931 | tzolkin calendar (@code{calendar-mayan-previous-tzolkin-date}). | ||
| 932 | @item g m n h | ||
| 933 | Move to the next occurrence of a place in the | ||
| 934 | haab calendar (@code{calendar-mayan-next-haab-date}). | ||
| 935 | @item g m p h | ||
| 936 | Move to the previous occurrence of a place in the | ||
| 937 | haab calendar (@code{calendar-mayan-previous-haab-date}). | ||
| 938 | @item g m n c | ||
| 939 | Move to the next occurrence of a place in the | ||
| 940 | calendar round (@code{calendar-mayan-next-calendar-round-date}). | ||
| 941 | @item g m p c | ||
| 942 | Move to the previous occurrence of a place in the | ||
| 943 | calendar round (@code{calendar-mayan-previous-calendar-round-date}). | ||
| 944 | @end table | ||
| 945 | |||
| 946 | @cindex Mayan long count | ||
| 947 | To understand these commands, you need to understand the Mayan calendars. | ||
| 948 | The @dfn{long count} is a counting of days with these units: | ||
| 949 | |||
| 950 | @display | ||
| 951 | 1 kin = 1 day@ @ @ 1 uinal = 20 kin@ @ @ 1 tun = 18 uinal | ||
| 952 | 1 katun = 20 tun@ @ @ 1 baktun = 20 katun | ||
| 953 | @end display | ||
| 954 | |||
| 955 | @kindex g m @r{(Calendar mode)} | ||
| 956 | @findex calendar-mayan-goto-long-count-date | ||
| 957 | @noindent | ||
| 958 | Thus, the long count date 12.16.11.16.6 means 12 baktun, 16 katun, 11 | ||
| 959 | tun, 16 uinal, and 6 kin. The Emacs calendar can handle Mayan long | ||
| 960 | count dates as early as 7.17.18.13.3, but no earlier. When you use the | ||
| 961 | @kbd{g m l} command, type the Mayan long count date with the baktun, | ||
| 962 | katun, tun, uinal, and kin separated by periods. | ||
| 963 | |||
| 964 | @findex calendar-mayan-previous-tzolkin-date | ||
| 965 | @findex calendar-mayan-next-tzolkin-date | ||
| 966 | @cindex Mayan tzolkin calendar | ||
| 967 | The Mayan tzolkin calendar is a cycle of 260 days formed by a pair of | ||
| 968 | independent cycles of 13 and 20 days. Since this cycle repeats | ||
| 969 | endlessly, Emacs provides commands to move backward and forward to the | ||
| 970 | previous or next point in the cycle. Type @kbd{g m p t} to go to the | ||
| 971 | previous tzolkin date; Emacs asks you for a tzolkin date and moves point | ||
| 972 | to the previous occurrence of that date. Similarly, type @kbd{g m n t} | ||
| 973 | to go to the next occurrence of a tzolkin date. | ||
| 974 | |||
| 975 | @findex calendar-mayan-previous-haab-date | ||
| 976 | @findex calendar-mayan-next-haab-date | ||
| 977 | @cindex Mayan haab calendar | ||
| 978 | The Mayan haab calendar is a cycle of 365 days arranged as 18 months | ||
| 979 | of 20 days each, followed by a 5-day monthless period. Like the tzolkin | ||
| 980 | cycle, this cycle repeats endlessly, and there are commands to move | ||
| 981 | backward and forward to the previous or next point in the cycle. Type | ||
| 982 | @kbd{g m p h} to go to the previous haab date; Emacs asks you for a haab | ||
| 983 | date and moves point to the previous occurrence of that date. | ||
| 984 | Similarly, type @kbd{g m n h} to go to the next occurrence of a haab | ||
| 985 | date. | ||
| 986 | |||
| 987 | @c This is omitted because it is too long for smallbook format. | ||
| 988 | @c @findex calendar-mayan-previous-calendar-round-date | ||
| 989 | @findex calendar-mayan-next-calendar-round-date | ||
| 990 | @cindex Mayan calendar round | ||
| 991 | The Maya also used the combination of the tzolkin date and the haab | ||
| 992 | date. This combination is a cycle of about 52 years called a | ||
| 993 | @emph{calendar round}. If you type @kbd{g m p c}, Emacs asks you for | ||
| 994 | both a haab and a tzolkin date and then moves point to the previous | ||
| 995 | occurrence of that combination. Use @kbd{g m n c} to move point to the | ||
| 996 | next occurrence of a combination. These commands signal an error if the | ||
| 997 | haab/tzolkin date combination you have typed is impossible. | ||
| 998 | |||
| 999 | Emacs uses strict completion (@pxref{Completion Exit}) whenever it | ||
| 1000 | asks you to type a Mayan name, so you don't have to worry about | ||
| 1001 | spelling. | ||
| 1002 | |||
| 1003 | @node Diary | 915 | @node Diary |
| 1004 | @section The Diary | 916 | @section The Diary |
| 1005 | @cindex diary | 917 | @cindex diary |
diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi index 85171fcaa5a..16c54e1b9aa 100644 --- a/doc/emacs/emacs.texi +++ b/doc/emacs/emacs.texi | |||
| @@ -957,7 +957,6 @@ Conversion To and From Other Calendars | |||
| 957 | (aside from Gregorian). | 957 | (aside from Gregorian). |
| 958 | * To Other Calendar:: Converting the selected date to various calendars. | 958 | * To Other Calendar:: Converting the selected date to various calendars. |
| 959 | * From Other Calendar:: Moving to a date specified in another calendar. | 959 | * From Other Calendar:: Moving to a date specified in another calendar. |
| 960 | * Mayan Calendar:: Moving to a date specified in a Mayan calendar. | ||
| 961 | 960 | ||
| 962 | The Diary | 961 | The Diary |
| 963 | 962 | ||
| @@ -972,6 +971,7 @@ More advanced features of the Calendar and Diary | |||
| 972 | 971 | ||
| 973 | * Calendar Customizing:: Calendar layout and hooks. | 972 | * Calendar Customizing:: Calendar layout and hooks. |
| 974 | * Holiday Customizing:: Defining your own holidays. | 973 | * Holiday Customizing:: Defining your own holidays. |
| 974 | * Mayan Calendar:: Moving to a date specified in a Mayan calendar. | ||
| 975 | * Date Display Format:: Changing the format. | 975 | * Date Display Format:: Changing the format. |
| 976 | * Time Display Format:: Changing the format. | 976 | * Time Display Format:: Changing the format. |
| 977 | * Diary Customizing:: Defaults you can set. | 977 | * Diary Customizing:: Defaults you can set. |