@c This is part of the Emacs manual.
-@c Copyright (C) 1985, 86, 87, 93, 94, 95, 1997 Free Software Foundation, Inc.
+@c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 2002, 2003,
+@c 2004, 2005 Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
@node Picture, Sending Mail, Abbrevs, Top
@chapter Editing Pictures
@vindex picture-mode-hook
Turning on Picture mode runs the hook @code{picture-mode-hook}
-(@pxref{Hooks}).
+(@pxref{Hooks}). Additional extensions to Picture mode can be found
+in @file{artist.el}.
@menu
* Basic Picture:: Basic concepts and simple commands of Picture Mode.
@findex picture-backward-clear-column
@findex picture-clear-column
@findex picture-clear-line
- Picture mode provides erasure instead of deletion and killing of
-text. @key{DEL} (@code{picture-backward-clear-column}) replaces the
-preceding character with a space rather than removing it; this moves
-point backwards. @kbd{C-d} (@code{picture-clear-column}) replaces the
-next character or characters with spaces, but does not move point. (If
-you want to clear characters to spaces and move forward over them, use
+ In Picture mode, the commands that normally delete or kill text,
+instead erase text (replacing it with spaces). @key{DEL}
+(@code{picture-backward-clear-column}) replaces the preceding
+character with a space rather than removing it; this moves point
+backwards. @kbd{C-d} (@code{picture-clear-column}) replaces the next
+character or characters with spaces, but does not move point. (If you
+want to clear characters to spaces and move forward over them, use
@key{SPC}.) @kbd{C-k} (@code{picture-clear-line}) really kills the
-contents of lines, but does not delete the newlines from the
-buffer.
+contents of lines, but does not delete the newlines from the buffer.
@findex picture-open-line
To do actual insertion, you must use special commands. @kbd{C-o}
-(@code{picture-open-line}) creates a blank line after the current line;
-it never splits a line. @kbd{C-M-o} (@code{split-line}) makes sense in
-Picture mode, so it is not changed. @kbd{C-j}
-(@code{picture-duplicate-line}) inserts below the current line another
-line with the same contents.@refill
+(@code{picture-open-line}) creates a blank line after the current
+line; it never splits a line. @kbd{C-M-o} (@code{split-line}) makes
+sense in Picture mode, so it is not changed. @kbd{C-j}
+(@code{picture-duplicate-line}) inserts another line with the same
+contents below the current line.
@kindex C-c C-d @r{(Picture mode)}
To do actual deletion in Picture mode, use @kbd{C-w}, @kbd{C-c C-d}
@table @kbd
@item C-c <
+@itemx C-c @key{LEFT}
Move left after insertion (@code{picture-movement-left}).
@item C-c >
+@itemx C-c @key{RIGHT}
Move right after insertion (@code{picture-movement-right}).
@item C-c ^
+@itemx C-c @key{UP}
Move up after insertion (@code{picture-movement-up}).
@item C-c .
+@itemx C-c @key{DOWN}
Move down after insertion (@code{picture-movement-down}).
@item C-c `
+@itemx C-c @key{HOME}
Move up and left (``northwest'') after insertion (@code{picture-movement-nw}).
@item C-c '
+@itemx C-c @key{PAGEUP}
Move up and right (``northeast'') after insertion
(@code{picture-movement-ne}).
@item C-c /
+@itemx C-c @key{END}
Move down and left (``southwest'') after insertion
@*(@code{picture-movement-sw}).
@item C-c \
+@itemx C-c @key{PAGEDOWN}
Move down and right (``southeast'') after insertion
@*(@code{picture-movement-se}).
@end table
Clear out the region-rectangle with spaces
(@code{picture-clear-rectangle}). With argument, delete the text.
@item C-c C-w @var{r}
-Similar but save rectangle contents in register @var{r} first
+Similar, but save rectangle contents in register @var{r} first
(@code{picture-clear-rectangle-to-register}).
@item C-c C-y
Copy last killed rectangle into the buffer by overwriting, with upper
@findex picture-yank-rectangle
@findex picture-yank-rectangle-from-register
The Picture mode commands for yanking rectangles differ from the
-standard ones in overwriting instead of inserting. This is the same way
-that Picture mode insertion of other text differs from other modes.
-@kbd{C-c C-y} (@code{picture-yank-rectangle}) inserts (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.
+standard ones in that they overwrite instead of inserting. This is
+the same way that Picture mode insertion of other text differs from
+other modes. @kbd{C-c C-y} (@code{picture-yank-rectangle}) inserts
+(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: b7589747-683c-4f40-aed8-1b10403cb666
+@end ignore