@c This is part of the Emacs manual.
-@c Copyright (C) 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
+@c Copyright (C) 2004-2014 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
@code{picture-move-up}, which can either insert spaces or convert tabs
as necessary to make sure that point stays in exactly the same column.
@kbd{C-e} runs @code{picture-end-of-line}, which moves to after the last
-nonblank character on the line. There is no need to change @kbd{C-a},
-as the choice of screen model does not affect beginnings of
-lines.
+nonblank character on the line. @kbd{C-a} runs
+@code{picture-beginning-of-line}. (The choice of screen model does not
+affect beginnings of lines; the only extra thing this command does is
+update the current picture column to 0.)
@findex picture-newline
Insertion of text is adapted to the quarter-plane screen model
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{DOWN}
Move down after insertion (@code{picture-movement-down}).
@item C-c `
-@itemx C-c @key{HOME}
+@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 /
-@itemx C-c @key{END}
+@itemx C-c @key{End}
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
With no argument, it moves to a point underneath the next
``interesting'' character that follows whitespace in the previous
nonblank line. ``Next'' here means ``appearing at a horizontal position
-greater than the one point starts out at.'' With an argument, as in
+greater than the one point starts out at''. With an argument, as in
@kbd{C-u M-@key{TAB}}, this command moves to the next such interesting
character in the current line. @kbd{M-@key{TAB}} does not change the
text; it only moves point. ``Interesting'' characters are defined by
@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