← Back to branch summary

~ubuntu-branches/ubuntu/karmic/emacs-snapshot/karmic

« back to all changes in this revision

Viewing changes to doc/emacs/mark.texi

  • Committer: Bazaar Package Importer
  • Author(s): Reinhard Tartler
  • Date: 2009-04-05 09:14:30 UTC
  • mto: This revision was merged to the branch mainline in revision 34.
  • Revision ID: james.westby@ubuntu.com-20090405091430-nw07lynn2arotjbe
Tags: upstream-20090320
Import upstream version 20090320

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/emacs/mark.texi
1
1
@c This is part of the Emacs manual.
2
2
@c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 2001, 2002,
3
 
@c   2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
 
3
@c   2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
4
4
@c See file emacs.texi for copying conditions.
5
5
@node Mark, Killing, Help, Top
6
6
@chapter The Mark and the Region
180
180
  Similarly, @kbd{C-M-h} (@code{mark-defun}) sets mark and point
181
181
around major top-level definitions (@pxref{Moving by Defuns}), and
182
182
@kbd{C-x C-p} (@code{mark-page}) does the same for pages
183
 
(@pxref{Pages}).  These treat repeated invokations and prefix
 
183
(@pxref{Pages}).  These treat repeated invocations and prefix
184
184
arguments similarly to @code{mark-paragraph}.
185
185
 
186
186
  Finally, @kbd{C-x h} (@code{mark-whole-buffer}) sets up the entire
222
222
  Most commands that operate on the text in the region have the word
223
223
@code{region} in their names.
224
224
 
225
 
  If Delete Selection mode is enabled, some commands delete the region
226
 
when used while the mark is active.  @xref{Mouse Commands}.
 
225
  Some commands have a default behavior when the region is inactive,
 
226
but operate on the text in the region if the region is active.  For
 
227
example, @kbd{M-$} (@code{ispell-word}) normally checks the spelling
 
228
of the word at point, but it checks the text in the region if the
 
229
region is active (@pxref{Spelling}).  Normally, such commands use
 
230
their default behavior if the region is empty (i.e., if mark and point
 
231
are at the same position).  If you want them to operate on the empty
 
232
region, change the variable @code{use-empty-active-region} to
 
233
@code{t}.
 
234
 
 
235
@cindex Delete Selection mode
 
236
@cindex mode, Delete Selection
 
237
@findex delete-selection-mode
 
238
  If you enable Delete Selection mode, a minor mode, then inserting
 
239
text while the region is active causes the selected text to be deleted
 
240
first.  This also deactivates the mark.  Many graphical applications
 
241
follow this convention, but Emacs does not.  To toggle Delete
 
242
Selection mode on or off, type @kbd{M-x delete-selection-mode}.
 
243
Another effect of this mode is that some keys, such as @key{DEL} and
 
244
@kbd{C-d}, always kill the region if one exists.
227
245
 
228
246
@node Mark Ring
229
247
@section The Mark Ring