diff options
| author | Miles Bader | 2007-01-01 03:21:06 +0000 |
|---|---|---|
| committer | Miles Bader | 2007-01-01 03:21:06 +0000 |
| commit | 4c34eeeee5886d14f3e60b77fb563cb549c8896f (patch) | |
| tree | af17010f0864173dd6416585f08d686377791412 /man | |
| parent | 76acf92ebe73e35528c5966a21328305ba7b5aef (diff) | |
| parent | db6292445840e2795f35ebad62a14314fc3c7c21 (diff) | |
| download | emacs-4c34eeeee5886d14f3e60b77fb563cb549c8896f.tar.gz emacs-4c34eeeee5886d14f3e60b77fb563cb549c8896f.zip | |
Merge from emacs--devo--0
Patches applied:
* emacs--devo--0 (patch 563-582)
- Update from CVS
- Merge from gnus--rel--5.10
* gnus--rel--5.10 (patch 177-185)
- Merge from emacs--devo--0
- Update from CVS
Revision: emacs@sv.gnu.org/emacs--unicode--0--patch-158
Diffstat (limited to 'man')
| -rw-r--r-- | man/ChangeLog | 153 | ||||
| -rw-r--r-- | man/abbrevs.texi | 4 | ||||
| -rw-r--r-- | man/calc.texi | 3 | ||||
| -rw-r--r-- | man/calendar.texi | 33 | ||||
| -rw-r--r-- | man/cl.texi | 6 | ||||
| -rw-r--r-- | man/emacs.texi | 8 | ||||
| -rw-r--r-- | man/frames.texi | 88 | ||||
| -rw-r--r-- | man/gnus.texi | 112 | ||||
| -rw-r--r-- | man/killing.texi | 39 | ||||
| -rw-r--r-- | man/major.texi | 22 | ||||
| -rw-r--r-- | man/mark.texi | 2 | ||||
| -rw-r--r-- | man/msdog.texi | 42 | ||||
| -rw-r--r-- | man/pgg.texi | 21 | ||||
| -rw-r--r-- | man/programs.texi | 51 | ||||
| -rw-r--r-- | man/search.texi | 7 | ||||
| -rw-r--r-- | man/tramp.texi | 20 | ||||
| -rw-r--r-- | man/trampver.texi | 4 | ||||
| -rw-r--r-- | man/xresources.texi | 11 |
18 files changed, 481 insertions, 145 deletions
diff --git a/man/ChangeLog b/man/ChangeLog index 09eb469c53f..3e6fb6d8164 100644 --- a/man/ChangeLog +++ b/man/ChangeLog | |||
| @@ -1,3 +1,156 @@ | |||
| 1 | 2006-12-31 Kim F. Storm <storm@cua.dk> | ||
| 2 | |||
| 3 | * major.texi (Choosing Modes): Document auto-mode-case-fond. | ||
| 4 | |||
| 5 | 2006-12-30 Kim F. Storm <storm@cua.dk> | ||
| 6 | |||
| 7 | * killing.texi (CUA Bindings): Fix typo. | ||
| 8 | |||
| 9 | * xresources.texi (Table of Resources): Mention grow-only value for | ||
| 10 | auto-resize-tool-bars. | ||
| 11 | |||
| 12 | 2006-12-30 Michael Albinus <michael.albinus@gmx.de> | ||
| 13 | |||
| 14 | Sync with Tramp 2.0.55. | ||
| 15 | |||
| 16 | * trampver.texi: Update release number. | ||
| 17 | |||
| 18 | 2006-12-29 Reiner Steib <Reiner.Steib@gmx.de> | ||
| 19 | |||
| 20 | * gnus.texi (Customizing Articles): Add index entries for all | ||
| 21 | gnus-treat-* variables. | ||
| 22 | |||
| 23 | 2006-12-29 Jouni K. Sepp,Ad(Bnen <jks@iki.fi> | ||
| 24 | |||
| 25 | * gnus.texi (IMAP): Fix incorrect explanation of | ||
| 26 | nnimap-search-uids-not-since-is-evil in documentation for | ||
| 27 | nnimap-expunge-search-string. | ||
| 28 | |||
| 29 | 2006-12-27 Reiner Steib <Reiner.Steib@gmx.de> | ||
| 30 | |||
| 31 | * gnus.texi (ifile spam filtering): Rename spam-ifile-database-path to | ||
| 32 | spam-ifile-database. | ||
| 33 | |||
| 34 | 2006-12-26 Reiner Steib <Reiner.Steib@gmx.de> | ||
| 35 | |||
| 36 | * gnus.texi (Spam Package Configuration Examples): Don't encourage to | ||
| 37 | rebind C-s. | ||
| 38 | |||
| 39 | 2006-12-26 Jouni K. Sepp,Ad(Bnen <jks@iki.fi> | ||
| 40 | |||
| 41 | * gnus.texi (Group Parameters, Group Maintenance, Topic Commands) | ||
| 42 | (Mail Group Commands, Expiring Mail, IMAP): Add index entries for | ||
| 43 | "expiring mail". | ||
| 44 | (IMAP): Document nnimap-search-uids-not-since-is-evil and | ||
| 45 | nnimap-nov-is-evil. | ||
| 46 | |||
| 47 | 2006-12-27 Eli Zaretskii <eliz@gnu.org> | ||
| 48 | |||
| 49 | * msdog.texi (Windows Keyboard): Mention widespread Windows bindings, | ||
| 50 | and how to get them back. | ||
| 51 | |||
| 52 | 2006-12-26 Richard Stallman <rms@gnu.org> | ||
| 53 | |||
| 54 | * calendar.texi (Holidays): Holiday listing is based on current | ||
| 55 | practice, but DST is not. | ||
| 56 | |||
| 57 | 2006-12-25 Richard Stallman <rms@gnu.org> | ||
| 58 | |||
| 59 | * emacs.texi (Top): Update subnode menus. | ||
| 60 | |||
| 61 | * mark.texi (Transient Mark): Fix xref. | ||
| 62 | |||
| 63 | * killing.texi (Graphical Kill): Node deleted. | ||
| 64 | (Killing): Add xref to Cut and Paste. | ||
| 65 | (CUA Bindings): Update xref. | ||
| 66 | |||
| 67 | * frames.texi (Cut and Paste): New section to hold other nodes. | ||
| 68 | (Mouse Commands): Node demoted. | ||
| 69 | (Cut/Paste Other App): Split out from Mouse Commands. | ||
| 70 | (Word and Line Mouse): Likewise. | ||
| 71 | (Secondary Selection, Clipboard): Nodes demoted. | ||
| 72 | |||
| 73 | 2006-12-25 Kevin Ryde <user42@zip.com.au> | ||
| 74 | |||
| 75 | * cl.texi (Sorting Sequences): In sort*, add a little cautionary note | ||
| 76 | about the key procedure being used heavily. | ||
| 77 | |||
| 78 | 2006-12-24 Chong Yidong <cyd@stupidchicken.com> | ||
| 79 | |||
| 80 | * pgg.texi (Caching passphrase): Default for pgg-gpg-use-agent changed | ||
| 81 | to t. | ||
| 82 | (Prerequisites): Add explanation about gpg-agent. | ||
| 83 | |||
| 84 | 2006-12-24 Kevin Ryde <user42@zip.com.au> | ||
| 85 | |||
| 86 | * calendar.texi (Holidays): US daylight savings begins second Sunday | ||
| 87 | in March for 2007 onwards. | ||
| 88 | (Daylight Savings): Show new US default daylight savings rules, 2nd | ||
| 89 | Sun in Mar to 1st Sun in Nov, now in cal-dst.el. | ||
| 90 | |||
| 91 | 2006-12-23 Chong Yidong <cyd@stupidchicken.com> | ||
| 92 | |||
| 93 | * calendar.texi (Scroll Calendar): < and > are switched. | ||
| 94 | |||
| 95 | 2006-12-23 Kevin Rodgers <ihs_4664@yahoo.com> | ||
| 96 | |||
| 97 | * killing.texi (Deletion): Describe M-\ prefix argument. | ||
| 98 | |||
| 99 | 2006-12-23 Richard Stallman <rms@gnu.org> | ||
| 100 | |||
| 101 | * search.texi (Regexp Search): Explain why forward and reverse regexp | ||
| 102 | search are not mirror images. | ||
| 103 | |||
| 104 | 2006-12-22 Kevin Ryde <user42@zip.com.au> | ||
| 105 | |||
| 106 | * cl.texi (Sorting Sequences): Typo in sort*, example showed plain | ||
| 107 | "sort" instead of "sort*". | ||
| 108 | |||
| 109 | 2006-12-19 Richard Stallman <rms@gnu.org> | ||
| 110 | |||
| 111 | * calc.texi (History and Acknowledgements): Recognize that Emacs | ||
| 112 | now does have floating point. | ||
| 113 | |||
| 114 | 2006-12-19 Kim F. Storm <storm@cua.dk> | ||
| 115 | |||
| 116 | * major.texi (Choosing Modes): Describe match-function elements for | ||
| 117 | magic-mode-alist. | ||
| 118 | |||
| 119 | 2006-12-19 Michael Albinus <michael.albinus@gmx.de> | ||
| 120 | |||
| 121 | * tramp.texi (External transfer methods): Describe new method `scpc'. | ||
| 122 | |||
| 123 | 2006-12-18 Eli Zaretskii <eliz@gnu.org> | ||
| 124 | |||
| 125 | * msdog.texi (Windows Keyboard): Add a footnote about "Windows" keys | ||
| 126 | peculiarities. | ||
| 127 | |||
| 128 | 2006-12-18 Richard Stallman <rms@gnu.org> | ||
| 129 | |||
| 130 | * abbrevs.texi (Editing Abbrevs): Fix previous change. | ||
| 131 | |||
| 132 | 2006-12-17 Sascha Wilde <wilde@sha-bang.de> | ||
| 133 | |||
| 134 | * pgg.texi: Added short note on gpg-agent to the introduction. | ||
| 135 | |||
| 136 | 2006-12-17 Alan Mackenzie <acm@muc.de> | ||
| 137 | |||
| 138 | * programs.texi (Left Margin Paren): Remove the bit which says | ||
| 139 | that CC Mode sets open-paren-in-column-0-is-defun-start to nil. | ||
| 140 | Discuss some of the issues of setting this option to nil. | ||
| 141 | |||
| 142 | 2006-12-17 Glenn Morris <rgm@gnu.org> | ||
| 143 | |||
| 144 | * abbrevs.texi (Editing Abbrevs): Mention system abbrevs. | ||
| 145 | |||
| 146 | 2006-12-16 Eli Zaretskii <eliz@gnu.org> | ||
| 147 | |||
| 148 | * msdog.texi (Windows Keyboard): Clarify `w32-recognize-altgr' effect. | ||
| 149 | (Windows Files): `w32-get-true-file-attributes' is only relevant for | ||
| 150 | NTFS volumes. | ||
| 151 | (ls in Lisp): `links' in `ls-lisp-verbosity' is only relevant to NTFS | ||
| 152 | volumes. | ||
| 153 | |||
| 1 | 2006-12-15 Eli Zaretskii <eliz@gnu.org> | 154 | 2006-12-15 Eli Zaretskii <eliz@gnu.org> |
| 2 | 155 | ||
| 3 | * text.texi (HTML Mode): Fix "C-c TAB". | 156 | * text.texi (HTML Mode): Fix "C-c TAB". |
diff --git a/man/abbrevs.texi b/man/abbrevs.texi index 0283b332976..bea460a9a61 100644 --- a/man/abbrevs.texi +++ b/man/abbrevs.texi | |||
| @@ -255,6 +255,10 @@ keeps track of this to help you see which abbrevs you actually use, so | |||
| 255 | that you can eliminate those that you don't use often. The string at | 255 | that you can eliminate those that you don't use often. The string at |
| 256 | the end of the line is the expansion. | 256 | the end of the line is the expansion. |
| 257 | 257 | ||
| 258 | Some abbrevs are marked with @samp{(sys)}. These ``system'' abbrevs | ||
| 259 | (@pxref{Abbrevs,,, elisp, The Emacs Lisp Reference Manual}) are | ||
| 260 | pre-defined by various modes, and are not saved to your abbrev file. | ||
| 261 | |||
| 258 | @findex edit-abbrevs | 262 | @findex edit-abbrevs |
| 259 | @kindex C-c C-c @r{(Edit Abbrevs)} | 263 | @kindex C-c C-c @r{(Edit Abbrevs)} |
| 260 | @kbd{M-x edit-abbrevs} allows you to add, change or kill abbrev | 264 | @kbd{M-x edit-abbrevs} allows you to add, change or kill abbrev |
diff --git a/man/calc.texi b/man/calc.texi index 6f3082fb776..d38becd46d9 100644 --- a/man/calc.texi +++ b/man/calc.texi | |||
| @@ -1539,7 +1539,8 @@ To make a long story short, Emacs Lisp turned out to be a distressingly | |||
| 1539 | solid implementation of Lisp, and the humble task of calculating | 1539 | solid implementation of Lisp, and the humble task of calculating |
| 1540 | turned out to be more open-ended than one might have expected. | 1540 | turned out to be more open-ended than one might have expected. |
| 1541 | 1541 | ||
| 1542 | Emacs Lisp doesn't have built-in floating point math, so it had to be | 1542 | Emacs Lisp didn't have built-in floating point math (now it does), so |
| 1543 | this had to be | ||
| 1543 | simulated in software. In fact, Emacs integers will only comfortably | 1544 | simulated in software. In fact, Emacs integers will only comfortably |
| 1544 | fit six decimal digits or so---not enough for a decent calculator. So | 1545 | fit six decimal digits or so---not enough for a decent calculator. So |
| 1545 | I had to write my own high-precision integer code as well, and once I had | 1546 | I had to write my own high-precision integer code as well, and once I had |
diff --git a/man/calendar.texi b/man/calendar.texi index 8b66cb6113e..45aec25be9b 100644 --- a/man/calendar.texi +++ b/man/calendar.texi | |||
| @@ -240,9 +240,9 @@ the months on it. Scrolling the calendar means moving the strip | |||
| 240 | horizontally, so that new months become visible in the window. | 240 | horizontally, so that new months become visible in the window. |
| 241 | 241 | ||
| 242 | @table @kbd | 242 | @table @kbd |
| 243 | @item < | ||
| 244 | Scroll calendar one month forward (@code{scroll-calendar-left}). | ||
| 245 | @item > | 243 | @item > |
| 244 | Scroll calendar one month forward (@code{scroll-calendar-left}). | ||
| 245 | @item < | ||
| 246 | Scroll calendar one month backward (@code{scroll-calendar-right}). | 246 | Scroll calendar one month backward (@code{scroll-calendar-right}). |
| 247 | @item C-v | 247 | @item C-v |
| 248 | @itemx @key{NEXT} | 248 | @itemx @key{NEXT} |
| @@ -254,16 +254,15 @@ Scroll calendar three months backward | |||
| 254 | (@code{scroll-calendar-right-three-months}). | 254 | (@code{scroll-calendar-right-three-months}). |
| 255 | @end table | 255 | @end table |
| 256 | 256 | ||
| 257 | @kindex < @r{(Calendar mode)} | ||
| 258 | @findex scroll-calendar-left | ||
| 259 | @kindex > @r{(Calendar mode)} | 257 | @kindex > @r{(Calendar mode)} |
| 258 | @findex scroll-calendar-left | ||
| 259 | @kindex < @r{(Calendar mode)} | ||
| 260 | @findex scroll-calendar-right | 260 | @findex scroll-calendar-right |
| 261 | The most basic calendar scroll commands scroll by one month at a | 261 | The most basic calendar scroll commands scroll by one month at a |
| 262 | time. This means that there are two months of overlap between the | 262 | time. This means that there are two months of overlap between the |
| 263 | display before the command and the display after. @kbd{<} scrolls | 263 | display before the command and the display after. @kbd{>} scrolls the |
| 264 | the calendar contents one month to the left; that is, it moves the | 264 | calendar contents one month forward in time. @kbd{<} scrolls the |
| 265 | display forward in time. @kbd{>} scrolls the contents to the | 265 | contents one month backwards in time. |
| 266 | right, which moves backwards in time. | ||
| 267 | 266 | ||
| 268 | @kindex C-v @r{(Calendar mode)} | 267 | @kindex C-v @r{(Calendar mode)} |
| 269 | @findex scroll-calendar-left-three-months | 268 | @findex scroll-calendar-left-three-months |
| @@ -527,12 +526,8 @@ categories of holidays. You can use this command even if you don't have | |||
| 527 | a calendar window. | 526 | a calendar window. |
| 528 | 527 | ||
| 529 | The dates used by Emacs for holidays are based on @emph{current | 528 | The dates used by Emacs for holidays are based on @emph{current |
| 530 | practice}, not historical fact. Historically, for instance, the start | 529 | practice}, not historical fact. For example Veteran's Day began in |
| 531 | of daylight savings time and even its existence have varied from year to | 530 | 1919, but is shown in earlier years. |
| 532 | year, but present United States law mandates that daylight savings time | ||
| 533 | begins on the first Sunday in April. When the daylight savings rules | ||
| 534 | are set up for the United States, Emacs always uses the present | ||
| 535 | definition, even though it is wrong for some prior years. | ||
| 536 | 531 | ||
| 537 | @node Sunrise/Sunset | 532 | @node Sunrise/Sunset |
| 538 | @section Times of Sunrise and Sunset | 533 | @section Times of Sunrise and Sunset |
| @@ -1593,14 +1588,14 @@ day in the solar and lunar calculations. | |||
| 1593 | The values for Cambridge, Massachusetts are as follows: | 1588 | The values for Cambridge, Massachusetts are as follows: |
| 1594 | 1589 | ||
| 1595 | @example | 1590 | @example |
| 1596 | (calendar-nth-named-day 1 0 4 year) | 1591 | (calendar-nth-named-day 2 0 3 year) |
| 1597 | (calendar-nth-named-day -1 0 10 year) | 1592 | (calendar-nth-named-day 1 0 11 year) |
| 1598 | @end example | 1593 | @end example |
| 1599 | 1594 | ||
| 1600 | @noindent | 1595 | @noindent |
| 1601 | That is, the first 0th day (Sunday) of the fourth month (April) in | 1596 | That is, the second 0th day (Sunday) of the third month (March) in |
| 1602 | the year specified by @code{year}, and the last Sunday of the tenth month | 1597 | the year specified by @code{year}, and the first Sunday of the eleventh month |
| 1603 | (October) of that year. If daylight savings time were | 1598 | (November) of that year. If daylight savings time were |
| 1604 | changed to start on October 1, you would set | 1599 | changed to start on October 1, you would set |
| 1605 | @code{calendar-daylight-savings-starts} to this: | 1600 | @code{calendar-daylight-savings-starts} to this: |
| 1606 | 1601 | ||
diff --git a/man/cl.texi b/man/cl.texi index 051aa18e02c..2c357f5fec6 100644 --- a/man/cl.texi +++ b/man/cl.texi | |||
| @@ -4086,13 +4086,15 @@ accepts a @code{:key} argument which is used to preprocess data | |||
| 4086 | fed to the @var{predicate} function. For example, | 4086 | fed to the @var{predicate} function. For example, |
| 4087 | 4087 | ||
| 4088 | @example | 4088 | @example |
| 4089 | (setq data (sort data 'string-lessp :key 'downcase)) | 4089 | (setq data (sort* data 'string-lessp :key 'downcase)) |
| 4090 | @end example | 4090 | @end example |
| 4091 | 4091 | ||
| 4092 | @noindent | 4092 | @noindent |
| 4093 | sorts @var{data}, a sequence of strings, into increasing alphabetical | 4093 | sorts @var{data}, a sequence of strings, into increasing alphabetical |
| 4094 | order without regard to case. A @code{:key} function of @code{car} | 4094 | order without regard to case. A @code{:key} function of @code{car} |
| 4095 | would be useful for sorting association lists. | 4095 | would be useful for sorting association lists. It should only be a |
| 4096 | simple accessor though, it's used heavily in the current | ||
| 4097 | implementation. | ||
| 4096 | 4098 | ||
| 4097 | The @code{sort*} function is destructive; it sorts lists by actually | 4099 | The @code{sort*} function is destructive; it sorts lists by actually |
| 4098 | rearranging the @code{cdr} pointers in suitable fashion. | 4100 | rearranging the @code{cdr} pointers in suitable fashion. |
diff --git a/man/emacs.texi b/man/emacs.texi index 76b77f38f8b..d8bb5e8d5dc 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.91 | 8 | @set EMACSVER 22.0.92 |
| 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}, |
| @@ -297,8 +297,6 @@ Killing and Moving Text | |||
| 297 | * Killing by Lines:: How to kill entire lines of text at one time. | 297 | * Killing by Lines:: How to kill entire lines of text at one time. |
| 298 | * Other Kill Commands:: Commands to kill large regions of text and | 298 | * Other Kill Commands:: Commands to kill large regions of text and |
| 299 | syntactic units such as words and sentences. | 299 | syntactic units such as words and sentences. |
| 300 | * Graphical Kill:: The kill ring on graphical displays: | ||
| 301 | yanking between applications. | ||
| 302 | * CUA Bindings:: Using @kbd{C-x}, @kbd{C-c}, @kbd{C-v} for copy | 300 | * CUA Bindings:: Using @kbd{C-x}, @kbd{C-c}, @kbd{C-v} for copy |
| 303 | and paste, with enhanced rectangle support. | 301 | and paste, with enhanced rectangle support. |
| 304 | 302 | ||
| @@ -441,9 +439,7 @@ Multiple Windows | |||
| 441 | 439 | ||
| 442 | Frames and X Windows | 440 | Frames and X Windows |
| 443 | 441 | ||
| 444 | * Mouse Commands:: Moving, cutting, and pasting, with the mouse. | 442 | * Cut and Paste:: Mouse commands for cut and paste. |
| 445 | * Secondary Selection:: Cutting without altering point and mark. | ||
| 446 | * Clipboard:: Using the clipboard for selections. | ||
| 447 | * Mouse References:: Using the mouse to select an item from a list. | 443 | * Mouse References:: Using the mouse to select an item from a list. |
| 448 | * Menu Mouse Clicks:: Mouse clicks that bring up menus. | 444 | * Menu Mouse Clicks:: Mouse clicks that bring up menus. |
| 449 | * Mode Line Mouse:: Mouse clicks on the mode line. | 445 | * Mode Line Mouse:: Mouse clicks on the mode line. |
diff --git a/man/frames.texi b/man/frames.texi index f3191014434..7d8fdbfd0ce 100644 --- a/man/frames.texi +++ b/man/frames.texi | |||
| @@ -34,11 +34,8 @@ so that you can use many of the features described in this chapter. | |||
| 34 | @xref{MS-DOS Mouse}. | 34 | @xref{MS-DOS Mouse}. |
| 35 | @end ifnottex | 35 | @end ifnottex |
| 36 | 36 | ||
| 37 | |||
| 38 | @menu | 37 | @menu |
| 39 | * Mouse Commands:: Moving, cutting, and pasting, with the mouse. | 38 | * Cut and Paste:: Mouse commands for cut and paste. |
| 40 | * Secondary Selection:: Cutting without altering point and mark. | ||
| 41 | * Clipboard:: Using the clipboard for selections. | ||
| 42 | * Mouse References:: Using the mouse to select an item from a list. | 39 | * Mouse References:: Using the mouse to select an item from a list. |
| 43 | * Menu Mouse Clicks:: Mouse clicks that bring up menus. | 40 | * Menu Mouse Clicks:: Mouse clicks that bring up menus. |
| 44 | * Mode Line Mouse:: Mouse clicks on the mode line. | 41 | * Mode Line Mouse:: Mouse clicks on the mode line. |
| @@ -60,8 +57,22 @@ so that you can use many of the features described in this chapter. | |||
| 60 | * Text-Only Mouse:: Using the mouse in text-only terminals. | 57 | * Text-Only Mouse:: Using the mouse in text-only terminals. |
| 61 | @end menu | 58 | @end menu |
| 62 | 59 | ||
| 60 | @node Cut and Paste | ||
| 61 | @section Killing and Yanking on Graphical Displays | ||
| 62 | |||
| 63 | This section describes facilities for selecting a region, killing, | ||
| 64 | and yanking using the mouse. | ||
| 65 | |||
| 66 | @menu | ||
| 67 | * Mouse Commands:: Moving, cutting, and pasting, with the mouse. | ||
| 68 | * Cut/Paste Other App:: Transfering text between Emacs and other apps. | ||
| 69 | * Word and Line Mouse:: Mouse commands for selecting whole words or lines. | ||
| 70 | * Secondary Selection:: Cutting without altering point and mark. | ||
| 71 | * Clipboard:: Using the clipboard for selections. | ||
| 72 | @end menu | ||
| 73 | |||
| 63 | @node Mouse Commands | 74 | @node Mouse Commands |
| 64 | @section Mouse Commands for Editing | 75 | @subsection Mouse Commands for Editing |
| 65 | @cindex mouse buttons (what they do) | 76 | @cindex mouse buttons (what they do) |
| 66 | 77 | ||
| 67 | The mouse commands for selecting and copying a region are mostly | 78 | The mouse commands for selecting and copying a region are mostly |
| @@ -154,27 +165,6 @@ entire words or lines. | |||
| 154 | 165 | ||
| 155 | If you use @kbd{Mouse-3} a second time consecutively, at the same place, | 166 | If you use @kbd{Mouse-3} a second time consecutively, at the same place, |
| 156 | that kills the region already selected. | 167 | that kills the region already selected. |
| 157 | |||
| 158 | @item Double-Mouse-1 | ||
| 159 | This key sets the region around the word which you click on. If you | ||
| 160 | click on a character with ``symbol'' syntax (such as underscore, in C | ||
| 161 | mode), it sets the region around the symbol surrounding that character. | ||
| 162 | |||
| 163 | If you click on a character with open-parenthesis or close-parenthesis | ||
| 164 | syntax, it sets the region around the parenthetical grouping | ||
| 165 | which that character starts or ends. If you click on a character with | ||
| 166 | string-delimiter syntax (such as a singlequote or doublequote in C), it | ||
| 167 | sets the region around the string constant (using heuristics to figure | ||
| 168 | out whether that character is the beginning or the end of it). | ||
| 169 | |||
| 170 | @item Double-Drag-Mouse-1 | ||
| 171 | This key selects a region made up of the words you drag across. | ||
| 172 | |||
| 173 | @item Triple-Mouse-1 | ||
| 174 | This key sets the region around the line you click on. | ||
| 175 | |||
| 176 | @item Triple-Drag-Mouse-1 | ||
| 177 | This key selects a region made up of the lines you drag across. | ||
| 178 | @end table | 168 | @end table |
| 179 | 169 | ||
| 180 | The simplest way to kill text with the mouse is to press @kbd{Mouse-1} | 170 | The simplest way to kill text with the mouse is to press @kbd{Mouse-1} |
| @@ -191,6 +181,20 @@ point. Then it does not matter where you click, or even which of the | |||
| 191 | frame's windows you click on. The default value is @code{nil}. This | 181 | frame's windows you click on. The default value is @code{nil}. This |
| 192 | variable also affects yanking the secondary selection. | 182 | variable also affects yanking the secondary selection. |
| 193 | 183 | ||
| 184 | @cindex Delete Selection mode | ||
| 185 | @cindex mode, Delete Selection | ||
| 186 | @findex delete-selection-mode | ||
| 187 | Many graphical applications follow the convention that insertion while text | ||
| 188 | is selected deletes the selected text. You can make Emacs behave this | ||
| 189 | way by enabling Delete Selection mode---with @kbd{M-x | ||
| 190 | delete-selection-mode} or using Custom. Another effect of this mode | ||
| 191 | is that @key{DEL}, @kbd{C-d} and some other keys, when a selection | ||
| 192 | exists, will kill the whole selection. It also enables Transient Mark | ||
| 193 | mode (@pxref{Transient Mark}). | ||
| 194 | |||
| 195 | @node Cut/Paste Other App | ||
| 196 | @subsection Cut and Paste with Other Window Applications | ||
| 197 | |||
| 194 | @cindex cutting | 198 | @cindex cutting |
| 195 | @cindex pasting | 199 | @cindex pasting |
| 196 | @cindex X cutting and pasting | 200 | @cindex X cutting and pasting |
| @@ -224,8 +228,36 @@ to yank, the kill ring contents are used. | |||
| 224 | system for selections, use @kbd{C-x @key{RET} x} or @kbd{C-x @key{RET} | 228 | system for selections, use @kbd{C-x @key{RET} x} or @kbd{C-x @key{RET} |
| 225 | X}. @xref{Communication Coding}. | 229 | X}. @xref{Communication Coding}. |
| 226 | 230 | ||
| 231 | @node Word and Line Mouse | ||
| 232 | @subsection Mouse Commands for Words and Lines | ||
| 233 | |||
| 234 | These variants of @kbd{Mouse-1} select entire words or lines at a time. | ||
| 235 | |||
| 236 | @table @kbd | ||
| 237 | @item Double-Mouse-1 | ||
| 238 | This key sets the region around the word which you click on. If you | ||
| 239 | click on a character with ``symbol'' syntax (such as underscore, in C | ||
| 240 | mode), it sets the region around the symbol surrounding that character. | ||
| 241 | |||
| 242 | If you click on a character with open-parenthesis or close-parenthesis | ||
| 243 | syntax, it sets the region around the parenthetical grouping | ||
| 244 | which that character starts or ends. If you click on a character with | ||
| 245 | string-delimiter syntax (such as a singlequote or doublequote in C), it | ||
| 246 | sets the region around the string constant (using heuristics to figure | ||
| 247 | out whether that character is the beginning or the end of it). | ||
| 248 | |||
| 249 | @item Double-Drag-Mouse-1 | ||
| 250 | This key selects a region made up of the words you drag across. | ||
| 251 | |||
| 252 | @item Triple-Mouse-1 | ||
| 253 | This key sets the region around the line you click on. | ||
| 254 | |||
| 255 | @item Triple-Drag-Mouse-1 | ||
| 256 | This key selects a region made up of the lines you drag across. | ||
| 257 | @end table | ||
| 258 | |||
| 227 | @node Secondary Selection | 259 | @node Secondary Selection |
| 228 | @section Secondary Selection | 260 | @subsection Secondary Selection |
| 229 | @cindex secondary selection | 261 | @cindex secondary selection |
| 230 | 262 | ||
| 231 | The @dfn{secondary selection} is another way of selecting text using | 263 | The @dfn{secondary selection} is another way of selecting text using |
| @@ -280,7 +312,7 @@ yanks at point. Then it does not matter precisely where you click; all | |||
| 280 | that matters is which window you click on. @xref{Mouse Commands}. | 312 | that matters is which window you click on. @xref{Mouse Commands}. |
| 281 | 313 | ||
| 282 | @node Clipboard | 314 | @node Clipboard |
| 283 | @section Using the Clipboard | 315 | @subsection Using the Clipboard |
| 284 | @cindex clipboard | 316 | @cindex clipboard |
| 285 | @vindex x-select-enable-clipboard | 317 | @vindex x-select-enable-clipboard |
| 286 | @findex menu-bar-enable-clipboard | 318 | @findex menu-bar-enable-clipboard |
diff --git a/man/gnus.texi b/man/gnus.texi index 7a83ea66a97..ea959671c06 100644 --- a/man/gnus.texi +++ b/man/gnus.texi | |||
| @@ -2810,6 +2810,7 @@ doesn't accept articles. | |||
| 2810 | 2810 | ||
| 2811 | @item auto-expire | 2811 | @item auto-expire |
| 2812 | @cindex auto-expire | 2812 | @cindex auto-expire |
| 2813 | @cindex expiring mail | ||
| 2813 | If the group parameter has an element that looks like @code{(auto-expire | 2814 | If the group parameter has an element that looks like @code{(auto-expire |
| 2814 | . t)}, all articles read will be marked as expirable. For an | 2815 | . t)}, all articles read will be marked as expirable. For an |
| 2815 | alternative approach, @pxref{Expiring Mail}. | 2816 | alternative approach, @pxref{Expiring Mail}. |
| @@ -2818,6 +2819,7 @@ See also @code{gnus-auto-expirable-newsgroups}. | |||
| 2818 | 2819 | ||
| 2819 | @item total-expire | 2820 | @item total-expire |
| 2820 | @cindex total-expire | 2821 | @cindex total-expire |
| 2822 | @cindex expiring mail | ||
| 2821 | If the group parameter has an element that looks like | 2823 | If the group parameter has an element that looks like |
| 2822 | @code{(total-expire . t)}, all read articles will be put through the | 2824 | @code{(total-expire . t)}, all read articles will be put through the |
| 2823 | expiry process, even if they are not marked as expirable. Use with | 2825 | expiry process, even if they are not marked as expirable. Use with |
| @@ -3407,6 +3409,7 @@ zombies. | |||
| 3407 | @item C-c C-x | 3409 | @item C-c C-x |
| 3408 | @kindex C-c C-x (Group) | 3410 | @kindex C-c C-x (Group) |
| 3409 | @findex gnus-group-expire-articles | 3411 | @findex gnus-group-expire-articles |
| 3412 | @cindex expiring mail | ||
| 3410 | Run all expirable articles in the current group through the expiry | 3413 | Run all expirable articles in the current group through the expiry |
| 3411 | process (if any) (@code{gnus-group-expire-articles}). That is, delete | 3414 | process (if any) (@code{gnus-group-expire-articles}). That is, delete |
| 3412 | all expirable articles in the group that have been around for a while. | 3415 | all expirable articles in the group that have been around for a while. |
| @@ -3415,6 +3418,7 @@ all expirable articles in the group that have been around for a while. | |||
| 3415 | @item C-c C-M-x | 3418 | @item C-c C-M-x |
| 3416 | @kindex C-c C-M-x (Group) | 3419 | @kindex C-c C-M-x (Group) |
| 3417 | @findex gnus-group-expire-all-groups | 3420 | @findex gnus-group-expire-all-groups |
| 3421 | @cindex expiring mail | ||
| 3418 | Run all expirable articles in all groups through the expiry process | 3422 | Run all expirable articles in all groups through the expiry process |
| 3419 | (@code{gnus-group-expire-all-groups}). | 3423 | (@code{gnus-group-expire-all-groups}). |
| 3420 | 3424 | ||
| @@ -3775,6 +3779,7 @@ sub-topics unless given a prefix. | |||
| 3775 | @item C-c C-x | 3779 | @item C-c C-x |
| 3776 | @kindex C-c C-x (Topic) | 3780 | @kindex C-c C-x (Topic) |
| 3777 | @findex gnus-topic-expire-articles | 3781 | @findex gnus-topic-expire-articles |
| 3782 | @cindex expiring mail | ||
| 3778 | Run all expirable articles in the current group or topic through the | 3783 | Run all expirable articles in the current group or topic through the |
| 3779 | expiry process (if any) | 3784 | expiry process (if any) |
| 3780 | (@code{gnus-topic-expire-articles}). (@pxref{Expiring Mail}). | 3785 | (@code{gnus-topic-expire-articles}). (@pxref{Expiring Mail}). |
| @@ -10060,6 +10065,7 @@ process/prefix convention (@pxref{Process/Prefix}). | |||
| 10060 | @item B e | 10065 | @item B e |
| 10061 | @kindex B e (Summary) | 10066 | @kindex B e (Summary) |
| 10062 | @findex gnus-summary-expire-articles | 10067 | @findex gnus-summary-expire-articles |
| 10068 | @cindex expiring mail | ||
| 10063 | Run all expirable articles in the current group through the expiry | 10069 | Run all expirable articles in the current group through the expiry |
| 10064 | process (@code{gnus-summary-expire-articles}). That is, delete all | 10070 | process (@code{gnus-summary-expire-articles}). That is, delete all |
| 10065 | expirable articles in the group that have been around for a while. | 10071 | expirable articles in the group that have been around for a while. |
| @@ -10068,6 +10074,7 @@ expirable articles in the group that have been around for a while. | |||
| 10068 | @item B C-M-e | 10074 | @item B C-M-e |
| 10069 | @kindex B C-M-e (Summary) | 10075 | @kindex B C-M-e (Summary) |
| 10070 | @findex gnus-summary-expire-articles-now | 10076 | @findex gnus-summary-expire-articles-now |
| 10077 | @cindex expiring mail | ||
| 10071 | Delete all the expirable articles in the group | 10078 | Delete all the expirable articles in the group |
| 10072 | (@code{gnus-summary-expire-articles-now}). This means that @strong{all} | 10079 | (@code{gnus-summary-expire-articles-now}). This means that @strong{all} |
| 10073 | articles eligible for expiry in the current group will | 10080 | articles eligible for expiry in the current group will |
| @@ -11216,42 +11223,66 @@ group. Values in parenthesis are suggested sensible values. Others are | |||
| 11216 | possible but those listed are probably sufficient for most people. | 11223 | possible but those listed are probably sufficient for most people. |
| 11217 | 11224 | ||
| 11218 | @table @code | 11225 | @table @code |
| 11226 | @vindex gnus-treat-buttonize | ||
| 11219 | @item gnus-treat-buttonize (t, integer) | 11227 | @item gnus-treat-buttonize (t, integer) |
| 11228 | @vindex gnus-treat-buttonize-head | ||
| 11220 | @item gnus-treat-buttonize-head (head) | 11229 | @item gnus-treat-buttonize-head (head) |
| 11221 | 11230 | ||
| 11222 | @xref{Article Buttons}. | 11231 | @xref{Article Buttons}. |
| 11223 | 11232 | ||
| 11233 | @vindex gnus-treat-capitalize-sentences | ||
| 11224 | @item gnus-treat-capitalize-sentences (t, integer) | 11234 | @item gnus-treat-capitalize-sentences (t, integer) |
| 11235 | @vindex gnus-treat-overstrike | ||
| 11225 | @item gnus-treat-overstrike (t, integer) | 11236 | @item gnus-treat-overstrike (t, integer) |
| 11237 | @vindex gnus-treat-strip-cr | ||
| 11226 | @item gnus-treat-strip-cr (t, integer) | 11238 | @item gnus-treat-strip-cr (t, integer) |
| 11239 | @vindex gnus-treat-strip-headers-in-body | ||
| 11227 | @item gnus-treat-strip-headers-in-body (t, integer) | 11240 | @item gnus-treat-strip-headers-in-body (t, integer) |
| 11241 | @vindex gnus-treat-strip-leading-blank-lines | ||
| 11228 | @item gnus-treat-strip-leading-blank-lines (t, integer) | 11242 | @item gnus-treat-strip-leading-blank-lines (t, integer) |
| 11243 | @vindex gnus-treat-strip-multiple-blank-lines | ||
| 11229 | @item gnus-treat-strip-multiple-blank-lines (t, integer) | 11244 | @item gnus-treat-strip-multiple-blank-lines (t, integer) |
| 11245 | @vindex gnus-treat-strip-pem | ||
| 11230 | @item gnus-treat-strip-pem (t, last, integer) | 11246 | @item gnus-treat-strip-pem (t, last, integer) |
| 11247 | @vindex gnus-treat-strip-trailing-blank-lines | ||
| 11231 | @item gnus-treat-strip-trailing-blank-lines (t, last, integer) | 11248 | @item gnus-treat-strip-trailing-blank-lines (t, last, integer) |
| 11249 | @vindex gnus-treat-unsplit-urls | ||
| 11232 | @item gnus-treat-unsplit-urls (t, integer) | 11250 | @item gnus-treat-unsplit-urls (t, integer) |
| 11251 | @vindex gnus-treat-wash-html | ||
| 11233 | @item gnus-treat-wash-html (t, integer) | 11252 | @item gnus-treat-wash-html (t, integer) |
| 11234 | 11253 | ||
| 11235 | @xref{Article Washing}. | 11254 | @xref{Article Washing}. |
| 11236 | 11255 | ||
| 11256 | @vindex gnus-treat-date-english | ||
| 11237 | @item gnus-treat-date-english (head) | 11257 | @item gnus-treat-date-english (head) |
| 11258 | @vindex gnus-treat-date-iso8601 | ||
| 11238 | @item gnus-treat-date-iso8601 (head) | 11259 | @item gnus-treat-date-iso8601 (head) |
| 11260 | @vindex gnus-treat-date-lapsed | ||
| 11239 | @item gnus-treat-date-lapsed (head) | 11261 | @item gnus-treat-date-lapsed (head) |
| 11262 | @vindex gnus-treat-date-local | ||
| 11240 | @item gnus-treat-date-local (head) | 11263 | @item gnus-treat-date-local (head) |
| 11264 | @vindex gnus-treat-date-original | ||
| 11241 | @item gnus-treat-date-original (head) | 11265 | @item gnus-treat-date-original (head) |
| 11266 | @vindex gnus-treat-date-user-defined | ||
| 11242 | @item gnus-treat-date-user-defined (head) | 11267 | @item gnus-treat-date-user-defined (head) |
| 11268 | @vindex gnus-treat-date-ut | ||
| 11243 | @item gnus-treat-date-ut (head) | 11269 | @item gnus-treat-date-ut (head) |
| 11244 | 11270 | ||
| 11245 | @xref{Article Date}. | 11271 | @xref{Article Date}. |
| 11246 | 11272 | ||
| 11273 | @vindex gnus-treat-from-picon | ||
| 11247 | @item gnus-treat-from-picon (head) | 11274 | @item gnus-treat-from-picon (head) |
| 11275 | @vindex gnus-treat-mail-picon | ||
| 11248 | @item gnus-treat-mail-picon (head) | 11276 | @item gnus-treat-mail-picon (head) |
| 11277 | @vindex gnus-treat-newsgroups-picon | ||
| 11249 | @item gnus-treat-newsgroups-picon (head) | 11278 | @item gnus-treat-newsgroups-picon (head) |
| 11250 | 11279 | ||
| 11251 | @xref{Picons}. | 11280 | @xref{Picons}. |
| 11252 | 11281 | ||
| 11282 | @vindex gnus-treat-display-smileys | ||
| 11253 | @item gnus-treat-display-smileys (t, integer) | 11283 | @item gnus-treat-display-smileys (t, integer) |
| 11254 | 11284 | ||
| 11285 | @vindex gnus-treat-body-boundary | ||
| 11255 | @item gnus-treat-body-boundary (head) | 11286 | @item gnus-treat-body-boundary (head) |
| 11256 | 11287 | ||
| 11257 | @vindex gnus-body-boundary-delimiter | 11288 | @vindex gnus-body-boundary-delimiter |
| @@ -11260,40 +11291,62 @@ is controlled by @code{gnus-body-boundary-delimiter}. | |||
| 11260 | 11291 | ||
| 11261 | @xref{Smileys}. | 11292 | @xref{Smileys}. |
| 11262 | 11293 | ||
| 11294 | @vindex gnus-treat-display-x-face | ||
| 11263 | @item gnus-treat-display-x-face (head) | 11295 | @item gnus-treat-display-x-face (head) |
| 11264 | 11296 | ||
| 11265 | @xref{X-Face}. | 11297 | @xref{X-Face}. |
| 11266 | 11298 | ||
| 11299 | @vindex gnus-treat-display-face | ||
| 11267 | @item gnus-treat-display-face (head) | 11300 | @item gnus-treat-display-face (head) |
| 11268 | 11301 | ||
| 11269 | @xref{Face}. | 11302 | @xref{Face}. |
| 11270 | 11303 | ||
| 11304 | @vindex gnus-treat-emphasize | ||
| 11271 | @item gnus-treat-emphasize (t, head, integer) | 11305 | @item gnus-treat-emphasize (t, head, integer) |
| 11306 | @vindex gnus-treat-fill-article | ||
| 11272 | @item gnus-treat-fill-article (t, integer) | 11307 | @item gnus-treat-fill-article (t, integer) |
| 11308 | @vindex gnus-treat-fill-long-lines | ||
| 11273 | @item gnus-treat-fill-long-lines (t, integer) | 11309 | @item gnus-treat-fill-long-lines (t, integer) |
| 11310 | @vindex gnus-treat-hide-boring-headers | ||
| 11274 | @item gnus-treat-hide-boring-headers (head) | 11311 | @item gnus-treat-hide-boring-headers (head) |
| 11312 | @vindex gnus-treat-hide-citation | ||
| 11275 | @item gnus-treat-hide-citation (t, integer) | 11313 | @item gnus-treat-hide-citation (t, integer) |
| 11314 | @vindex gnus-treat-hide-citation-maybe | ||
| 11276 | @item gnus-treat-hide-citation-maybe (t, integer) | 11315 | @item gnus-treat-hide-citation-maybe (t, integer) |
| 11316 | @vindex gnus-treat-hide-headers | ||
| 11277 | @item gnus-treat-hide-headers (head) | 11317 | @item gnus-treat-hide-headers (head) |
| 11318 | @vindex gnus-treat-hide-signature | ||
| 11278 | @item gnus-treat-hide-signature (t, last) | 11319 | @item gnus-treat-hide-signature (t, last) |
| 11320 | @vindex gnus-treat-strip-banner | ||
| 11279 | @item gnus-treat-strip-banner (t, last) | 11321 | @item gnus-treat-strip-banner (t, last) |
| 11322 | @vindex gnus-treat-strip-list-identifiers | ||
| 11280 | @item gnus-treat-strip-list-identifiers (head) | 11323 | @item gnus-treat-strip-list-identifiers (head) |
| 11281 | 11324 | ||
| 11282 | @xref{Article Hiding}. | 11325 | @xref{Article Hiding}. |
| 11283 | 11326 | ||
| 11327 | @vindex gnus-treat-highlight-citation | ||
| 11284 | @item gnus-treat-highlight-citation (t, integer) | 11328 | @item gnus-treat-highlight-citation (t, integer) |
| 11329 | @vindex gnus-treat-highlight-headers | ||
| 11285 | @item gnus-treat-highlight-headers (head) | 11330 | @item gnus-treat-highlight-headers (head) |
| 11331 | @vindex gnus-treat-highlight-signature | ||
| 11286 | @item gnus-treat-highlight-signature (t, last, integer) | 11332 | @item gnus-treat-highlight-signature (t, last, integer) |
| 11287 | 11333 | ||
| 11288 | @xref{Article Highlighting}. | 11334 | @xref{Article Highlighting}. |
| 11289 | 11335 | ||
| 11336 | @vindex gnus-treat-play-sounds | ||
| 11290 | @item gnus-treat-play-sounds | 11337 | @item gnus-treat-play-sounds |
| 11338 | @vindex gnus-treat-translate | ||
| 11291 | @item gnus-treat-translate | 11339 | @item gnus-treat-translate |
| 11340 | @vindex gnus-treat-x-pgp-sig | ||
| 11292 | @item gnus-treat-x-pgp-sig (head) | 11341 | @item gnus-treat-x-pgp-sig (head) |
| 11293 | 11342 | ||
| 11343 | @vindex gnus-treat-unfold-headers | ||
| 11294 | @item gnus-treat-unfold-headers (head) | 11344 | @item gnus-treat-unfold-headers (head) |
| 11345 | @vindex gnus-treat-fold-headers | ||
| 11295 | @item gnus-treat-fold-headers (head) | 11346 | @item gnus-treat-fold-headers (head) |
| 11347 | @vindex gnus-treat-fold-newsgroups | ||
| 11296 | @item gnus-treat-fold-newsgroups (head) | 11348 | @item gnus-treat-fold-newsgroups (head) |
| 11349 | @vindex gnus-treat-leading-whitespace | ||
| 11297 | @item gnus-treat-leading-whitespace (head) | 11350 | @item gnus-treat-leading-whitespace (head) |
| 11298 | 11351 | ||
| 11299 | @xref{Article Header}. | 11352 | @xref{Article Header}. |
| @@ -14511,6 +14564,7 @@ using the new mail back end. | |||
| 14511 | @node Expiring Mail | 14564 | @node Expiring Mail |
| 14512 | @subsection Expiring Mail | 14565 | @subsection Expiring Mail |
| 14513 | @cindex article expiry | 14566 | @cindex article expiry |
| 14567 | @cindex expiring mail | ||
| 14514 | 14568 | ||
| 14515 | Traditional mail readers have a tendency to remove mail articles when | 14569 | Traditional mail readers have a tendency to remove mail articles when |
| 14516 | you mark them as read, in some way. Gnus takes a fundamentally | 14570 | you mark them as read, in some way. Gnus takes a fundamentally |
| @@ -16454,6 +16508,7 @@ as ticked for other users. | |||
| 16454 | @item nnimap-expunge-search-string | 16508 | @item nnimap-expunge-search-string |
| 16455 | @cindex expunging | 16509 | @cindex expunging |
| 16456 | @vindex nnimap-expunge-search-string | 16510 | @vindex nnimap-expunge-search-string |
| 16511 | @cindex expiring @acronym{IMAP} mail | ||
| 16457 | 16512 | ||
| 16458 | This variable contain the @acronym{IMAP} search command sent to server when | 16513 | This variable contain the @acronym{IMAP} search command sent to server when |
| 16459 | searching for articles eligible for expiring. The default is | 16514 | searching for articles eligible for expiring. The default is |
| @@ -16465,6 +16520,10 @@ Probably the only useful value to change this to is | |||
| 16465 | messages instead of the internal article date. See section 6.4.4 of | 16520 | messages instead of the internal article date. See section 6.4.4 of |
| 16466 | RFC 2060 for more information on valid strings. | 16521 | RFC 2060 for more information on valid strings. |
| 16467 | 16522 | ||
| 16523 | However, if @code{nnimap-search-uids-not-since-is-evil} | ||
| 16524 | is true, this variable has no effect since the search logic | ||
| 16525 | is reversed, as described below. | ||
| 16526 | |||
| 16468 | @item nnimap-authinfo-file | 16527 | @item nnimap-authinfo-file |
| 16469 | @vindex nnimap-authinfo-file | 16528 | @vindex nnimap-authinfo-file |
| 16470 | 16529 | ||
| @@ -16490,6 +16549,47 @@ Unselect mailboxes before looking for new mail in them. Some servers | |||
| 16490 | seem to need this under some circumstances; it was reported that | 16549 | seem to need this under some circumstances; it was reported that |
| 16491 | Courier 1.7.1 did. | 16550 | Courier 1.7.1 did. |
| 16492 | 16551 | ||
| 16552 | @item nnimap-nov-is-evil | ||
| 16553 | @vindex nnimap-nov-is-evil | ||
| 16554 | @cindex Courier @acronym{IMAP} server | ||
| 16555 | @cindex @acronym{NOV} | ||
| 16556 | |||
| 16557 | Never generate or use a local @acronym{NOV} database. Defaults to the | ||
| 16558 | value of @code{gnus-agent}. | ||
| 16559 | |||
| 16560 | Using a @acronym{NOV} database usually makes header fetching much | ||
| 16561 | faster, but it uses the @code{UID SEARCH UID} command, which is very | ||
| 16562 | slow on some servers (notably some versions of Courier). Since the Gnus | ||
| 16563 | Agent caches the information in the @acronym{NOV} database without using | ||
| 16564 | the slow command, this variable defaults to true if the Agent is in use, | ||
| 16565 | and false otherwise. | ||
| 16566 | |||
| 16567 | @item nnimap-search-uids-not-since-is-evil | ||
| 16568 | @vindex nnimap-search-uids-not-since-is-evil | ||
| 16569 | @cindex Courier @acronym{IMAP} server | ||
| 16570 | @cindex expiring @acronym{IMAP} mail | ||
| 16571 | |||
| 16572 | Avoid the @code{UID SEARCH UID @var{message numbers} NOT SINCE | ||
| 16573 | @var{date}} command, which is slow on some @acronym{IMAP} servers | ||
| 16574 | (notably, some versions of Courier). Instead, use @code{UID SEARCH SINCE | ||
| 16575 | @var{date}} and prune the list of expirable articles within Gnus. | ||
| 16576 | |||
| 16577 | When Gnus expires your mail (@pxref{Expiring Mail}), it starts with a | ||
| 16578 | list of expirable articles and asks the IMAP server questions like ``Of | ||
| 16579 | these articles, which ones are older than a week?'' While this seems | ||
| 16580 | like a perfectly reasonable question, some IMAP servers take a long time | ||
| 16581 | to answer it, since they seemingly go looking into every old article to | ||
| 16582 | see if it is one of the expirable ones. Curiously, the question ``Of | ||
| 16583 | @emph{all} articles, which ones are newer than a week?'' seems to be | ||
| 16584 | much faster to answer, so setting this variable causes Gnus to ask this | ||
| 16585 | question and figure out the answer to the real question itself. | ||
| 16586 | |||
| 16587 | This problem can really sneak up on you: when you first configure Gnus, | ||
| 16588 | everything works fine, but once you accumulate a couple thousand | ||
| 16589 | messages, you start cursing Gnus for being so slow. On the other hand, | ||
| 16590 | if you get a lot of email within a week, setting this variable will | ||
| 16591 | cause a lot of network traffic between Gnus and the IMAP server. | ||
| 16592 | |||
| 16493 | @end table | 16593 | @end table |
| 16494 | 16594 | ||
| 16495 | @menu | 16595 | @menu |
| @@ -16677,7 +16777,7 @@ splitting function that analyzes the body to split the article. | |||
| 16677 | 16777 | ||
| 16678 | @node Expiring in IMAP | 16778 | @node Expiring in IMAP |
| 16679 | @subsection Expiring in IMAP | 16779 | @subsection Expiring in IMAP |
| 16680 | @cindex expiring imap mail | 16780 | @cindex expiring @acronym{IMAP} mail |
| 16681 | 16781 | ||
| 16682 | Even though @code{nnimap} is not a proper @code{nnmail} derived back | 16782 | Even though @code{nnimap} is not a proper @code{nnmail} derived back |
| 16683 | end, it supports most features in regular expiring (@pxref{Expiring | 16783 | end, it supports most features in regular expiring (@pxref{Expiring |
| @@ -16696,6 +16796,9 @@ you to view client specific flags on the message. It also means that | |||
| 16696 | your server must support permanent storage of client specific flags on | 16796 | your server must support permanent storage of client specific flags on |
| 16697 | messages. Most do, fortunately. | 16797 | messages. Most do, fortunately. |
| 16698 | 16798 | ||
| 16799 | If expiring @acronym{IMAP} mail seems very slow, try setting the server | ||
| 16800 | variable @code{nnimap-search-uids-not-since-is-evil}. | ||
| 16801 | |||
| 16699 | @table @code | 16802 | @table @code |
| 16700 | 16803 | ||
| 16701 | @item nnmail-expiry-wait | 16804 | @item nnmail-expiry-wait |
| @@ -18605,7 +18708,7 @@ sense if you are using a nntp or nnimap back end. | |||
| 18605 | @findex gnus-agent-expire-group | 18708 | @findex gnus-agent-expire-group |
| 18606 | @cindex agent expiry | 18709 | @cindex agent expiry |
| 18607 | @cindex Gnus agent expiry | 18710 | @cindex Gnus agent expiry |
| 18608 | @cindex expiry | 18711 | @cindex expiry, in Gnus agent |
| 18609 | 18712 | ||
| 18610 | The Agent back end, @code{nnagent}, doesn't handle expiry. Well, at | 18713 | The Agent back end, @code{nnagent}, doesn't handle expiry. Well, at |
| 18611 | least it doesn't handle it like other back ends. Instead, there are | 18714 | least it doesn't handle it like other back ends. Instead, there are |
| @@ -23324,9 +23427,6 @@ From Ted Zlatanov <tzz@@lifelogs.com>. | |||
| 23324 | (gnus-registry-initialize) | 23427 | (gnus-registry-initialize) |
| 23325 | (spam-initialize) | 23428 | (spam-initialize) |
| 23326 | 23429 | ||
| 23327 | ;; @r{I like @kbd{C-s} for marking spam} | ||
| 23328 | (define-key gnus-summary-mode-map "\C-s" 'gnus-summary-mark-as-spam) | ||
| 23329 | |||
| 23330 | (setq | 23430 | (setq |
| 23331 | spam-log-to-registry t ; @r{for spam autodetection} | 23431 | spam-log-to-registry t ; @r{for spam autodetection} |
| 23332 | spam-use-BBDB t | 23432 | spam-use-BBDB t |
| @@ -23898,7 +23998,7 @@ The actual string used is irrelevant, but you probably want to leave | |||
| 23898 | the default value of @samp{spam}. | 23998 | the default value of @samp{spam}. |
| 23899 | @end defvar | 23999 | @end defvar |
| 23900 | 24000 | ||
| 23901 | @defvar spam-ifile-database-path | 24001 | @defvar spam-ifile-database |
| 23902 | 24002 | ||
| 23903 | This is the filename for the ifile database. It is not specified by | 24003 | This is the filename for the ifile database. It is not specified by |
| 23904 | default, so ifile will use its own default database name. | 24004 | default, so ifile will use its own default database name. |
diff --git a/man/killing.texi b/man/killing.texi index 4be77e2d6f8..396a76328aa 100644 --- a/man/killing.texi +++ b/man/killing.texi | |||
| @@ -56,14 +56,14 @@ an error message when this happens. But if you set the variable | |||
| 56 | @code{kill-read-only-ok} to a non-@code{nil} value, they just print a | 56 | @code{kill-read-only-ok} to a non-@code{nil} value, they just print a |
| 57 | message in the echo area to explain why the text has not been erased. | 57 | message in the echo area to explain why the text has not been erased. |
| 58 | 58 | ||
| 59 | You can also use the mouse to kill and yank. @xref{Cut and Paste}. | ||
| 60 | |||
| 59 | @menu | 61 | @menu |
| 60 | * Deletion:: Commands for deleting small amounts of text and | 62 | * Deletion:: Commands for deleting small amounts of text and |
| 61 | blank areas. | 63 | blank areas. |
| 62 | * Killing by Lines:: How to kill entire lines of text at one time. | 64 | * Killing by Lines:: How to kill entire lines of text at one time. |
| 63 | * Other Kill Commands:: Commands to kill large regions of text and | 65 | * Other Kill Commands:: Commands to kill large regions of text and |
| 64 | syntactic units such as words and sentences. | 66 | syntactic units such as words and sentences. |
| 65 | * Graphical Kill:: The kill ring on graphical displays: | ||
| 66 | yanking between applications. | ||
| 67 | @end menu | 67 | @end menu |
| 68 | 68 | ||
| 69 | @need 1500 | 69 | @need 1500 |
| @@ -148,10 +148,11 @@ enters Help instead, see @ref{DEL Does Not Delete}. | |||
| 148 | The other delete commands are those which delete only whitespace | 148 | The other delete commands are those which delete only whitespace |
| 149 | characters: spaces, tabs and newlines. @kbd{M-\} | 149 | characters: spaces, tabs and newlines. @kbd{M-\} |
| 150 | (@code{delete-horizontal-space}) deletes all the spaces and tab | 150 | (@code{delete-horizontal-space}) deletes all the spaces and tab |
| 151 | characters before and after point. @kbd{M-@key{SPC}} | 151 | characters before and after point. (With a prefix argument, it |
| 152 | deletes them before point, but not after.) @kbd{M-@key{SPC}} | ||
| 152 | (@code{just-one-space}) does likewise but leaves a single space after | 153 | (@code{just-one-space}) does likewise but leaves a single space after |
| 153 | point, regardless of the number of spaces that existed previously (even | 154 | point, regardless of the number of spaces that existed previously |
| 154 | if there were none before). With a numeric argument @var{n}, it | 155 | (even if there were none before). With a numeric argument @var{n}, it |
| 155 | leaves @var{n} spaces after point. | 156 | leaves @var{n} spaces after point. |
| 156 | 157 | ||
| 157 | @kbd{C-x C-o} (@code{delete-blank-lines}) deletes all blank lines | 158 | @kbd{C-x C-o} (@code{delete-blank-lines}) deletes all blank lines |
| @@ -250,28 +251,6 @@ and @kbd{M-d} (@pxref{Words}); balanced expressions, with @kbd{C-M-k} | |||
| 250 | (@pxref{Expressions}); and sentences, with @kbd{C-x @key{DEL}} and | 251 | (@pxref{Expressions}); and sentences, with @kbd{C-x @key{DEL}} and |
| 251 | @kbd{M-k} (@pxref{Sentences}).@refill | 252 | @kbd{M-k} (@pxref{Sentences}).@refill |
| 252 | 253 | ||
| 253 | @node Graphical Kill | ||
| 254 | @subsection Killing on Graphical Displays | ||
| 255 | |||
| 256 | On graphical displays with window systems, the most recent kill done | ||
| 257 | in Emacs is also the primary selection, if it is more recent than any | ||
| 258 | selection you made in another program. This means that the paste | ||
| 259 | commands of other window-based applications copy the text that you | ||
| 260 | killed in Emacs. In addition, Emacs yank commands treat other | ||
| 261 | applications' selections as part of the kill ring, so you can yank | ||
| 262 | them into Emacs. | ||
| 263 | |||
| 264 | @cindex Delete Selection mode | ||
| 265 | @cindex mode, Delete Selection | ||
| 266 | @findex delete-selection-mode | ||
| 267 | Many graphical applications follow the convention that insertion while text | ||
| 268 | is selected deletes the selected text. You can make Emacs behave this | ||
| 269 | way by enabling Delete Selection mode---with @kbd{M-x | ||
| 270 | delete-selection-mode} or using Custom. Another effect of this mode | ||
| 271 | is that @key{DEL}, @kbd{C-d} and some other keys, when a selection | ||
| 272 | exists, will kill the whole selection. It also enables Transient Mark | ||
| 273 | mode (@pxref{Transient Mark}). | ||
| 274 | |||
| 275 | @node Yanking, Accumulating Text, Killing, Top | 254 | @node Yanking, Accumulating Text, Killing, Top |
| 276 | @section Yanking | 255 | @section Yanking |
| 277 | @cindex moving text | 256 | @cindex moving text |
| @@ -668,14 +647,14 @@ applications. @kbd{C-x} means cut (kill), @kbd{C-c} copy, @kbd{C-v} | |||
| 668 | paste (yank), and @kbd{C-z} undo. Standard Emacs commands like | 647 | paste (yank), and @kbd{C-z} undo. Standard Emacs commands like |
| 669 | @kbd{C-x C-c} still work, because @kbd{C-x} and @kbd{C-c} only take | 648 | @kbd{C-x C-c} still work, because @kbd{C-x} and @kbd{C-c} only take |
| 670 | effect when the mark is active (and the region is highlighted). | 649 | effect when the mark is active (and the region is highlighted). |
| 671 | However, if you don't want to override these bindings Emacs at all, set | 650 | However, if you don't want to override these bindings in Emacs at all, |
| 672 | @code{cua-enable-cua-keys} to @code{nil}. | 651 | set @code{cua-enable-cua-keys} to @code{nil}. |
| 673 | 652 | ||
| 674 | In CUA mode, using @kbd{Shift} together with the movement keys | 653 | In CUA mode, using @kbd{Shift} together with the movement keys |
| 675 | activates and highlights the region over which they move. The | 654 | activates and highlights the region over which they move. The |
| 676 | standard (unshifted) movement keys deactivate the mark, and typed text | 655 | standard (unshifted) movement keys deactivate the mark, and typed text |
| 677 | replaces the active region as in Delete-Selection mode | 656 | replaces the active region as in Delete-Selection mode |
| 678 | (@pxref{Graphical Kill}). | 657 | (@pxref{Mouse Commands}). |
| 679 | 658 | ||
| 680 | To enter an Emacs command like @kbd{C-x C-f} while the mark is | 659 | To enter an Emacs command like @kbd{C-x C-f} while the mark is |
| 681 | active, use one of the following methods: either hold @kbd{Shift} | 660 | active, use one of the following methods: either hold @kbd{Shift} |
diff --git a/man/major.texi b/man/major.texi index d1f3fbaeebf..fe9416aacde 100644 --- a/man/major.texi +++ b/man/major.texi | |||
| @@ -102,17 +102,21 @@ the element has the form @code{(@var{regexp} @var{mode-function} | |||
| 102 | @vindex magic-mode-alist | 102 | @vindex magic-mode-alist |
| 103 | Sometimes the major mode is determined from the way the file's text | 103 | Sometimes the major mode is determined from the way the file's text |
| 104 | begins. The variable @code{magic-mode-alist} controls this. Its value | 104 | begins. The variable @code{magic-mode-alist} controls this. Its value |
| 105 | is a list of elements of this form: | 105 | is a list of elements of these forms: |
| 106 | 106 | ||
| 107 | @example | 107 | @example |
| 108 | (@var{regexp} . @var{mode-function}) | 108 | (@var{regexp} . @var{mode-function}) |
| 109 | (@var{match-function} . @var{mode-function}) | ||
| 109 | @end example | 110 | @end example |
| 110 | 111 | ||
| 111 | @noindent | 112 | @noindent |
| 112 | This looks like an element of @code{auto-mode-alist}, but it doesn't work | 113 | The first form looks like an element of @code{auto-mode-alist}, but it |
| 113 | the same: this @var{regexp} is matched against the text at the start | 114 | doesn't work the same: this @var{regexp} is matched against the text |
| 114 | of the buffer, not against the file name. @code{magic-mode-alist} | 115 | at the start of the buffer, not against the file name. Likewise, the |
| 115 | takes priority over @code{auto-mode-alist}. | 116 | second form calls @var{match-function} at the beginning of the buffer, |
| 117 | and if the function returns non-@code{nil}, the @var{mode-function} is | ||
| 118 | called. @code{magic-mode-alist} takes priority over | ||
| 119 | @code{auto-mode-alist}. | ||
| 116 | 120 | ||
| 117 | You can specify the major mode to use for editing a certain file by | 121 | You can specify the major mode to use for editing a certain file by |
| 118 | special text in the first nonblank line of the file. The | 122 | special text in the first nonblank line of the file. The |
| @@ -144,6 +148,14 @@ which allows you to specify local variables as well, like this: | |||
| 144 | @noindent | 148 | @noindent |
| 145 | @xref{File Variables}, for more information about this. | 149 | @xref{File Variables}, for more information about this. |
| 146 | 150 | ||
| 151 | @vindex auto-mode-case-fold | ||
| 152 | On systems with case-insensitive file names, only a single | ||
| 153 | case-insensitive search through the @code{auto-mode-alist} is made. | ||
| 154 | On other systems, Emacs normally performs a single case-sensitive | ||
| 155 | search through the alist, but if you set this variable to a | ||
| 156 | non-@code{nil} value, Emacs will perform a second case-insensitive | ||
| 157 | search if the first search fails. | ||
| 158 | |||
| 147 | @vindex interpreter-mode-alist | 159 | @vindex interpreter-mode-alist |
| 148 | When a file's contents begin with @samp{#!}, it can serve as an | 160 | When a file's contents begin with @samp{#!}, it can serve as an |
| 149 | executable shell command, which works by running an interpreter named on | 161 | executable shell command, which works by running an interpreter named on |
diff --git a/man/mark.texi b/man/mark.texi index e39800ab1b5..7cba4f0d004 100644 --- a/man/mark.texi +++ b/man/mark.texi | |||
| @@ -192,7 +192,7 @@ region active again by typing @kbd{C-x C-x}. | |||
| 192 | 192 | ||
| 193 | @item | 193 | @item |
| 194 | If Delete Selection mode is also enabled, some commands delete the | 194 | If Delete Selection mode is also enabled, some commands delete the |
| 195 | region when used while the mark is active. @xref{Graphical Kill}. | 195 | region when used while the mark is active. @xref{Mouse Commands}. |
| 196 | 196 | ||
| 197 | @item | 197 | @item |
| 198 | Quitting with @kbd{C-g} deactivates the mark. | 198 | Quitting with @kbd{C-g} deactivates the mark. |
diff --git a/man/msdog.texi b/man/msdog.texi index d92929ea04e..69126dca207 100644 --- a/man/msdog.texi +++ b/man/msdog.texi | |||
| @@ -173,9 +173,9 @@ default ignores letter-case in file names during completion. | |||
| 173 | @vindex w32-get-true-file-attributes | 173 | @vindex w32-get-true-file-attributes |
| 174 | If the variable @code{w32-get-true-file-attributes} is | 174 | If the variable @code{w32-get-true-file-attributes} is |
| 175 | non-@code{nil} (the default), Emacs tries to determine the accurate | 175 | non-@code{nil} (the default), Emacs tries to determine the accurate |
| 176 | link counts for files. This option is only useful on the NT family of | 176 | link counts for files. This option is only useful on NTFS volumes, |
| 177 | Windows (2K/XP/2K3), and it considerably slows down Dired and other | 177 | and it considerably slows down Dired and other features, so use it |
| 178 | features, so use it only on fast machines. | 178 | only on fast machines. |
| 179 | 179 | ||
| 180 | @node ls in Lisp | 180 | @node ls in Lisp |
| 181 | @section Emulation of @code{ls} on MS-Windows | 181 | @section Emulation of @code{ls} on MS-Windows |
| @@ -234,10 +234,11 @@ that @file{ls-lisp.el} displays. The value should be a list that | |||
| 234 | contains one or more of the symbols @code{links}, @code{uid}, and | 234 | contains one or more of the symbols @code{links}, @code{uid}, and |
| 235 | @code{gid}. @code{links} means display the count of different file | 235 | @code{gid}. @code{links} means display the count of different file |
| 236 | names that are associated with (a.k.a.@: @dfn{links to}) the file's | 236 | names that are associated with (a.k.a.@: @dfn{links to}) the file's |
| 237 | data. @code{uid} means display the numerical identifier of the user | 237 | data; this is only useful on NTFS volumes. @code{uid} means display |
| 238 | who owns the file. @code{gid} means display the numerical identifier | 238 | the numerical identifier of the user who owns the file. @code{gid} |
| 239 | of the file owner's group. The default value is @code{(links uid gid)} | 239 | means display the numerical identifier of the file owner's group. The |
| 240 | i.e.@: all the 3 optional attributes are displayed. | 240 | default value is @code{(links uid gid)} i.e.@: all the 3 optional |
| 241 | attributes are displayed. | ||
| 241 | 242 | ||
| 242 | @vindex ls-lisp-emulation | 243 | @vindex ls-lisp-emulation |
| 243 | The variable @code{ls-lisp-emulation} controls the flavour of the | 244 | The variable @code{ls-lisp-emulation} controls the flavour of the |
| @@ -332,6 +333,13 @@ directory, whereas @file{.emacs} does not. | |||
| 332 | This section describes the Windows-specific features related to | 333 | This section describes the Windows-specific features related to |
| 333 | keyboard input in Emacs. | 334 | keyboard input in Emacs. |
| 334 | 335 | ||
| 336 | @cindex MS-Windows keyboard shortcuts | ||
| 337 | Many key combinations (known as ``keyboard shortcuts'') that are in | ||
| 338 | widespread use in MS-Windows programs are taken by various Emacs | ||
| 339 | features. Examples include @kbd{C-C}, @kbd{C-X}, @kbd{C-Z}, | ||
| 340 | @kbd{C-A}, and @kbd{W-SPC}. You can get some of them back by turning | ||
| 341 | on CUA Mode (@pxref{CUA Bindings}). | ||
| 342 | |||
| 335 | @kindex F10 @r{(MS-Windows)} | 343 | @kindex F10 @r{(MS-Windows)} |
| 336 | @cindex menu bar access using keyboard @r{(MS-Windows)} | 344 | @cindex menu bar access using keyboard @r{(MS-Windows)} |
| 337 | The @key{F10} key on Windows activates the menu bar in a way that | 345 | The @key{F10} key on Windows activates the menu bar in a way that |
| @@ -420,16 +428,24 @@ keys are passed to Windows or swallowed by Emacs. If the value is | |||
| 420 | otherwise it is passed to Windows. The default is @code{t} for both | 428 | otherwise it is passed to Windows. The default is @code{t} for both |
| 421 | of these variables. Passing each of these keys to Windows produces | 429 | of these variables. Passing each of these keys to Windows produces |
| 422 | its normal effect: for example, @kbd{@key{Lwindow}} opens the | 430 | its normal effect: for example, @kbd{@key{Lwindow}} opens the |
| 423 | @code{Start} menu, etc. | 431 | @code{Start} menu, etc.@footnote{ |
| 432 | Some combinations of the ``Windows'' keys with other keys are caught | ||
| 433 | by Windows at low level in a way that Emacs currently cannot prevent. | ||
| 434 | For example, @kbd{@key{Lwindow} r} always pops up the Windows | ||
| 435 | @samp{Run} dialog. Customizing the value of | ||
| 436 | @code{w32-phantom-key-code} might help in some cases, though.} | ||
| 424 | 437 | ||
| 425 | @vindex w32-recognize-altgr | 438 | @vindex w32-recognize-altgr |
| 426 | @kindex AltGr @r{(MS-Windows)} | 439 | @kindex AltGr @r{(MS-Windows)} |
| 427 | @cindex AltGr key (MS-Windows) | 440 | @cindex AltGr key (MS-Windows) |
| 428 | The variable @code{w32-recognize-altgr} controls whether the right | 441 | The variable @code{w32-recognize-altgr} controls whether the |
| 429 | @key{Alt} and left @key{Ctrl} keys are recognized as the @key{AltGr} | 442 | @key{AltGr} key (if it exists on your keyboard), or its equivalent, |
| 430 | key. The default is @code{t}, which means these keys produce | 443 | the combination of the right @key{Alt} and left @key{Ctrl} keys |
| 431 | @code{AltGr}; setting them to @code{nil} causes these keys to be | 444 | pressed together, is recognized as the @key{AltGr} key. The default |
| 432 | interpreted normally (as the respective modifiers). | 445 | is @code{t}, which means these keys produce @code{AltGr}; setting it |
| 446 | to @code{nil} causes @key{AltGr} or the equivalent key combination to | ||
| 447 | be interpreted as the combination of @key{CTRL} and @key{META} | ||
| 448 | modifiers. | ||
| 433 | @end ifnottex | 449 | @end ifnottex |
| 434 | 450 | ||
| 435 | @node Windows Mouse | 451 | @node Windows Mouse |
diff --git a/man/pgg.texi b/man/pgg.texi index 23bcd5cbb1e..af97ddec45d 100644 --- a/man/pgg.texi +++ b/man/pgg.texi | |||
| @@ -74,10 +74,19 @@ PGG requires at least one implementation of privacy guard system. | |||
| 74 | This document assumes that you have already obtained and installed them | 74 | This document assumes that you have already obtained and installed them |
| 75 | and that you are familiar with its basic functions. | 75 | and that you are familiar with its basic functions. |
| 76 | 76 | ||
| 77 | By default, PGG uses GnuPG, but Pretty Good Privacy version 2 or version | 77 | By default, PGG uses GnuPG. If you are new to such a system, I |
| 78 | 5 are also supported. If you are new to such a system, I recommend that | 78 | recommend that you should look over the GNU Privacy Handbook (GPH) |
| 79 | you should look over the GNU Privacy Handbook (GPH) which is available | 79 | which is available at @uref{http://www.gnupg.org/documentation/}. |
| 80 | at @uref{http://www.gnupg.org/gph/}. | 80 | |
| 81 | When using GnuPG, we recommend the use of the @code{gpg-agent} | ||
| 82 | program, which is distributed with versions 2.0 and later of GnuPG. | ||
| 83 | This is a daemon to manage private keys independently from any | ||
| 84 | protocol, and provides the most secure way to input and cache your | ||
| 85 | passphrases (@pxref{Caching passphrase}). By default, PGG will | ||
| 86 | attempt to use @code{gpg-agent} if it is running. @xref{Invoking | ||
| 87 | GPG-AGENT,,,gnupg,Using the GNU Privacy Guard}. | ||
| 88 | |||
| 89 | PGG also supports Pretty Good Privacy version 2 or version 5. | ||
| 81 | 90 | ||
| 82 | @node How to use | 91 | @node How to use |
| 83 | @chapter How to use | 92 | @chapter How to use |
| @@ -238,8 +247,8 @@ Elapsed time for expiration in seconds. | |||
| 238 | When using GnuPG (gpg) as PGP scheme you can use @code{gpg-agent} for | 247 | When using GnuPG (gpg) as PGP scheme you can use @code{gpg-agent} for |
| 239 | caching@footnote{Actually @code{gpg-agent} does not cache passphrases | 248 | caching@footnote{Actually @code{gpg-agent} does not cache passphrases |
| 240 | but private keys. On the other hand, from a users point of view this | 249 | but private keys. On the other hand, from a users point of view this |
| 241 | technical difference isn't visible.}. If non-@code{nil} try to use a | 250 | technical difference isn't visible.}. It defaults to @code{t}. |
| 242 | running @code{gpg-agent}. It defaults to @code{nil}. | 251 | Setting this to @code{nil} is not recommended. |
| 243 | @end defvar | 252 | @end defvar |
| 244 | 253 | ||
| 245 | @node Default user identity | 254 | @node Default user identity |
diff --git a/man/programs.texi b/man/programs.texi index fb85e470f86..200c787cf08 100644 --- a/man/programs.texi +++ b/man/programs.texi | |||
| @@ -156,23 +156,11 @@ from Lisp, but in Emacs we use it for all languages. | |||
| 156 | @cindex open-parenthesis in leftmost column | 156 | @cindex open-parenthesis in leftmost column |
| 157 | @cindex ( in leftmost column | 157 | @cindex ( in leftmost column |
| 158 | Emacs assumes by default that any opening delimiter found at the | 158 | Emacs assumes by default that any opening delimiter found at the |
| 159 | left margin is the start of a top-level definition, or defun. You can | 159 | left margin is the start of a top-level definition, or defun. |
| 160 | override this default by setting this user option: | 160 | Therefore, @strong{don't put an opening delimiter at the left margin |
| 161 | 161 | unless it should have that significance}. For instance, never put an | |
| 162 | @defvar open-paren-in-column-0-is-defun-start | ||
| 163 | If this user option is set to @code{t} (the default), opening | ||
| 164 | parentheses or braces at column zero always start defuns. When it's | ||
| 165 | @code{nil}, defuns are found by searching for parens or braces at the | ||
| 166 | outermost level. Some major modes, including C and related modes, set | ||
| 167 | @code{open-paren-in-column-0-is-defun-start} buffer-locally to | ||
| 168 | @code{nil} | ||
| 169 | @end defvar | ||
| 170 | |||
| 171 | In modes where @code{open-paren-in-column-0-is-defun-start} is | ||
| 172 | @code{t}, @strong{don't put an opening delimiter at the left margin | ||
| 173 | unless it is a defun start}. For instance, never put an | ||
| 174 | open-parenthesis at the left margin in a Lisp file unless it is the | 162 | open-parenthesis at the left margin in a Lisp file unless it is the |
| 175 | start of a top-level list. | 163 | start of a top-level list. |
| 176 | 164 | ||
| 177 | If you don't follow this convention, not only will you have trouble | 165 | If you don't follow this convention, not only will you have trouble |
| 178 | when you explicitly use the commands for motion by defuns; other | 166 | when you explicitly use the commands for motion by defuns; other |
| @@ -182,10 +170,10 @@ mode (@pxref{Font Lock}). | |||
| 182 | 170 | ||
| 183 | The most likely problem case is when you want an opening delimiter | 171 | The most likely problem case is when you want an opening delimiter |
| 184 | at the start of a line inside a string. To avoid trouble, put an | 172 | at the start of a line inside a string. To avoid trouble, put an |
| 185 | escape character (@samp{\}, in Emacs Lisp, @samp{/} in some other Lisp | 173 | escape character (@samp{\}, in C and Emacs Lisp, @samp{/} in some |
| 186 | dialects) before the opening delimiter. This will not affect the | 174 | other Lisp dialects) before the opening delimiter. This will not |
| 187 | contents of the string, but will prevent that opening delimiter from | 175 | affect the contents of the string, but will prevent that opening |
| 188 | starting a defun. Here's an example: | 176 | delimiter from starting a defun. Here's an example: |
| 189 | 177 | ||
| 190 | @example | 178 | @example |
| 191 | (insert "Foo: | 179 | (insert "Foo: |
| @@ -197,6 +185,25 @@ starting a defun. Here's an example: | |||
| 197 | highlights confusing opening delimiters (those that ought to be | 185 | highlights confusing opening delimiters (those that ought to be |
| 198 | quoted) in bold red. | 186 | quoted) in bold red. |
| 199 | 187 | ||
| 188 | If you need to override this convention, you can so by setting this | ||
| 189 | user option: | ||
| 190 | |||
| 191 | @defvar open-paren-in-column-0-is-defun-start | ||
| 192 | If this user option is set to @code{t} (the default), opening | ||
| 193 | parentheses or braces at column zero always start defuns. When it's | ||
| 194 | @code{nil}, defuns are found by searching for parens or braces at the | ||
| 195 | outermost level. | ||
| 196 | @end defvar | ||
| 197 | |||
| 198 | Usually, you shouldn't need to set | ||
| 199 | @code{open-paren-in-column-0-is-defun-start} to @code{nil}. However, | ||
| 200 | if your buffer contains parentheses or braces in column zero which | ||
| 201 | don't start defuns and this confuses Emacs, it sometimes helps to set | ||
| 202 | the option to @code{nil}. Be aware, though, that this will make | ||
| 203 | scrolling and display in large buffers quite sluggish, and that | ||
| 204 | parentheses and braces must be correctly matched throughout the buffer | ||
| 205 | for it to work properly. | ||
| 206 | |||
| 200 | In the earliest days, the original Emacs found defuns by moving | 207 | In the earliest days, the original Emacs found defuns by moving |
| 201 | upward a level of parentheses or braces until there were no more | 208 | upward a level of parentheses or braces until there were no more |
| 202 | levels to go up. This always required scanning all the way back to | 209 | levels to go up. This always required scanning all the way back to |
| @@ -1557,10 +1564,10 @@ preprocessor commands. | |||
| 1557 | @table @kbd | 1564 | @table @kbd |
| 1558 | @item C-c C-@key{DEL} | 1565 | @item C-c C-@key{DEL} |
| 1559 | @itemx C-c @key{DEL} | 1566 | @itemx C-c @key{DEL} |
| 1560 | @findex c-hungry-backspace | 1567 | @findex c-hungry-delete-backwards |
| 1561 | @kindex C-c C-@key{DEL} (C Mode) | 1568 | @kindex C-c C-@key{DEL} (C Mode) |
| 1562 | @kindex C-c @key{DEL} (C Mode) | 1569 | @kindex C-c @key{DEL} (C Mode) |
| 1563 | @code{c-hungry-backspace}---Delete the entire block of whitespace | 1570 | @code{c-hungry-delete-backwards}---Delete the entire block of whitespace |
| 1564 | preceding point. | 1571 | preceding point. |
| 1565 | 1572 | ||
| 1566 | @item C-c C-d | 1573 | @item C-c C-d |
diff --git a/man/search.texi b/man/search.texi index 67b61aeac07..532d58fb9d8 100644 --- a/man/search.texi +++ b/man/search.texi | |||
| @@ -488,6 +488,13 @@ search can make the cursor move back and start again. For example, if | |||
| 488 | you have searched for @samp{foo} and you add @samp{\|bar}, the cursor | 488 | you have searched for @samp{foo} and you add @samp{\|bar}, the cursor |
| 489 | backs up in case the first @samp{bar} precedes the first @samp{foo}. | 489 | backs up in case the first @samp{bar} precedes the first @samp{foo}. |
| 490 | 490 | ||
| 491 | Forward and backward regexp search are not symmetrical, because | ||
| 492 | regexp matching in Emacs always operates forward, starting with the | ||
| 493 | beginning of the regexp. Thus, forward regexp search scans forward, | ||
| 494 | trying a forward match at each possible starting position. Backward | ||
| 495 | regexp search scans backward, trying a forward match at each possible | ||
| 496 | starting position. These search methods are not mirror images. | ||
| 497 | |||
| 491 | @findex re-search-forward | 498 | @findex re-search-forward |
| 492 | @findex re-search-backward | 499 | @findex re-search-backward |
| 493 | Nonincremental search for a regexp is done by the functions | 500 | Nonincremental search for a regexp is done by the functions |
diff --git a/man/tramp.texi b/man/tramp.texi index 48d13b67ee3..4a09e2daa3c 100644 --- a/man/tramp.texi +++ b/man/tramp.texi | |||
| @@ -832,6 +832,26 @@ to not print any shell prompt, which confuses @value{tramp} mightily. | |||
| 832 | This method supports the @samp{-p} hack. | 832 | This method supports the @samp{-p} hack. |
| 833 | 833 | ||
| 834 | 834 | ||
| 835 | @item @option{scpc} --- @command{ssh} and @command{scp} | ||
| 836 | @cindex method scpx | ||
| 837 | @cindex scpx method | ||
| 838 | @cindex scp (with scpx method) | ||
| 839 | @cindex ssh (with scpx method) | ||
| 840 | |||
| 841 | Newer versions of @option{ssh} (for example OpenSSH 4) offer an option | ||
| 842 | @option{ControlMaster}. This allows @option{scp} to reuse an existing | ||
| 843 | @option{ssh} channel, which increases performance. | ||
| 844 | |||
| 845 | Before you use this method, you shall check whether your @option{ssh} | ||
| 846 | implementation does support this option. Try from the command line | ||
| 847 | |||
| 848 | @example | ||
| 849 | ssh localhost -o ControlMaster=yes | ||
| 850 | @end example | ||
| 851 | |||
| 852 | This method supports the @samp{-p} hack. | ||
| 853 | |||
| 854 | |||
| 835 | @item @option{pscp} --- @command{plink} and @command{pscp} | 855 | @item @option{pscp} --- @command{plink} and @command{pscp} |
| 836 | @cindex method pscp | 856 | @cindex method pscp |
| 837 | @cindex pscp method | 857 | @cindex pscp method |
diff --git a/man/trampver.texi b/man/trampver.texi index bf220f4b195..a7777b00c79 100644 --- a/man/trampver.texi +++ b/man/trampver.texi | |||
| @@ -4,12 +4,12 @@ | |||
| 4 | @c In the Tramp CVS, the version number is auto-frobbed from | 4 | @c In the Tramp CVS, the version number is auto-frobbed from |
| 5 | @c configure.ac, so you should edit that file and run | 5 | @c configure.ac, so you should edit that file and run |
| 6 | @c "autoconf && ./configure" to change the version number. | 6 | @c "autoconf && ./configure" to change the version number. |
| 7 | @set trampver 2.0.54 | 7 | @set trampver 2.0.55 |
| 8 | 8 | ||
| 9 | @c Other flags from configuration | 9 | @c Other flags from configuration |
| 10 | @set prefix /usr/local | 10 | @set prefix /usr/local |
| 11 | @set lispdir /usr/local/share/emacs/site-lisp | 11 | @set lispdir /usr/local/share/emacs/site-lisp |
| 12 | @set infodir /usr/local/info | 12 | @set infodir /usr/local/share/info |
| 13 | 13 | ||
| 14 | @c Formatting of the tramp program name consistent. | 14 | @c Formatting of the tramp program name consistent. |
| 15 | @set tramp @sc{tramp} | 15 | @set tramp @sc{tramp} |
diff --git a/man/xresources.texi b/man/xresources.texi index e9233df25d5..142b1bc70a0 100644 --- a/man/xresources.texi +++ b/man/xresources.texi | |||
| @@ -11,7 +11,7 @@ can customize some of the same aspects using the system registry. | |||
| 11 | @xref{MS-Windows Registry}. Likewise, Emacs on MacOS Carbon emulates X | 11 | @xref{MS-Windows Registry}. Likewise, Emacs on MacOS Carbon emulates X |
| 12 | resources using the Preferences system. @xref{Mac Environment Variables}. | 12 | resources using the Preferences system. @xref{Mac Environment Variables}. |
| 13 | 13 | ||
| 14 | When Emacs is built using an ``X toolkit'', such as Lucid or | 14 | When Emacs is built using an ``X toolkit'', such as Lucid or |
| 15 | LessTif, you need to use X resources to customize the appearance of | 15 | LessTif, you need to use X resources to customize the appearance of |
| 16 | the widgets, including the menu-bar, scroll-bar, and dialog boxes. | 16 | the widgets, including the menu-bar, scroll-bar, and dialog boxes. |
| 17 | This is because the libraries that implement these don't provide for | 17 | This is because the libraries that implement these don't provide for |
| @@ -73,7 +73,7 @@ and their particular meanings. Case distinctions are significant in | |||
| 73 | these names. Each resource specification in @file{~/.Xdefaults} | 73 | these names. Each resource specification in @file{~/.Xdefaults} |
| 74 | states the name of the program and the name of the resource. For | 74 | states the name of the program and the name of the resource. For |
| 75 | Emacs, the program name is @samp{Emacs}. It looks like this: | 75 | Emacs, the program name is @samp{Emacs}. It looks like this: |
| 76 | 76 | ||
| 77 | @example | 77 | @example |
| 78 | Emacs.borderWidth: 2 | 78 | Emacs.borderWidth: 2 |
| 79 | @end example | 79 | @end example |
| @@ -321,6 +321,9 @@ Number of lines to reserve for the tool bar. A zero value suppresses | |||
| 321 | the tool bar. If the value is non-zero and | 321 | the tool bar. If the value is non-zero and |
| 322 | @code{auto-resize-tool-bars} is non-@code{nil}, the tool bar's size | 322 | @code{auto-resize-tool-bars} is non-@code{nil}, the tool bar's size |
| 323 | will be changed automatically so that all tool bar items are visible. | 323 | will be changed automatically so that all tool bar items are visible. |
| 324 | If the value of @code{auto-resize-tool-bars} is @code{grow-only}, | ||
| 325 | the tool bar expands automatically, but does not contract automatically. | ||
| 326 | To contract the tool bar, you must redraw the frame by entering @kbd{C-l}. | ||
| 324 | 327 | ||
| 325 | @item @code{useXIM} (class @code{UseXIM}) | 328 | @item @code{useXIM} (class @code{UseXIM}) |
| 326 | @cindex XIM | 329 | @cindex XIM |
| @@ -438,7 +441,7 @@ Emacs.pane.menubar.font: 8x16 | |||
| 438 | 441 | ||
| 439 | @noindent | 442 | @noindent |
| 440 | Resources for @emph{non-menubar} toolkit pop-up menus have | 443 | Resources for @emph{non-menubar} toolkit pop-up menus have |
| 441 | @samp{menu*} instead of @samp{pane.menubar}. For example, to specify | 444 | @samp{menu*} instead of @samp{pane.menubar}. For example, to specify |
| 442 | the font @samp{8x16} for the pop-up menu items, write this: | 445 | the font @samp{8x16} for the pop-up menu items, write this: |
| 443 | 446 | ||
| 444 | @example | 447 | @example |
| @@ -701,7 +704,7 @@ the menubar and the scroll bar in Emacs we use: | |||
| 701 | widget "Emacs.pane.menubar" style "my_style" | 704 | widget "Emacs.pane.menubar" style "my_style" |
| 702 | widget "Emacs.pane.emacs.verticalScrollBar" style "my_style" | 705 | widget "Emacs.pane.emacs.verticalScrollBar" style "my_style" |
| 703 | @end smallexample | 706 | @end smallexample |
| 704 | 707 | ||
| 705 | But to avoid having to type it all, wildcards are often used. @samp{*} | 708 | But to avoid having to type it all, wildcards are often used. @samp{*} |
| 706 | matches zero or more characters and @samp{?} matches one character. So "*" | 709 | matches zero or more characters and @samp{?} matches one character. So "*" |
| 707 | matches all widgets. | 710 | matches all widgets. |