@c This is part of the Emacs manual.
-@c Copyright (C) 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
+@c Copyright (C) 2004-2012 Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
@c
@c This file is included either in emacs-xtra.texi (when producing the
@c printed version) or in the main Emacs manual (for the on-line version).
@node Picture Mode
-@chapter Editing Pictures
+@section Editing Pictures
@cindex pictures
@cindex making pictures out of text characters
-@findex edit-picture
+@findex picture-mode
To edit a picture made out of text characters (for example, a picture
of the division of a register into fields, as a comment in a program),
-use the command @kbd{M-x edit-picture} to enter Picture mode.
+use the command @kbd{M-x picture-mode} to enter Picture mode.
In Picture mode, editing is based on the @dfn{quarter-plane} model of
text, according to which the text characters lie studded on an area that
Picture mode defines various keys starting with the @kbd{C-c} prefix to
run special picture editing commands.
- One of these keys, @kbd{C-c C-c}, is particularly important. Often a
-picture is part of a larger file that is usually edited in some other
-major mode. @kbd{M-x edit-picture} records the name of the previous
-major mode so you can use the @kbd{C-c C-c} command
-(@code{picture-mode-exit}) later to go back to that mode. @kbd{C-c C-c}
-also deletes spaces from the ends of lines, unless given a numeric
-argument.
+ One of these keys, @kbd{C-c C-c}, is particularly important. Often
+a picture is part of a larger file that is usually edited in some
+other major mode. Picture mode records the name of the previous major
+mode so you can use the @kbd{C-c C-c} command
+(@code{picture-mode-exit}) later to go back to that mode. @kbd{C-c
+C-c} also deletes spaces from the ends of lines, unless given a
+numeric argument.
The special commands of Picture mode all work in other modes (provided
the @file{picture} library is loaded), but are not bound to keys except
@end menu
@node Basic Picture
-@section Basic Editing in Picture Mode
+@subsection Basic Editing in Picture Mode
@findex picture-forward-column
@findex picture-backward-column
Picture}).
@node Insert in Picture
-@section Controlling Motion after Insert
+@subsection Controlling Motion after Insert
@findex picture-movement-up
@findex picture-movement-down
@itemx C-c @key{HOME}
Move up and left (``northwest'') after insertion (@code{picture-movement-nw}).
@item C-c '
-@itemx C-c @key{PAGEUP}
+@itemx C-c @key{prior}
Move up and right (``northeast'') after insertion
(@code{picture-movement-ne}).
@item C-c /
Move down and left (``southwest'') after insertion
@*(@code{picture-movement-sw}).
@item C-c \
-@itemx C-c @key{PAGEDOWN}
+@itemx C-c @key{next}
Move down and right (``southeast'') after insertion
@*(@code{picture-movement-se}).
@end table
C-b} (@code{picture-motion-reverse}) moves in the opposite direction.
@node Tabs in Picture
-@section Picture Mode Tabs
+@subsection Picture Mode Tabs
@kindex M-TAB @r{(Picture mode)}
@findex picture-tab-search
@code{indent-tabs-mode} to @code{nil}.
@node Rectangles in Picture
-@section Picture Mode Rectangle Commands
+@subsection Picture Mode Rectangle Commands
@cindex rectangles and Picture mode
@cindex Picture mode and rectangles
@table @kbd
@item C-c C-k
Clear out the region-rectangle with spaces
-(@code{picture-clear-rectangle}). With argument, delete the text.
+(@code{picture-clear-rectangle}). With a prefix argument, delete the
+text.
@item C-c C-w @var{r}
Similar, but save rectangle contents in register @var{r} first
(@code{picture-clear-rectangle-to-register}).
(by overwriting) the rectangle that was most recently killed, while
@kbd{C-c C-x} (@code{picture-yank-rectangle-from-register}) does
likewise for the rectangle found in a specified register.
-
-@ignore
- arch-tag: 10e423ad-d896-42f2-a7e8-7018adeaf8c2
-@end ignore