aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorXue Fuqiao2013-07-31 19:38:13 +0800
committerXue Fuqiao2013-07-31 19:38:13 +0800
commit65b36413e6b448ae689ff7477e7d2d45ef60c76a (patch)
tree2b3d9792a8c1ee6be2cc1c2593ea4c3f934b8c3f
parent6c8a6e149b41085639df186e063df2875b76cbdb (diff)
downloademacs-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/ChangeLog6
-rw-r--r--doc/emacs/cal-xtra.texi94
-rw-r--r--doc/emacs/calendar.texi88
-rw-r--r--doc/emacs/emacs.texi2
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 @@
12013-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
12013-07-30 Xue Fuqiao <xfq.free@gmail.com> 72013-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
272Move to a date specified by the long count calendar
273(@code{calendar-mayan-goto-long-count-date}).
274@item g m n t
275Move to the next occurrence of a place in the
276tzolkin calendar (@code{calendar-mayan-next-tzolkin-date}).
277@item g m p t
278Move to the previous occurrence of a place in the
279tzolkin calendar (@code{calendar-mayan-previous-tzolkin-date}).
280@item g m n h
281Move to the next occurrence of a place in the
282haab calendar (@code{calendar-mayan-next-haab-date}).
283@item g m p h
284Move to the previous occurrence of a place in the
285haab calendar (@code{calendar-mayan-previous-haab-date}).
286@item g m n c
287Move to the next occurrence of a place in the
288calendar round (@code{calendar-mayan-next-calendar-round-date}).
289@item g m p c
290Move to the previous occurrence of a place in the
291calendar 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.
296The @dfn{long count} is a counting of days with these units:
297
298@display
2991 kin = 1 day@ @ @ 1 uinal = 20 kin@ @ @ 1 tun = 18 uinal
3001 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
306Thus, the long count date 12.16.11.16.6 means 12 baktun, 16 katun, 11
307tun, 16 uinal, and 6 kin. The Emacs calendar can handle Mayan long
308count 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,
310katun, 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
316independent cycles of 13 and 20 days. Since this cycle repeats
317endlessly, Emacs provides commands to move backward and forward to the
318previous or next point in the cycle. Type @kbd{g m p t} to go to the
319previous tzolkin date; Emacs asks you for a tzolkin date and moves point
320to the previous occurrence of that date. Similarly, type @kbd{g m n t}
321to 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
327of 20 days each, followed by a 5-day monthless period. Like the tzolkin
328cycle, this cycle repeats endlessly, and there are commands to move
329backward 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
331date and moves point to the previous occurrence of that date.
332Similarly, type @kbd{g m n h} to go to the next occurrence of a haab
333date.
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
340date. 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
342both a haab and a tzolkin date and then moves point to the previous
343occurrence of that combination. Use @kbd{g m n c} to move point to the
344next occurrence of a combination. These commands signal an error if the
345haab/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
354whenever it asks you to type a Mayan name, so you don't have to worry
355about 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,
913this command first asks you for the date of death and the range of 912this command first asks you for the date of death and the range of
914years, and then displays the list of yahrzeit dates. 913years, 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
924Move to a date specified by the long count calendar
925(@code{calendar-mayan-goto-long-count-date}).
926@item g m n t
927Move to the next occurrence of a place in the
928tzolkin calendar (@code{calendar-mayan-next-tzolkin-date}).
929@item g m p t
930Move to the previous occurrence of a place in the
931tzolkin calendar (@code{calendar-mayan-previous-tzolkin-date}).
932@item g m n h
933Move to the next occurrence of a place in the
934haab calendar (@code{calendar-mayan-next-haab-date}).
935@item g m p h
936Move to the previous occurrence of a place in the
937haab calendar (@code{calendar-mayan-previous-haab-date}).
938@item g m n c
939Move to the next occurrence of a place in the
940calendar round (@code{calendar-mayan-next-calendar-round-date}).
941@item g m p c
942Move to the previous occurrence of a place in the
943calendar 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.
948The @dfn{long count} is a counting of days with these units:
949
950@display
9511 kin = 1 day@ @ @ 1 uinal = 20 kin@ @ @ 1 tun = 18 uinal
9521 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
958Thus, the long count date 12.16.11.16.6 means 12 baktun, 16 katun, 11
959tun, 16 uinal, and 6 kin. The Emacs calendar can handle Mayan long
960count 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,
962katun, 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
968independent cycles of 13 and 20 days. Since this cycle repeats
969endlessly, Emacs provides commands to move backward and forward to the
970previous or next point in the cycle. Type @kbd{g m p t} to go to the
971previous tzolkin date; Emacs asks you for a tzolkin date and moves point
972to the previous occurrence of that date. Similarly, type @kbd{g m n t}
973to 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
979of 20 days each, followed by a 5-day monthless period. Like the tzolkin
980cycle, this cycle repeats endlessly, and there are commands to move
981backward 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
983date and moves point to the previous occurrence of that date.
984Similarly, type @kbd{g m n h} to go to the next occurrence of a haab
985date.
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
992date. 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
994both a haab and a tzolkin date and then moves point to the previous
995occurrence of that combination. Use @kbd{g m n c} to move point to the
996next occurrence of a combination. These commands signal an error if the
997haab/tzolkin date combination you have typed is impossible.
998
999 Emacs uses strict completion (@pxref{Completion Exit}) whenever it
1000asks you to type a Mayan name, so you don't have to worry about
1001spelling.
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
962The Diary 961The 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.