X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/31ff037ab849a8d5d9b871a8927154ffb38a8694..e4c26271f2c2fe08f8490e25c63a436ab2a804ca:/doc/emacs/killing.texi diff --git a/doc/emacs/killing.texi b/doc/emacs/killing.texi index d453647b0c..107adb99ec 100644 --- a/doc/emacs/killing.texi +++ b/doc/emacs/killing.texi @@ -1,5 +1,5 @@ @c This is part of the Emacs manual. -@c Copyright (C) 1985-1987, 1993-1995, 1997, 2000-2015 Free Software +@c Copyright (C) 1985-1987, 1993-1995, 1997, 2000-2016 Free Software @c Foundation, Inc. @c See file emacs.texi for copying conditions. @@ -504,9 +504,9 @@ does not alter the clipboard. However, if you change @code{yank-pop-change-selection} to @code{t}, then @kbd{M-y} saves the new yank to the clipboard. -@vindex x-select-enable-clipboard +@vindex select-enable-clipboard To prevent kill and yank commands from accessing the clipboard, -change the variable @code{x-select-enable-clipboard} to @code{nil}. +change the variable @code{select-enable-clipboard} to @code{nil}. @cindex clipboard manager @vindex x-select-enable-clipboard-manager @@ -519,14 +519,14 @@ when exiting Emacs; if you wish to prevent Emacs from transferring data to the clipboard manager, change the variable @code{x-select-enable-clipboard-manager} to @code{nil}. -@vindex x-select-enable-primary +@vindex select-enable-primary @findex clipboard-kill-region @findex clipboard-kill-ring-save @findex clipboard-yank Prior to Emacs 24, the kill and yank commands used the primary selection (@pxref{Primary Selection}), not the clipboard. If you -prefer this behavior, change @code{x-select-enable-clipboard} to -@code{nil}, @code{x-select-enable-primary} to @code{t}, and +prefer this behavior, change @code{select-enable-clipboard} to +@code{nil}, @code{select-enable-primary} to @code{t}, and @code{mouse-drag-copy-region} to @code{t}. In this case, you can use the following commands to act explicitly on the clipboard: @code{clipboard-kill-region} kills the region and saves it to the @@ -587,9 +587,9 @@ you can access it using the following Emacs commands: @table @kbd @findex mouse-set-secondary -@kindex M-Drag-Mouse-1 +@kindex M-Drag-mouse-1 @cindex secondary-selection face -@item M-Drag-Mouse-1 +@item M-Drag-mouse-1 Set the secondary selection, with one end at the place where you press down the button, and the other end at the place where you release it (@code{mouse-set-secondary}). The selected text is highlighted, using @@ -600,31 +600,31 @@ window, just like @code{mouse-set-region} (@pxref{Mouse Commands}). This command does not alter the kill ring. @findex mouse-start-secondary -@kindex M-Mouse-1 -@item M-Mouse-1 +@kindex M-mouse-1 +@item M-mouse-1 Set one endpoint for the @dfn{secondary selection} (@code{mouse-start-secondary}). @findex mouse-secondary-save-then-kill -@kindex M-Mouse-3 -@item M-Mouse-3 +@kindex M-mouse-3 +@item M-mouse-3 Set the secondary selection, with one end at the position clicked and -the other at the position specified with @kbd{M-Mouse-1} +the other at the position specified with @kbd{M-mouse-1} (@code{mouse-secondary-save-then-kill}). This also puts the selected -text in the kill ring. A second @kbd{M-Mouse-3} at the same place +text in the kill ring. A second @kbd{M-mouse-3} at the same place kills the secondary selection just made. @findex mouse-yank-secondary -@kindex M-Mouse-2 -@item M-Mouse-2 +@kindex M-mouse-2 +@item M-mouse-2 Insert the secondary selection where you click, placing point at the end of the yanked text (@code{mouse-yank-secondary}). @end table -Double or triple clicking of @kbd{M-Mouse-1} operates on words and -lines, much like @kbd{Mouse-1}. +Double or triple clicking of @kbd{M-mouse-1} operates on words and +lines, much like @kbd{mouse-1}. -If @code{mouse-yank-at-point} is non-@code{nil}, @kbd{M-Mouse-2} yanks +If @code{mouse-yank-at-point} is non-@code{nil}, @kbd{M-mouse-2} yanks at point. Then it does not matter precisely where you click, or even which of the frame's windows you click on. @xref{Mouse Commands}. @@ -853,6 +853,19 @@ so in a rectangular fashion, and killing and yanking operate on the rectangle. @xref{Killing}. The mode persists only as long as the region is active. +Unlike the standard region, the region-rectangle can have its corners +extended past the end of buffer, or inside stretches of white space +that point normally cannot enter, like the TAB. + +@findex rectangle-exchange-point-and-mark +@findex exchange-point-and-mark@r{, in rectangle-mark-mode} +@kindex C-x C-x@r{, in rectangle-mark-mode} +When the region is in rectangle-mark-mode, @kbd{C-x C-x} runs the +command @code{rectangle-exchange-point-and-mark}, which cycles between +the four corners of the region-rectangle. This comes in handy if you +want to modify the dimensions of the region-rectangle before invoking +an operation on the marked text. + @node CUA Bindings @section CUA Bindings @findex cua-mode