170 |
|
|
171 |
<p> Calendar mode lets you move through the calendar in logical units of |
<p> Calendar mode lets you move through the calendar in logical units of |
172 |
time such as days, weeks, months, and years. If you move outside the |
time such as days, weeks, months, and years. If you move outside the |
173 |
three months originally displayed, the calendar display "scrolls" |
three months originally displayed, the calendar display “scrolls” |
174 |
automatically through time to make the selected date visible. Moving to |
automatically through time to make the selected date visible. Moving to |
175 |
a date lets you view its holidays or diary entries, or convert it to other |
a date lets you view its holidays or diary entries, or convert it to other |
176 |
calendars; moving longer time periods is also useful simply to scroll the |
calendars; moving longer time periods is also useful simply to scroll the |
466 |
<a name="IDX1184"></a> |
<a name="IDX1184"></a> |
467 |
<a name="IDX1185"></a> |
<a name="IDX1185"></a> |
468 |
<p> The commands <kbd>C-v</kbd> and <kbd>M-v</kbd> scroll the calendar by an entire |
<p> The commands <kbd>C-v</kbd> and <kbd>M-v</kbd> scroll the calendar by an entire |
469 |
"screenful"--three months--in analogy with the usual meaning of |
“screenful”—three months—in analogy with the usual meaning of |
470 |
these commands. <kbd>C-v</kbd> makes later dates visible and <kbd>M-v</kbd> makes |
these commands. <kbd>C-v</kbd> makes later dates visible and <kbd>M-v</kbd> makes |
471 |
earlier dates visible. These commands take a numeric argument as a |
earlier dates visible. These commands take a numeric argument as a |
472 |
repeat count; in particular, since <kbd>C-u</kbd> multiplies the next command |
repeat count; in particular, since <kbd>C-u</kbd> multiplies the next command |
701 |
</p></dd> |
</p></dd> |
702 |
</dl> |
</dl> |
703 |
|
|
704 |
<p> Some of these commands print the calendar sideways (in "landscape |
<p> Some of these commands print the calendar sideways (in “landscape |
705 |
mode"), so it can be wider than it is long. Some of them use Filofax |
mode”), so it can be wider than it is long. Some of them use Filofax |
706 |
paper size (3.75in x 6.75in). All of these commands accept a prefix |
paper size (3.75in x 6.75in). All of these commands accept a prefix |
707 |
argument which specifies how many days, weeks, months or years to print |
argument which specifies how many days, weeks, months or years to print |
708 |
(starting always with the selected one). |
(starting always with the selected one). |
942 |
|
|
943 |
<p> These calendar commands display the dates and times of the phases of |
<p> These calendar commands display the dates and times of the phases of |
944 |
the moon (new moon, first quarter, full moon, last quarter). This |
the moon (new moon, first quarter, full moon, last quarter). This |
945 |
feature is useful for debugging problems that "depend on the phase of |
feature is useful for debugging problems that “depend on the phase of |
946 |
the moon." |
the moon.” |
947 |
</p> |
</p> |
948 |
<dl compact="compact"> |
<dl compact="compact"> |
949 |
<dt> <kbd>M</kbd></dt> |
<dt> <kbd>M</kbd></dt> |
996 |
<h3 class="subsection"> 26.2.4 Conversion To and From Other Calendars </h3> |
<h3 class="subsection"> 26.2.4 Conversion To and From Other Calendars </h3> |
997 |
|
|
998 |
<p> The Emacs calendar displayed is <em>always</em> the Gregorian calendar, |
<p> The Emacs calendar displayed is <em>always</em> the Gregorian calendar, |
999 |
sometimes called the "new style" calendar, which is used in most of |
sometimes called the “new style” calendar, which is used in most of |
1000 |
the world today. However, this calendar did not exist before the |
the world today. However, this calendar did not exist before the |
1001 |
sixteenth century and was not widely used before the eighteenth century; |
sixteenth century and was not widely used before the eighteenth century; |
1002 |
it did not fully displace the Julian calendar and gain universal |
it did not fully displace the Julian calendar and gain universal |
1022 |
|
|
1023 |
<p> If you are interested in these calendars, you can convert dates one at a |
<p> If you are interested in these calendars, you can convert dates one at a |
1024 |
time. Put point on the desired date of the Gregorian calendar and press the |
time. Put point on the desired date of the Gregorian calendar and press the |
1025 |
appropriate keys. The <kbd>p</kbd> is a mnemonic for "print" since Emacs |
appropriate keys. The <kbd>p</kbd> is a mnemonic for “print” since Emacs |
1026 |
"prints' the equivalent date in the echo area. |
“prints' the equivalent date in the echo area. |
1027 |
</p><hr size="6"> |
</p><hr size="6"> |
1028 |
<a name="Calendar-Systems"></a> |
<a name="Calendar-Systems"></a> |
1029 |
<a name="SEC314"></a> |
<a name="SEC314"></a> |
1107 |
into solar years. The years go in cycles of sixty, each year containing |
into solar years. The years go in cycles of sixty, each year containing |
1108 |
either twelve months in an ordinary year or thirteen months in a leap |
either twelve months in an ordinary year or thirteen months in a leap |
1109 |
year; each month has either 29 or 30 days. Years, ordinary months, and |
year; each month has either 29 or 30 days. Years, ordinary months, and |
1110 |
days are named by combining one of ten "celestial stems" with one of |
days are named by combining one of ten “celestial stems” with one of |
1111 |
twelve "terrestrial branches" for a total of sixty names that are |
twelve “terrestrial branches” for a total of sixty names that are |
1112 |
repeated in a cycle of sixty. |
repeated in a cycle of sixty. |
1113 |
</p> |
</p> |
1114 |
<hr size="6"> |
<hr size="6"> |
1198 |
Calendars</kbd> from the menu that appears. This displays the equivalent |
Calendars</kbd> from the menu that appears. This displays the equivalent |
1199 |
forms of the date in all the calendars Emacs understands, in the form of |
forms of the date in all the calendars Emacs understands, in the form of |
1200 |
a menu. (Choosing an alternative from this menu doesn't actually do |
a menu. (Choosing an alternative from this menu doesn't actually do |
1201 |
anything--the menu is used only for display.) |
anything—the menu is used only for display.) |
1202 |
</p> |
</p> |
1203 |
<p> Put point on the desired date of the Gregorian calendar, then type the |
<p> Put point on the desired date of the Gregorian calendar, then type the |
1204 |
appropriate keys. The <kbd>p</kbd> is a mnemonic for "print" since Emacs |
appropriate keys. The <kbd>p</kbd> is a mnemonic for “print” since Emacs |
1205 |
"prints" the equivalent date in the echo area. |
“prints” the equivalent date in the echo area. |
1206 |
</p> |
</p> |
1207 |
<hr size="6"> |
<hr size="6"> |
1208 |
<a name="From-Other-Calendar"></a> |
<a name="From-Other-Calendar"></a> |
1292 |
<a name="IDX1263"></a> |
<a name="IDX1263"></a> |
1293 |
<a name="IDX1264"></a> |
<a name="IDX1264"></a> |
1294 |
<p> One common question concerning the Hebrew calendar is the computation |
<p> One common question concerning the Hebrew calendar is the computation |
1295 |
of the anniversary of a date of death, called a "yahrzeit." The Emacs |
of the anniversary of a date of death, called a “yahrzeit.” The Emacs |
1296 |
calendar includes a facility for such calculations. If you are in the |
calendar includes a facility for such calculations. If you are in the |
1297 |
calendar, the command <kbd>M-x list-yahrzeit-dates</kbd> asks you for a |
calendar, the command <kbd>M-x list-yahrzeit-dates</kbd> asks you for a |
1298 |
range of years and then displays a list of the yahrzeit dates for those |
range of years and then displays a list of the yahrzeit dates for those |
1725 |
<a name="IDX1288"></a> |
<a name="IDX1288"></a> |
1726 |
<a name="IDX1289"></a> |
<a name="IDX1289"></a> |
1727 |
<a name="IDX1290"></a> |
<a name="IDX1290"></a> |
1728 |
<p> If you prefer the European style of writing dates--in which the day |
<p> If you prefer the European style of writing dates—in which the day |
1729 |
comes before the month--type <kbd>M-x european-calendar</kbd> while in the |
comes before the month—type <kbd>M-x european-calendar</kbd> while in the |
1730 |
calendar, or set the variable <code>european-calendar-style</code> to <code>t</code> |
calendar, or set the variable <code>european-calendar-style</code> to <code>t</code> |
1731 |
<em>before</em> using any calendar or diary command. This mode interprets |
<em>before</em> using any calendar or diary command. This mode interprets |
1732 |
all dates in the diary in the European manner, and also uses European |
all dates in the diary in the European manner, and also uses European |
1929 |
|
|
1930 |
<p>The 11 specifies November (the eleventh month), the 4 specifies Thursday |
<p>The 11 specifies November (the eleventh month), the 4 specifies Thursday |
1931 |
(the fourth day of the week, where Sunday is numbered zero), and the |
(the fourth day of the week, where Sunday is numbered zero), and the |
1932 |
-1 specifies "last" (1 would mean "first", 2 would mean |
-1 specifies “last” (1 would mean “first”, 2 would mean |
1933 |
"second", -2 would mean "second-to-last", and so on). The |
“second”, -2 would mean “second-to-last”, and so on). The |
1934 |
month can be a single month or a list of months. Thus you could change |
month can be a single month or a list of months. Thus you could change |
1935 |
the 11 above to <samp>`'(1 2 3)'</samp> and have the entry apply to the last |
the 11 above to <samp>`'(1 2 3)'</samp> and have the entry apply to the last |
1936 |
Thursday of January, February, and March. If the month is <code>t</code>, the |
Thursday of January, February, and March. If the month is <code>t</code>, the |
2182 |
sometimes a list of holidays). |
sometimes a list of holidays). |
2183 |
</p> |
</p> |
2184 |
<p> Here is a table of the possible kinds of holiday form. Day numbers |
<p> Here is a table of the possible kinds of holiday form. Day numbers |
2185 |
and month numbers count starting from 1, but "dayname" numbers |
and month numbers count starting from 1, but “dayname” numbers |
2186 |
count Sunday as 0. The element <var>string</var> is always the |
count Sunday as 0. The element <var>string</var> is always the |
2187 |
name of the holiday, as a string. |
name of the holiday, as a string. |
2188 |
</p> |
</p> |
2419 |
<h4 class="subsubsection"> 26.5.8.5 Daylight Savings Time </h4> |
<h4 class="subsubsection"> 26.5.8.5 Daylight Savings Time </h4> |
2420 |
|
|
2421 |
<p> Emacs understands the difference between standard time and daylight |
<p> Emacs understands the difference between standard time and daylight |
2422 |
savings time--the times given for sunrise, sunset, solstices, |
savings time—the times given for sunrise, sunset, solstices, |
2423 |
equinoxes, and the phases of the moon take that into account. The rules |
equinoxes, and the phases of the moon take that into account. The rules |
2424 |
for daylight savings time vary from place to place and have also varied |
for daylight savings time vary from place to place and have also varied |
2425 |
historically from year to year. To do the job properly, Emacs needs to |
historically from year to year. To do the job properly, Emacs needs to |
2564 |
month name, and day name of the date being considered. The symbols that |
month name, and day name of the date being considered. The symbols that |
2565 |
match numbers allow leading zeros; those that match names allow |
match numbers allow leading zeros; those that match names allow |
2566 |
three-letter abbreviations and capitalization. All the symbols can |
three-letter abbreviations and capitalization. All the symbols can |
2567 |
match <samp>`*'</samp>; since <samp>`*'</samp> in a diary entry means "any day", "any |
match <samp>`*'</samp>; since <samp>`*'</samp> in a diary entry means “any day”, “any |
2568 |
month", and so on, it should match regardless of the date being |
month”, and so on, it should match regardless of the date being |
2569 |
considered. |
considered. |
2570 |
</p> |
</p> |
2571 |
<p> The default value of <code>diary-date-forms</code> in the American style is |
<p> The default value of <code>diary-date-forms</code> in the American style is |
2586 |
<p> The date patterns in the list must be <em>mutually exclusive</em> and |
<p> The date patterns in the list must be <em>mutually exclusive</em> and |
2587 |
must not match any portion of the diary entry itself, just the date and |
must not match any portion of the diary entry itself, just the date and |
2588 |
one character of whitespace. If, to be mutually exclusive, the pattern |
one character of whitespace. If, to be mutually exclusive, the pattern |
2589 |
must match a portion of the diary entry text--beyond the whitespace |
must match a portion of the diary entry text—beyond the whitespace |
2590 |
that ends the date--then the first element of the date pattern |
that ends the date—then the first element of the date pattern |
2591 |
<em>must</em> be <code>backup</code>. This causes the date recognizer to back |
<em>must</em> be <code>backup</code>. This causes the date recognizer to back |
2592 |
up to the beginning of the current word of the diary entry, after |
up to the beginning of the current word of the diary entry, after |
2593 |
finishing the match. Even if you use <code>backup</code>, the date pattern |
finishing the match. Even if you use <code>backup</code>, the date pattern |
2753 |
<p>this enables fancy diary display. It displays diary entries and |
<p>this enables fancy diary display. It displays diary entries and |
2754 |
holidays by copying them into a special buffer that exists only for the |
holidays by copying them into a special buffer that exists only for the |
2755 |
sake of display. Copying to a separate buffer provides an opportunity |
sake of display. Copying to a separate buffer provides an opportunity |
2756 |
to change the displayed text to make it prettier--for example, to sort |
to change the displayed text to make it prettier—for example, to sort |
2757 |
the entries by the dates they apply to. |
the entries by the dates they apply to. |
2758 |
</p> |
</p> |
2759 |
<p> As with simple diary display, you can print a hard copy of the buffer |
<p> As with simple diary display, you can print a hard copy of the buffer |
3345 |
<p> To run a subshell interactively with its typescript in an XEmacs |
<p> To run a subshell interactively with its typescript in an XEmacs |
3346 |
buffer, use <kbd>M-x shell</kbd>. This creates (or reuses) a buffer named |
buffer, use <kbd>M-x shell</kbd>. This creates (or reuses) a buffer named |
3347 |
<samp>`*shell*'</samp> and runs a subshell with input coming from and output going |
<samp>`*shell*'</samp> and runs a subshell with input coming from and output going |
3348 |
to that buffer. That is to say, any "terminal output" from the subshell |
to that buffer. That is to say, any “terminal output” from the subshell |
3349 |
will go into the buffer, advancing point, and any "terminal input" for |
will go into the buffer, advancing point, and any “terminal input” for |
3350 |
the subshell comes from text in the buffer. To give input to the subshell, |
the subshell comes from text in the buffer. To give input to the subshell, |
3351 |
go to the end of the buffer and type the input, terminated by <kbd>RET</kbd>. |
go to the end of the buffer and type the input, terminated by <kbd>RET</kbd>. |
3352 |
</p> |
</p> |
3555 |
output going to that buffer. |
output going to that buffer. |
3556 |
</p> |
</p> |
3557 |
<p>All the normal keys that you type are sent without any interpretation |
<p>All the normal keys that you type are sent without any interpretation |
3558 |
by XEmacs directly to the subshell, as "terminal input." |
by XEmacs directly to the subshell, as “terminal input.” |
3559 |
Any "echo" of your input is the responsibility of the subshell. |
Any “echo” of your input is the responsibility of the subshell. |
3560 |
(The exception is the terminal escape character, |
(The exception is the terminal escape character, |
3561 |
which by default is <kbd>C-c</kbd>. see section <a href="#SEC342">Term Mode</a>.) |
which by default is <kbd>C-c</kbd>. see section <a href="#SEC342">Term Mode</a>.) |
3562 |
Any "terminal output" from the subshell goes into the buffer, |
Any “terminal output” from the subshell goes into the buffer, |
3563 |
advancing point. |
advancing point. |
3564 |
</p> |
</p> |
3565 |
<p> Some programs (such as XEmacs itself) need to control the |
<p> Some programs (such as XEmacs itself) need to control the |
3886 |
<p> In general, XEmacs tries to avoid using recursive edits. It is |
<p> In general, XEmacs tries to avoid using recursive edits. It is |
3887 |
usually preferable to allow users to switch among the possible editing |
usually preferable to allow users to switch among the possible editing |
3888 |
modes in any order they like. With recursive edits, the only way to get |
modes in any order they like. With recursive edits, the only way to get |
3889 |
to another state is to go "back" to the state that the recursive edit |
to another state is to go “back” to the state that the recursive edit |
3890 |
was invoked from. |
was invoked from. |
3891 |
</p> |
</p> |
3892 |
<hr size="6"> |
<hr size="6"> |
4082 |
familiar, vi-like fashion. Viper provides various different |
familiar, vi-like fashion. Viper provides various different |
4083 |
levels of vi emulation, from a quite complete emulation that |
levels of vi emulation, from a quite complete emulation that |
4084 |
allows almost no access to native XEmacs commands, to an |
allows almost no access to native XEmacs commands, to an |
4085 |
"expert" mode that combines the most useful vi commands with |
“expert” mode that combines the most useful vi commands with |
4086 |
the most useful XEmacs commands. |
the most useful XEmacs commands. |
4087 |
</p> |
</p> |
4088 |
<p>To start Viper, put the command |
<p>To start Viper, put the command |