diff options
| author | Karoly Lorentey | 2007-04-22 12:12:29 +0000 |
|---|---|---|
| committer | Karoly Lorentey | 2007-04-22 12:12:29 +0000 |
| commit | e18c709364b095ea0be8ecabe458ac9a642a252f (patch) | |
| tree | efe814a842f932f387b3947c572bf43a548d17ef /man | |
| parent | 81088e260b086fe28f36964f32b6338210ec6fd8 (diff) | |
| parent | 9f25e707aaad5ed14a9448e9c5d345ff0bdbc5a7 (diff) | |
| download | emacs-e18c709364b095ea0be8ecabe458ac9a642a252f.tar.gz emacs-e18c709364b095ea0be8ecabe458ac9a642a252f.zip | |
Merged from emacs@sv.gnu.org
Patches applied:
* emacs@sv.gnu.org/emacs--devo--0--patch-660
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-661
Merge from gnus--rel--5.10
* emacs@sv.gnu.org/emacs--devo--0--patch-662
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-663
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-664
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-665
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-666
Fix read-only prompt problem in isearch
* emacs@sv.gnu.org/emacs--devo--0--patch-667
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-668
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-669
Merge from gnus--rel--5.10
* emacs@sv.gnu.org/emacs--devo--0--patch-670
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-671
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-672
Update from CVS
* emacs@sv.gnu.org/emacs--devo--0--patch-673
Update from CVS
* emacs@sv.gnu.org/gnus--rel--5.10--patch-206
Merge from emacs--devo--0
* emacs@sv.gnu.org/gnus--rel--5.10--patch-207
Merge from emacs--devo--0
* emacs@sv.gnu.org/gnus--rel--5.10--patch-208
Update from CVS
git-archimport-id: lorentey@elte.hu--2004/emacs--multi-tty--0--patch-600
Diffstat (limited to 'man')
| -rw-r--r-- | man/ChangeLog | 43 | ||||
| -rw-r--r-- | man/calc.texi | 92 | ||||
| -rw-r--r-- | man/calendar.texi | 34 | ||||
| -rw-r--r-- | man/cc-mode.texi | 2 | ||||
| -rw-r--r-- | man/custom.texi | 2 | ||||
| -rw-r--r-- | man/emacs.texi | 4 | ||||
| -rw-r--r-- | man/eshell.texi | 4 | ||||
| -rw-r--r-- | man/faq.texi | 33 | ||||
| -rw-r--r-- | man/gnus.texi | 12 | ||||
| -rw-r--r-- | man/pgg.texi | 2 |
10 files changed, 136 insertions, 92 deletions
diff --git a/man/ChangeLog b/man/ChangeLog index ad357f99680..c2d58789490 100644 --- a/man/ChangeLog +++ b/man/ChangeLog | |||
| @@ -1,3 +1,42 @@ | |||
| 1 | 2007-03-21 Glenn Morris <rgm@gnu.org> | ||
| 2 | |||
| 3 | * eshell.texi (Known problems): Emacs 22 comes with eshell 2.4.2. | ||
| 4 | |||
| 5 | 2007-03-19 Chong Yidong <cyd@stupidchicken.com> | ||
| 6 | |||
| 7 | * eshell.texi (Known problems): Emacs 21 -> 22. | ||
| 8 | |||
| 9 | * cc-mode.texi (Performance Issues): Update note about 21.3 to 22.1. | ||
| 10 | |||
| 11 | 2007-03-18 Jay Belanger <belanger@truman.edu> | ||
| 12 | |||
| 13 | * calc.texi (Time Zones): Mention that the DST rules changed in 2007. | ||
| 14 | |||
| 15 | 2007-03-12 Glenn Morris <rgm@gnu.org> | ||
| 16 | |||
| 17 | * calc.texi (Time Zones): Switch to new North America DST rule. | ||
| 18 | |||
| 19 | * calendar.texi, emacs.texi (Daylight Saving): Rename node from | ||
| 20 | "Daylight Savings". | ||
| 21 | |||
| 22 | * calc.texi, calendar.texi: Replace "daylight savings" with "daylight | ||
| 23 | saving" in text throughout. | ||
| 24 | |||
| 25 | 2007-03-11 Andreas Seltenreich <uwi7@rz.uni-karlsruhe.de> | ||
| 26 | |||
| 27 | * gnus.texi (Mail and Post): Update documentation for gnus-user-agent. | ||
| 28 | The variable now uses a list of symbols instead of just a symbol. | ||
| 29 | Reported by Christoph Conrad <christoph.conrad@gmx.de>. | ||
| 30 | |||
| 31 | 2007-03-06 Romain Francoise <romain@orebokech.com> | ||
| 32 | |||
| 33 | * faq.texi (New in Emacs 22): Don't say "now" too much. Add MH-E to | ||
| 34 | new packages, and mention Gnus update. | ||
| 35 | |||
| 36 | 2007-03-04 Richard Stallman <rms@gnu.org> | ||
| 37 | |||
| 38 | * custom.texi (Safe File Variables): Minor correction. | ||
| 39 | |||
| 1 | 2007-02-27 Katsumi Yamaoka <yamaoka@jpl.org> | 40 | 2007-02-27 Katsumi Yamaoka <yamaoka@jpl.org> |
| 2 | 41 | ||
| 3 | * gnus.texi (NNTP): Mention nntp-never-echoes-commands and | 42 | * gnus.texi (NNTP): Mention nntp-never-echoes-commands and |
| @@ -306,9 +345,9 @@ | |||
| 306 | 345 | ||
| 307 | 2006-12-24 Kevin Ryde <user42@zip.com.au> | 346 | 2006-12-24 Kevin Ryde <user42@zip.com.au> |
| 308 | 347 | ||
| 309 | * calendar.texi (Holidays): US daylight savings begins second Sunday | 348 | * calendar.texi (Holidays): US daylight saving begins second Sunday |
| 310 | in March for 2007 onwards. | 349 | in March for 2007 onwards. |
| 311 | (Daylight Savings): Show new US default daylight savings rules, 2nd | 350 | (Daylight Savings): Show new US default daylight saving rules, 2nd |
| 312 | Sun in Mar to 1st Sun in Nov, now in cal-dst.el. | 351 | Sun in Mar to 1st Sun in Nov, now in cal-dst.el. |
| 313 | 352 | ||
| 314 | 2006-12-23 Chong Yidong <cyd@stupidchicken.com> | 353 | 2006-12-23 Chong Yidong <cyd@stupidchicken.com> |
diff --git a/man/calc.texi b/man/calc.texi index ca7167905cb..0544bc1e3b4 100644 --- a/man/calc.texi +++ b/man/calc.texi | |||
| @@ -17364,31 +17364,32 @@ business day. | |||
| 17364 | 17364 | ||
| 17365 | @noindent | 17365 | @noindent |
| 17366 | @cindex Time zones | 17366 | @cindex Time zones |
| 17367 | @cindex Daylight savings time | 17367 | @cindex Daylight saving time |
| 17368 | Time zones and daylight savings time are a complicated business. | 17368 | Time zones and daylight saving time are a complicated business. |
| 17369 | The conversions to and from Julian and Unix-style dates automatically | 17369 | The conversions to and from Julian and Unix-style dates automatically |
| 17370 | compute the correct time zone and daylight savings adjustment to use, | 17370 | compute the correct time zone and daylight saving adjustment to use, |
| 17371 | provided they can figure out this information. This section describes | 17371 | provided they can figure out this information. This section describes |
| 17372 | Calc's time zone adjustment algorithm in detail, in case you want to | 17372 | Calc's time zone adjustment algorithm in detail, in case you want to |
| 17373 | do conversions in different time zones or in case Calc's algorithms | 17373 | do conversions in different time zones or in case Calc's algorithms |
| 17374 | can't determine the right correction to use. | 17374 | can't determine the right correction to use. |
| 17375 | 17375 | ||
| 17376 | Adjustments for time zones and daylight savings time are done by | 17376 | Adjustments for time zones and daylight saving time are done by |
| 17377 | @kbd{t U}, @kbd{t J}, @kbd{t N}, and @kbd{t C}, but not by any other | 17377 | @kbd{t U}, @kbd{t J}, @kbd{t N}, and @kbd{t C}, but not by any other |
| 17378 | commands. In particular, @samp{<may 1 1991> - <apr 1 1991>} evaluates | 17378 | commands. In particular, @samp{<may 1 1991> - <apr 1 1991>} evaluates |
| 17379 | to exactly 30 days even though there is a daylight-savings | 17379 | to exactly 30 days even though there is a daylight-saving |
| 17380 | transition in between. This is also true for Julian pure dates: | 17380 | transition in between. This is also true for Julian pure dates: |
| 17381 | @samp{julian(<may 1 1991>) - julian(<apr 1 1991>)}. But Julian | 17381 | @samp{julian(<may 1 1991>) - julian(<apr 1 1991>)}. But Julian |
| 17382 | and Unix date/times will adjust for daylight savings time: | 17382 | and Unix date/times will adjust for daylight saving time: using Calc's |
| 17383 | default daylight saving time rule (see the explanation below), | ||
| 17383 | @samp{julian(<12am may 1 1991>) - julian(<12am apr 1 1991>)} | 17384 | @samp{julian(<12am may 1 1991>) - julian(<12am apr 1 1991>)} |
| 17384 | evaluates to @samp{29.95834} (that's 29 days and 23 hours) | 17385 | evaluates to @samp{29.95833} (that's 29 days and 23 hours) |
| 17385 | because one hour was lost when daylight savings commenced on | 17386 | because one hour was lost when daylight saving commenced on |
| 17386 | April 7, 1991. | 17387 | April 7, 1991. |
| 17387 | 17388 | ||
| 17388 | In brief, the idiom @samp{julian(@var{date1}) - julian(@var{date2})} | 17389 | In brief, the idiom @samp{julian(@var{date1}) - julian(@var{date2})} |
| 17389 | computes the actual number of 24-hour periods between two dates, whereas | 17390 | computes the actual number of 24-hour periods between two dates, whereas |
| 17390 | @samp{@var{date1} - @var{date2}} computes the number of calendar | 17391 | @samp{@var{date1} - @var{date2}} computes the number of calendar |
| 17391 | days between two dates without taking daylight savings into account. | 17392 | days between two dates without taking daylight saving into account. |
| 17392 | 17393 | ||
| 17393 | @pindex calc-time-zone | 17394 | @pindex calc-time-zone |
| 17394 | @ignore | 17395 | @ignore |
| @@ -17400,7 +17401,7 @@ zone specified by its numeric prefix argument into a number of | |||
| 17400 | seconds difference from Greenwich mean time (GMT). If the argument | 17401 | seconds difference from Greenwich mean time (GMT). If the argument |
| 17401 | is a number, the result is simply that value multiplied by 3600. | 17402 | is a number, the result is simply that value multiplied by 3600. |
| 17402 | Typical arguments for North America are 5 (Eastern) or 8 (Pacific). If | 17403 | Typical arguments for North America are 5 (Eastern) or 8 (Pacific). If |
| 17403 | Daylight Savings time is in effect, one hour should be subtracted from | 17404 | Daylight Saving time is in effect, one hour should be subtracted from |
| 17404 | the normal difference. | 17405 | the normal difference. |
| 17405 | 17406 | ||
| 17406 | If you give a prefix of plain @kbd{C-u}, @code{calc-time-zone} (like other | 17407 | If you give a prefix of plain @kbd{C-u}, @code{calc-time-zone} (like other |
| @@ -17411,12 +17412,12 @@ stack position.) This allows you to give a non-integer time zone | |||
| 17411 | adjustment. The time-zone argument can also be an HMS form, or | 17412 | adjustment. The time-zone argument can also be an HMS form, or |
| 17412 | it can be a variable which is a time zone name in upper- or lower-case. | 17413 | it can be a variable which is a time zone name in upper- or lower-case. |
| 17413 | For example @samp{tzone(PST) = tzone(8)} and @samp{tzone(pdt) = tzone(7)} | 17414 | For example @samp{tzone(PST) = tzone(8)} and @samp{tzone(pdt) = tzone(7)} |
| 17414 | (for Pacific standard and daylight savings times, respectively). | 17415 | (for Pacific standard and daylight saving times, respectively). |
| 17415 | 17416 | ||
| 17416 | North American and European time zone names are defined as follows; | 17417 | North American and European time zone names are defined as follows; |
| 17417 | note that for each time zone there is one name for standard time, | 17418 | note that for each time zone there is one name for standard time, |
| 17418 | another for daylight savings time, and a third for ``generalized'' time | 17419 | another for daylight saving time, and a third for ``generalized'' time |
| 17419 | in which the daylight savings adjustment is computed from context. | 17420 | in which the daylight saving adjustment is computed from context. |
| 17420 | 17421 | ||
| 17421 | @smallexample | 17422 | @smallexample |
| 17422 | @group | 17423 | @group |
| @@ -17441,7 +17442,7 @@ Pacific Time look like this: | |||
| 17441 | @smallexample | 17442 | @smallexample |
| 17442 | @group | 17443 | @group |
| 17443 | ( ( "PST" 8 0 ) ; Name as an upper-case string, then standard | 17444 | ( ( "PST" 8 0 ) ; Name as an upper-case string, then standard |
| 17444 | ( "PDT" 8 -1 ) ; adjustment, then daylight savings adjustment. | 17445 | ( "PDT" 8 -1 ) ; adjustment, then daylight saving adjustment. |
| 17445 | ( "PGT" 8 "PST" "PDT" ) ) ; Generalized time zone. | 17446 | ( "PGT" 8 "PST" "PDT" ) ) ; Generalized time zone. |
| 17446 | @end group | 17447 | @end group |
| 17447 | @end smallexample | 17448 | @end smallexample |
| @@ -17464,10 +17465,10 @@ i.e., it uses the local time zone as obtained from the @code{date} | |||
| 17464 | command. | 17465 | command. |
| 17465 | 17466 | ||
| 17466 | If the time zone name found is one of the standard or daylight | 17467 | If the time zone name found is one of the standard or daylight |
| 17467 | savings zone names from the above table, and Calc's internal | 17468 | saving zone names from the above table, and Calc's internal |
| 17468 | daylight savings algorithm says that time and zone are consistent | 17469 | daylight saving algorithm says that time and zone are consistent |
| 17469 | (e.g., @code{PDT} accompanies a date that Calc's algorithm would also | 17470 | (e.g., @code{PDT} accompanies a date that Calc's algorithm would also |
| 17470 | consider to be daylight savings, or @code{PST} accompanies a date | 17471 | consider to be daylight saving, or @code{PST} accompanies a date |
| 17471 | that Calc would consider to be standard time), then Calc substitutes | 17472 | that Calc would consider to be standard time), then Calc substitutes |
| 17472 | the corresponding generalized time zone (like @code{PGT}). | 17473 | the corresponding generalized time zone (like @code{PGT}). |
| 17473 | 17474 | ||
| @@ -17484,38 +17485,41 @@ The @kbd{t J} and @code{t U} commands with no numeric prefix | |||
| 17484 | arguments do the same thing as @samp{tzone()}. If the current | 17485 | arguments do the same thing as @samp{tzone()}. If the current |
| 17485 | time zone is a generalized time zone, e.g., @code{EGT}, Calc | 17486 | time zone is a generalized time zone, e.g., @code{EGT}, Calc |
| 17486 | examines the date being converted to tell whether to use standard | 17487 | examines the date being converted to tell whether to use standard |
| 17487 | or daylight savings time. But if the current time zone is explicit, | 17488 | or daylight saving time. But if the current time zone is explicit, |
| 17488 | e.g., @code{EST} or @code{EDT}, then that adjustment is used exactly | 17489 | e.g., @code{EST} or @code{EDT}, then that adjustment is used exactly |
| 17489 | and Calc's daylight savings algorithm is not consulted. | 17490 | and Calc's daylight saving algorithm is not consulted. |
| 17490 | 17491 | ||
| 17491 | Some places don't follow the usual rules for daylight savings time. | 17492 | Some places don't follow the usual rules for daylight saving time. |
| 17492 | The state of Arizona, for example, does not observe daylight savings | 17493 | The state of Arizona, for example, does not observe daylight saving |
| 17493 | time. If you run Calc during the winter season in Arizona, the | 17494 | time. If you run Calc during the winter season in Arizona, the |
| 17494 | Unix @code{date} command will report @code{MST} time zone, which | 17495 | Unix @code{date} command will report @code{MST} time zone, which |
| 17495 | Calc will change to @code{MGT}. If you then convert a time that | 17496 | Calc will change to @code{MGT}. If you then convert a time that |
| 17496 | lies in the summer months, Calc will apply an incorrect daylight | 17497 | lies in the summer months, Calc will apply an incorrect daylight |
| 17497 | savings time adjustment. To avoid this, set your @code{TimeZone} | 17498 | saving time adjustment. To avoid this, set your @code{TimeZone} |
| 17498 | variable explicitly to @code{MST} to force the use of standard, | 17499 | variable explicitly to @code{MST} to force the use of standard, |
| 17499 | non-daylight-savings time. | 17500 | non-daylight-saving time. |
| 17500 | 17501 | ||
| 17501 | @vindex math-daylight-savings-hook | 17502 | @vindex math-daylight-savings-hook |
| 17502 | @findex math-std-daylight-savings | 17503 | @findex math-std-daylight-savings |
| 17503 | By default Calc always considers daylight savings time to begin at | 17504 | By default Calc always considers daylight saving time to begin at |
| 17504 | 2 a.m.@: on the first Sunday of April, and to end at 2 a.m.@: on the | 17505 | 2 a.m.@: on the second Sunday of March (for years from 2007 on) or on |
| 17505 | last Sunday of October. This is the rule that has been in effect | 17506 | the last Sunday in April (for years before 2007), and to end at 2 a.m.@: |
| 17506 | in North America since 1987. If you are in a country that uses | 17507 | on the first Sunday of November. (for years from 2007 on) or the last |
| 17507 | different rules for computing daylight savings time, you have two | 17508 | Sunday in October (for years before 2007). These are the rules that have |
| 17508 | choices: Write your own daylight savings hook, or control time | 17509 | been in effect in much of North America since 1966 and takes into |
| 17509 | zones explicitly by setting the @code{TimeZone} variable and/or | 17510 | account the rule change that began in 2007. If you are in a |
| 17511 | country that uses different rules for computing daylight saving time, | ||
| 17512 | you have two choices: Write your own daylight saving hook, or control | ||
| 17513 | time zones explicitly by setting the @code{TimeZone} variable and/or | ||
| 17510 | always giving a time-zone argument for the conversion functions. | 17514 | always giving a time-zone argument for the conversion functions. |
| 17511 | 17515 | ||
| 17512 | The Lisp variable @code{math-daylight-savings-hook} holds the | 17516 | The Lisp variable @code{math-daylight-savings-hook} holds the |
| 17513 | name of a function that is used to compute the daylight savings | 17517 | name of a function that is used to compute the daylight saving |
| 17514 | adjustment for a given date. The default is | 17518 | adjustment for a given date. The default is |
| 17515 | @code{math-std-daylight-savings}, which computes an adjustment | 17519 | @code{math-std-daylight-savings}, which computes an adjustment |
| 17516 | (either 0 or @mathit{-1}) using the North American rules given above. | 17520 | (either 0 or @mathit{-1}) using the North American rules given above. |
| 17517 | 17521 | ||
| 17518 | The daylight savings hook function is called with four arguments: | 17522 | The daylight saving hook function is called with four arguments: |
| 17519 | The date, as a floating-point number in standard Calc format; | 17523 | The date, as a floating-point number in standard Calc format; |
| 17520 | a six-element list of the date decomposed into year, month, day, | 17524 | a six-element list of the date decomposed into year, month, day, |
| 17521 | hour, minute, and second, respectively; a string which contains | 17525 | hour, minute, and second, respectively; a string which contains |
| @@ -17525,18 +17529,18 @@ converting into a generalized time zone (see below). | |||
| 17525 | 17529 | ||
| 17526 | @findex math-prev-weekday-in-month | 17530 | @findex math-prev-weekday-in-month |
| 17527 | The Lisp function @code{math-prev-weekday-in-month} is useful for | 17531 | The Lisp function @code{math-prev-weekday-in-month} is useful for |
| 17528 | daylight savings computations. This is an internal version of | 17532 | daylight saving computations. This is an internal version of |
| 17529 | the user-level @code{pwday} function described in the previous | 17533 | the user-level @code{pwday} function described in the previous |
| 17530 | section. It takes four arguments: The floating-point date value, | 17534 | section. It takes four arguments: The floating-point date value, |
| 17531 | the corresponding six-element date list, the day-of-month number, | 17535 | the corresponding six-element date list, the day-of-month number, |
| 17532 | and the weekday number (0-6). | 17536 | and the weekday number (0-6). |
| 17533 | 17537 | ||
| 17534 | The default daylight savings hook ignores the time zone name, but a | 17538 | The default daylight saving hook ignores the time zone name, but a |
| 17535 | more sophisticated hook could use different algorithms for different | 17539 | more sophisticated hook could use different algorithms for different |
| 17536 | time zones. It would also be possible to use different algorithms | 17540 | time zones. It would also be possible to use different algorithms |
| 17537 | depending on the year number, but the default hook always uses the | 17541 | depending on the year number, but the default hook always uses the |
| 17538 | algorithm for 1987 and later. Here is a listing of the default | 17542 | algorithm for 1987 and later. Here is a listing of the default |
| 17539 | daylight savings hook: | 17543 | daylight saving hook: |
| 17540 | 17544 | ||
| 17541 | @smallexample | 17545 | @smallexample |
| 17542 | (defun math-std-daylight-savings (date dt zone bump) | 17546 | (defun math-std-daylight-savings (date dt zone bump) |
| @@ -17566,25 +17570,25 @@ adjustments shown above ensure that the conversion behaves correctly | |||
| 17566 | and reasonably around the 2 a.m.@: transition in each direction. | 17570 | and reasonably around the 2 a.m.@: transition in each direction. |
| 17567 | 17571 | ||
| 17568 | There is a ``missing'' hour between 2 a.m.@: and 3 a.m.@: at the | 17572 | There is a ``missing'' hour between 2 a.m.@: and 3 a.m.@: at the |
| 17569 | beginning of daylight savings time; converting a date/time form that | 17573 | beginning of daylight saving time; converting a date/time form that |
| 17570 | falls in this hour results in a time value for the following hour, | 17574 | falls in this hour results in a time value for the following hour, |
| 17571 | from 3 a.m.@: to 4 a.m. At the end of daylight savings time, the | 17575 | from 3 a.m.@: to 4 a.m. At the end of daylight saving time, the |
| 17572 | hour from 1 a.m.@: to 2 a.m.@: repeats itself; converting a date/time | 17576 | hour from 1 a.m.@: to 2 a.m.@: repeats itself; converting a date/time |
| 17573 | form that falls in this hour results in a time value for the first | 17577 | form that falls in this hour results in a time value for the first |
| 17574 | manifestation of that time (@emph{not} the one that occurs one hour later). | 17578 | manifestation of that time (@emph{not} the one that occurs one hour later). |
| 17575 | 17579 | ||
| 17576 | If @code{math-daylight-savings-hook} is @code{nil}, then the | 17580 | If @code{math-daylight-savings-hook} is @code{nil}, then the |
| 17577 | daylight savings adjustment is always taken to be zero. | 17581 | daylight saving adjustment is always taken to be zero. |
| 17578 | 17582 | ||
| 17579 | In algebraic formulas, @samp{tzone(@var{zone}, @var{date})} | 17583 | In algebraic formulas, @samp{tzone(@var{zone}, @var{date})} |
| 17580 | computes the time zone adjustment for a given zone name at a | 17584 | computes the time zone adjustment for a given zone name at a |
| 17581 | given date. The @var{date} is ignored unless @var{zone} is a | 17585 | given date. The @var{date} is ignored unless @var{zone} is a |
| 17582 | generalized time zone. If @var{date} is a date form, the | 17586 | generalized time zone. If @var{date} is a date form, the |
| 17583 | daylight savings computation is applied to it as it appears. | 17587 | daylight saving computation is applied to it as it appears. |
| 17584 | If @var{date} is a numeric date value, it is adjusted for the | 17588 | If @var{date} is a numeric date value, it is adjusted for the |
| 17585 | daylight-savings version of @var{zone} before being given to | 17589 | daylight-saving version of @var{zone} before being given to |
| 17586 | the daylight savings hook. This odd-sounding rule ensures | 17590 | the daylight saving hook. This odd-sounding rule ensures |
| 17587 | that the daylight-savings computation is always done in | 17591 | that the daylight-saving computation is always done in |
| 17588 | local time, not in the GMT time that a numeric @var{date} | 17592 | local time, not in the GMT time that a numeric @var{date} |
| 17589 | is typically represented in. | 17593 | is typically represented in. |
| 17590 | 17594 | ||
| @@ -17593,9 +17597,9 @@ is typically represented in. | |||
| 17593 | @end ignore | 17597 | @end ignore |
| 17594 | @tindex dsadj | 17598 | @tindex dsadj |
| 17595 | The @samp{dsadj(@var{date}, @var{zone})} function computes the | 17599 | The @samp{dsadj(@var{date}, @var{zone})} function computes the |
| 17596 | daylight savings adjustment that is appropriate for @var{date} in | 17600 | daylight saving adjustment that is appropriate for @var{date} in |
| 17597 | time zone @var{zone}. If @var{zone} is explicitly in or not in | 17601 | time zone @var{zone}. If @var{zone} is explicitly in or not in |
| 17598 | daylight savings time (e.g., @code{PDT} or @code{PST}) the | 17602 | daylight saving time (e.g., @code{PDT} or @code{PST}) the |
| 17599 | @var{date} is ignored. If @var{zone} is a generalized time zone, | 17603 | @var{date} is ignored. If @var{zone} is a generalized time zone, |
| 17600 | the algorithms described above are used. If @var{zone} is omitted, | 17604 | the algorithms described above are used. If @var{zone} is omitted, |
| 17601 | the computation is done for the current time zone. | 17605 | the computation is done for the current time zone. |
diff --git a/man/calendar.texi b/man/calendar.texi index 812bde03b2f..11b24f7c210 100644 --- a/man/calendar.texi +++ b/man/calendar.texi | |||
| @@ -43,7 +43,7 @@ about more specialized features. | |||
| 43 | * Diary:: Displaying events from your diary. | 43 | * Diary:: Displaying events from your diary. |
| 44 | * Appointments:: Reminders when it's time to do something. | 44 | * Appointments:: Reminders when it's time to do something. |
| 45 | * Importing Diary:: Converting diary events to/from other formats. | 45 | * Importing Diary:: Converting diary events to/from other formats. |
| 46 | * Daylight Savings:: How to specify when daylight savings time is active. | 46 | * Daylight Saving:: How to specify when daylight saving time is active. |
| 47 | * Time Intervals:: Keeping track of time intervals. | 47 | * Time Intervals:: Keeping track of time intervals. |
| 48 | @ifnottex | 48 | @ifnottex |
| 49 | * Advanced Calendar/Diary Usage:: Advanced Calendar/Diary customization. | 49 | * Advanced Calendar/Diary Usage:: Advanced Calendar/Diary customization. |
| @@ -604,8 +604,8 @@ Time (Greenwich time). The values of | |||
| 604 | @code{calendar-standard-time-zone-name} and | 604 | @code{calendar-standard-time-zone-name} and |
| 605 | @code{calendar-daylight-time-zone-name} are the abbreviations used in | 605 | @code{calendar-daylight-time-zone-name} are the abbreviations used in |
| 606 | your time zone. Emacs displays the times of sunrise and sunset | 606 | your time zone. Emacs displays the times of sunrise and sunset |
| 607 | @emph{corrected for daylight savings time}. @xref{Daylight Savings}, | 607 | @emph{corrected for daylight saving time}. @xref{Daylight Saving}, |
| 608 | for how daylight savings time is determined. | 608 | for how daylight saving time is determined. |
| 609 | 609 | ||
| 610 | As a user, you might find it convenient to set the calendar location | 610 | As a user, you might find it convenient to set the calendar location |
| 611 | variables for your usual physical location in your @file{.emacs} file. | 611 | variables for your usual physical location in your @file{.emacs} file. |
| @@ -646,9 +646,9 @@ month, use @kbd{C-u M-x phases-of-moon}, which prompts for the month and | |||
| 646 | year. | 646 | year. |
| 647 | 647 | ||
| 648 | The dates and times given for the phases of the moon are given in | 648 | The dates and times given for the phases of the moon are given in |
| 649 | local time (corrected for daylight savings, when appropriate); but if | 649 | local time (corrected for daylight saving, when appropriate); but if |
| 650 | the variable @code{calendar-time-zone} is void, Coordinated Universal | 650 | the variable @code{calendar-time-zone} is void, Coordinated Universal |
| 651 | Time (the Greenwich time zone) is used. @xref{Daylight Savings}. | 651 | Time (the Greenwich time zone) is used. @xref{Daylight Saving}. |
| 652 | 652 | ||
| 653 | @node Other Calendars | 653 | @node Other Calendars |
| 654 | @section Conversion To and From Other Calendars | 654 | @section Conversion To and From Other Calendars |
| @@ -1553,14 +1553,14 @@ Emacs diary file to iCalendar format. To export only a part of a diary | |||
| 1553 | file, mark the relevant area, and call @code{icalendar-export-region}. | 1553 | file, mark the relevant area, and call @code{icalendar-export-region}. |
| 1554 | In both cases the result is appended to the target file. | 1554 | In both cases the result is appended to the target file. |
| 1555 | 1555 | ||
| 1556 | @node Daylight Savings | 1556 | @node Daylight Saving |
| 1557 | @section Daylight Savings Time | 1557 | @section Daylight Saving Time |
| 1558 | @cindex daylight savings time | 1558 | @cindex daylight saving time |
| 1559 | 1559 | ||
| 1560 | Emacs understands the difference between standard time and daylight | 1560 | Emacs understands the difference between standard time and daylight |
| 1561 | savings time---the times given for sunrise, sunset, solstices, | 1561 | saving time---the times given for sunrise, sunset, solstices, |
| 1562 | equinoxes, and the phases of the moon take that into account. The rules | 1562 | equinoxes, and the phases of the moon take that into account. The rules |
| 1563 | for daylight savings time vary from place to place and have also varied | 1563 | for daylight saving time vary from place to place and have also varied |
| 1564 | historically from year to year. To do the job properly, Emacs needs to | 1564 | historically from year to year. To do the job properly, Emacs needs to |
| 1565 | know which rules to use. | 1565 | know which rules to use. |
| 1566 | 1566 | ||
| @@ -1577,12 +1577,12 @@ you can tell Emacs the rules to use by setting certain variables: | |||
| 1577 | 1577 | ||
| 1578 | These values should be Lisp expressions that refer to the variable | 1578 | These values should be Lisp expressions that refer to the variable |
| 1579 | @code{year}, and evaluate to the Gregorian date on which daylight | 1579 | @code{year}, and evaluate to the Gregorian date on which daylight |
| 1580 | savings time starts or (respectively) ends, in the form of a list | 1580 | saving time starts or (respectively) ends, in the form of a list |
| 1581 | @code{(@var{month} @var{day} @var{year})}. The values should be | 1581 | @code{(@var{month} @var{day} @var{year})}. The values should be |
| 1582 | @code{nil} if your area does not use daylight savings time. | 1582 | @code{nil} if your area does not use daylight saving time. |
| 1583 | 1583 | ||
| 1584 | Emacs uses these expressions to determine the starting date of | 1584 | Emacs uses these expressions to determine the starting date of |
| 1585 | daylight savings time for the holiday list and for correcting times of | 1585 | daylight saving time for the holiday list and for correcting times of |
| 1586 | day in the solar and lunar calculations. | 1586 | day in the solar and lunar calculations. |
| 1587 | 1587 | ||
| 1588 | The values for Cambridge, Massachusetts are as follows: | 1588 | The values for Cambridge, Massachusetts are as follows: |
| @@ -1595,7 +1595,7 @@ day in the solar and lunar calculations. | |||
| 1595 | @noindent | 1595 | @noindent |
| 1596 | That is, the second 0th day (Sunday) of the third month (March) in | 1596 | That is, the second 0th day (Sunday) of the third month (March) in |
| 1597 | the year specified by @code{year}, and the first Sunday of the eleventh month | 1597 | the year specified by @code{year}, and the first Sunday of the eleventh month |
| 1598 | (November) of that year. If daylight savings time were | 1598 | (November) of that year. If daylight saving time were |
| 1599 | changed to start on October 1, you would set | 1599 | changed to start on October 1, you would set |
| 1600 | @code{calendar-daylight-savings-starts} to this: | 1600 | @code{calendar-daylight-savings-starts} to this: |
| 1601 | 1601 | ||
| @@ -1603,13 +1603,13 @@ changed to start on October 1, you would set | |||
| 1603 | (list 10 1 year) | 1603 | (list 10 1 year) |
| 1604 | @end example | 1604 | @end example |
| 1605 | 1605 | ||
| 1606 | If there is no daylight savings time at your location, or if you want | 1606 | If there is no daylight saving time at your location, or if you want |
| 1607 | all times in standard time, set @code{calendar-daylight-savings-starts} | 1607 | all times in standard time, set @code{calendar-daylight-savings-starts} |
| 1608 | and @code{calendar-daylight-savings-ends} to @code{nil}. | 1608 | and @code{calendar-daylight-savings-ends} to @code{nil}. |
| 1609 | 1609 | ||
| 1610 | @vindex calendar-daylight-time-offset | 1610 | @vindex calendar-daylight-time-offset |
| 1611 | The variable @code{calendar-daylight-time-offset} specifies the | 1611 | The variable @code{calendar-daylight-time-offset} specifies the |
| 1612 | difference between daylight savings time and standard time, measured in | 1612 | difference between daylight saving time and standard time, measured in |
| 1613 | minutes. The value for Cambridge, Massachusetts is 60. | 1613 | minutes. The value for Cambridge, Massachusetts is 60. |
| 1614 | 1614 | ||
| 1615 | @c @vindex calendar-daylight-savings-starts-time too long! | 1615 | @c @vindex calendar-daylight-savings-starts-time too long! |
| @@ -1617,7 +1617,7 @@ minutes. The value for Cambridge, Massachusetts is 60. | |||
| 1617 | The two variables @code{calendar-daylight-savings-starts-time} and | 1617 | The two variables @code{calendar-daylight-savings-starts-time} and |
| 1618 | @code{calendar-daylight-savings-ends-time} specify the number of minutes | 1618 | @code{calendar-daylight-savings-ends-time} specify the number of minutes |
| 1619 | after midnight local time when the transition to and from daylight | 1619 | after midnight local time when the transition to and from daylight |
| 1620 | savings time should occur. For Cambridge, Massachusetts both variables' | 1620 | saving time should occur. For Cambridge, Massachusetts both variables' |
| 1621 | values are 120. | 1621 | values are 120. |
| 1622 | 1622 | ||
| 1623 | @node Time Intervals | 1623 | @node Time Intervals |
diff --git a/man/cc-mode.texi b/man/cc-mode.texi index 05b7df18b47..d3996eff5c7 100644 --- a/man/cc-mode.texi +++ b/man/cc-mode.texi | |||
| @@ -6701,7 +6701,7 @@ this hack can degrade performance by about as much. Thus this variable | |||
| 6701 | is set to @code{nil} by default, since the Emacs-friendly styles should | 6701 | is set to @code{nil} by default, since the Emacs-friendly styles should |
| 6702 | be more common (and encouraged!). Note that this variable has no effect | 6702 | be more common (and encouraged!). Note that this variable has no effect |
| 6703 | in Emacs since the necessary built-in functions don't exist (in Emacs | 6703 | in Emacs since the necessary built-in functions don't exist (in Emacs |
| 6704 | 21.3 as of this writing in May 2003). | 6704 | 22.1 as of this writing in February 2007). |
| 6705 | 6705 | ||
| 6706 | Text properties are used to speed up skipping over syntactic whitespace, | 6706 | Text properties are used to speed up skipping over syntactic whitespace, |
| 6707 | i.e. comments and preprocessor directives. Indenting a line after a | 6707 | i.e. comments and preprocessor directives. Indenting a line after a |
diff --git a/man/custom.texi b/man/custom.texi index 40eefba1ba3..40a0f8d0b2c 100644 --- a/man/custom.texi +++ b/man/custom.texi | |||
| @@ -1247,7 +1247,7 @@ processes @code{eval} variables. The three possibilities for the | |||
| 1247 | variable's value are @code{t}, @code{nil}, and anything else, just as | 1247 | variable's value are @code{t}, @code{nil}, and anything else, just as |
| 1248 | for @code{enable-local-variables}. The default is @code{maybe}, which | 1248 | for @code{enable-local-variables}. The default is @code{maybe}, which |
| 1249 | is neither @code{t} nor @code{nil}, so normally Emacs does ask for | 1249 | is neither @code{t} nor @code{nil}, so normally Emacs does ask for |
| 1250 | confirmation about processes @code{eval} variables. | 1250 | confirmation about processing @code{eval} variables. |
| 1251 | 1251 | ||
| 1252 | @vindex safe-local-eval-forms | 1252 | @vindex safe-local-eval-forms |
| 1253 | But there is an exception. The @code{safe-local-eval-forms} is a | 1253 | But there is an exception. The @code{safe-local-eval-forms} is a |
diff --git a/man/emacs.texi b/man/emacs.texi index 2aadc673248..39416158341 100644 --- a/man/emacs.texi +++ b/man/emacs.texi | |||
| @@ -5,7 +5,7 @@ | |||
| 5 | 5 | ||
| 6 | @c The edition number appears in several places in this file | 6 | @c The edition number appears in several places in this file |
| 7 | @set EDITION Sixteenth | 7 | @set EDITION Sixteenth |
| 8 | @set EMACSVER 22.0.95 | 8 | @set EMACSVER 22.0.96 |
| 9 | 9 | ||
| 10 | @copying | 10 | @copying |
| 11 | This is the @value{EDITION} edition of the @cite{GNU Emacs Manual}, | 11 | This is the @value{EDITION} edition of the @cite{GNU Emacs Manual}, |
| @@ -812,7 +812,7 @@ The Calendar and the Diary | |||
| 812 | * Diary:: Displaying events from your diary. | 812 | * Diary:: Displaying events from your diary. |
| 813 | * Appointments:: Reminders when it's time to do something. | 813 | * Appointments:: Reminders when it's time to do something. |
| 814 | * Importing Diary:: Converting diary events to/from other formats. | 814 | * Importing Diary:: Converting diary events to/from other formats. |
| 815 | * Daylight Savings:: How to specify when daylight savings time is active. | 815 | * Daylight Saving:: How to specify when daylight saving time is active. |
| 816 | * Time Intervals:: Keeping track of time intervals. | 816 | * Time Intervals:: Keeping track of time intervals. |
| 817 | * Advanced Calendar/Diary Usage:: Advanced Calendar/Diary customization. | 817 | * Advanced Calendar/Diary Usage:: Advanced Calendar/Diary customization. |
| 818 | 818 | ||
diff --git a/man/eshell.texi b/man/eshell.texi index 68ca49ee440..47f76a1d69a 100644 --- a/man/eshell.texi +++ b/man/eshell.texi | |||
| @@ -474,8 +474,8 @@ find this package useful! | |||
| 474 | @cindex known bugs | 474 | @cindex known bugs |
| 475 | @cindex bugs, known | 475 | @cindex bugs, known |
| 476 | 476 | ||
| 477 | Below is complete list of known problems with Eshell version 2.4.1, | 477 | Below is complete list of known problems with Eshell version 2.4.2, |
| 478 | which is the version included with Emacs 21.1. | 478 | which is the version included with Emacs 22. |
| 479 | 479 | ||
| 480 | @table @asis | 480 | @table @asis |
| 481 | @item Documentation incomplete | 481 | @item Documentation incomplete |
diff --git a/man/faq.texi b/man/faq.texi index b800ffac69a..a8feffa46e4 100644 --- a/man/faq.texi +++ b/man/faq.texi | |||
| @@ -1147,39 +1147,40 @@ and on @code{xterm} with @kbd{emacs -nw}. | |||
| 1147 | @cindex Recently introduced features | 1147 | @cindex Recently introduced features |
| 1148 | 1148 | ||
| 1149 | @cindex Default features | 1149 | @cindex Default features |
| 1150 | Font Lock mode, auto-compression mode, and file name shadow mode are now | 1150 | Font Lock mode, auto-compression mode, and file name shadow mode are |
| 1151 | enabled by default. On graphics displays it is now possible to follow | 1151 | enabled by default. On graphics displays it is possible to follow links |
| 1152 | links with @kbd{mouse-1}, and the modeline of the selected window is now | 1152 | with @kbd{mouse-1}. The modeline of the selected window is now |
| 1153 | highlighted. Window fringes are now customizable. The minibuffer | 1153 | highlighted. Window fringes are customizable. The minibuffer prompt is |
| 1154 | prompt is now displayed in a distinct face. | 1154 | displayed in a distinct face. |
| 1155 | 1155 | ||
| 1156 | Emacs now reads abbrev definitions automatically at startup. The | 1156 | Emacs now reads abbrev definitions automatically at startup. The |
| 1157 | maximum size of buffers has been doubled and is now 256M on 32-bit | 1157 | maximum size of buffers has been doubled and is 256M on 32-bit machines. |
| 1158 | machines. Grep mode is now separate from Compilation mode and has many | 1158 | Grep mode is separate from Compilation mode and has many new specific |
| 1159 | new specific options and commands. | 1159 | options and commands. |
| 1160 | 1160 | ||
| 1161 | The original Emacs macro system has been replaced by the new Kmacro | 1161 | The original Emacs macro system has been replaced by the new Kmacro |
| 1162 | package, which provides many new commands and features and a simple | 1162 | package, which provides many new commands and features and a simple |
| 1163 | interface that uses the function keys F3 and F4. Macros are now stored | 1163 | interface that uses the function keys F3 and F4. Macros are stored |
| 1164 | in a macro ring, and can be debugged and edited interactively. | 1164 | in a macro ring, and can be debugged and edited interactively. |
| 1165 | 1165 | ||
| 1166 | The GUD (Grand Unified Debugger) package can now be used with a full | 1166 | The GUD (Grand Unified Debugger) package can now be used with a full |
| 1167 | graphical user interface to the debugger which provides many features | 1167 | graphical user interface to the debugger which provides many features |
| 1168 | found in traditional development environments, making it easy to | 1168 | found in traditional development environments, making it easy to |
| 1169 | manipulate breakpoints, add watch points, display the call stack, etc. | 1169 | manipulate breakpoints, add watch points, display the call stack, etc. |
| 1170 | Breakpoints are now displayed in the source buffer. | 1170 | Breakpoints are displayed in the source buffer. |
| 1171 | 1171 | ||
| 1172 | @cindex GTK+ Toolkit | 1172 | @cindex GTK+ Toolkit |
| 1173 | @cindex Drag-and-drop | 1173 | @cindex Drag-and-drop |
| 1174 | @cindex Mouse wheel | 1174 | @cindex Mouse wheel |
| 1175 | Emacs can now be built with GTK+ widgets, and supports drag-and-drop | 1175 | Emacs can be built with GTK+ widgets, and supports drag-and-drop |
| 1176 | operation on X. Mouse wheel support is now enabled by default. | 1176 | operation on X. Mouse wheel support is enabled by default. |
| 1177 | 1177 | ||
| 1178 | @cindex New modes | 1178 | @cindex New modes |
| 1179 | Many new modes and packages have been included in Emacs, such as Calc, | 1179 | Many new modes and packages have been included in Emacs, such as MH-E, |
| 1180 | Tramp and URL, as well as IDO, CUA, rcirc, ERC, conf-mode, python-mode, | 1180 | Calc, Tramp and URL, as well as IDO, CUA, rcirc, ERC, conf-mode, |
| 1181 | table, tumme, SES, ruler, Flymake, Org, PGG, wdired, t-mouse, longlines, | 1181 | python-mode, table, tumme, SES, ruler, Flymake, Org, PGG, wdired, |
| 1182 | dns-mode, savehist, Password, Printing, Reveal, etc. | 1182 | t-mouse, longlines, dns-mode, savehist, Password, Printing, Reveal, etc. |
| 1183 | Gnus has been updated to version 5.11. | ||
| 1183 | 1184 | ||
| 1184 | @cindex Multilingual Environment | 1185 | @cindex Multilingual Environment |
| 1185 | Leim is now part of Emacs. Unicode support has been much improved, and | 1186 | Leim is now part of Emacs. Unicode support has been much improved, and |
diff --git a/man/gnus.texi b/man/gnus.texi index e2adfae2253..2ca1d225786 100644 --- a/man/gnus.texi +++ b/man/gnus.texi | |||
| @@ -11799,12 +11799,12 @@ still a pain, though. | |||
| 11799 | @cindex User-Agent | 11799 | @cindex User-Agent |
| 11800 | 11800 | ||
| 11801 | This variable controls which information should be exposed in the | 11801 | This variable controls which information should be exposed in the |
| 11802 | User-Agent header. It can be one of the symbols @code{gnus} (show only | 11802 | User-Agent header. It can be a list of symbols or a string. Valid |
| 11803 | Gnus version), @code{emacs-gnus} (show only Emacs and Gnus versions), | 11803 | symbols are @code{gnus} (show Gnus version) and @code{emacs} (show Emacs |
| 11804 | @code{emacs-gnus-config} (same as @code{emacs-gnus} plus system | 11804 | version). In addition to the Emacs version, you can add @code{codename} |
| 11805 | configuration), @code{emacs-gnus-type} (same as @code{emacs-gnus} plus | 11805 | (show (S)XEmacs codename) or either @code{config} (show system |
| 11806 | system type) or a custom string. If you set it to a string, be sure to | 11806 | configuration) or @code{type} (show system type). If you set it to a |
| 11807 | use a valid format, see RFC 2616. | 11807 | string, be sure to use a valid format, see RFC 2616. |
| 11808 | 11808 | ||
| 11809 | @end table | 11809 | @end table |
| 11810 | 11810 | ||
diff --git a/man/pgg.texi b/man/pgg.texi index f1b031a37b7..a9d3f6e16de 100644 --- a/man/pgg.texi +++ b/man/pgg.texi | |||
| @@ -272,7 +272,7 @@ tells @code{gpg-agent} use its own terminal to prompt for passphrases. | |||
| 272 | 272 | ||
| 273 | When @code{gpg-agent} is not being used, PGG prompts for a passphrase | 273 | When @code{gpg-agent} is not being used, PGG prompts for a passphrase |
| 274 | through Emacs. It also has its own passphrase caching mechanism, | 274 | through Emacs. It also has its own passphrase caching mechanism, |
| 275 | which is controlled by the variable @code{pgg-read-passphrase} (see | 275 | which is controlled by the variable @code{pgg-cache-passphrase} (see |
| 276 | below). | 276 | below). |
| 277 | 277 | ||
| 278 | There is a security risk in handling passphrases through PGG rather | 278 | There is a security risk in handling passphrases through PGG rather |