@c =============================================================
@c = $B85(B $BK](B $BLu(B: $BGt@n@5=<!w$*Cc$N?e=w;RBg3X(B
@c = $B2CI.=$@5(B: $BBgLZFXM:!wBgDM(B.$BC^GHBg3X(B = 1998/11/25
@c =============================================================
@c This is part of the Emacs manual.
@c Copyright (C) 1985, 86, 87, 93, 94, 95, 1997 Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
@node Picture, Sending Mail, Abbrevs, Top
@c @chapter Editing Pictures
@chapter $B3($NJT=8(B
@c @cindex pictures
@cindex $B3((B
@c @cindex making pictures out of text characters
@cindex $B%F%-%9%HJ8;z$G=q$$$?3((B
@findex edit-picture

@c   To edit a picture made out of text characters (for example, a picture
@c of the division of a register into fields, as a comment in a program),
@c use the command @kbd{M-x edit-picture} to enter Picture mode.
$B%F%-%9%HJ8;z$G=q$$$?3(!J$?$H$($P!"%W%m%0%i%`$N%3%a%s%H$H$7$F(B
$B%l%8%9%?$r%U%#!<%k%I$KJ,3d$7$?3(!K$rJT=8$9$k$K$O!"(B
$B%3%^%s%I(B@kbd{M-x edit-picture}$B$r;H$C$F(B
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$KF~$j$^$9!#(B

@c   In Picture mode, editing is based on the @dfn{quarter-plane} model of
@c text, according to which the text characters lie studded on an area that
@c stretches infinitely far to the right and downward.  The concept of the end
@c of a line does not exist in this model; the most you can say is where the
@c last nonblank character on the line is found.
@c = quarter-plane $B>]8B!)(B
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$G$O!"(B
@dfn{1/4$BJ?LL(B}$B%b%G%k!J(Bquarter-plane$B!K$K4p$E$$$FJT=8$r9T$$$^$9!#(B
$B$D$^$j!"1&B&$H2<B&$KL58B$KB3$/NN0h$K%F%-%9%HJ8;z$,;6:_$9$k$N$G$9!#(B
$B$3$N%b%G%k$G$O9TKv$OB8:_$7$^$;$s!#(B
$B9TCf$G6uGr$G$J$$J8;z$,:G8e$K8=$l$k>l=j$,$o$+$k$@$1$G$9!#(B

@c   Of course, Emacs really always considers text as a sequence of
@c characters, and lines really do have ends.  But Picture mode replaces
@c the most frequently-used commands with variants that simulate the
@c quarter-plane model of text.  They do this by inserting spaces or by
@c converting tabs to spaces.
$B$b$A$m$s!"(BEmacs$B$O$D$M$K%F%-%9%H$rJ8;z$NNs$H$7$F$H$i$(!"(B
$B<B:]$K$O9T$K=*$j$,$"$j$^$9!#(B
$B$7$+$7!"%T%/%A%c!<!J(Bpicture$B!K%b!<%I$G$O!"$h$/;H$o$l$k%3%^%s%I$NBgItJ,$r(B
1/4$BJ?LL%b%G%k$K=>$C$FF0:n$9$k$h$&$KCV$-49$($F$$$^$9!#(B
$B6uGr$rA^F~$7$?$j%?%V$r6uGr$KCV$-49$($k$3$H$G!"$=$N$h$&$K$7$^$9!#(B

@c   Most of the basic editing commands of Emacs are redefined by Picture mode
@c to do essentially the same thing but in a quarter-plane way.  In addition,
@c Picture mode defines various keys starting with the @kbd{C-c} prefix to
@c run special picture editing commands.
Emacs$B$N4pK\E*$JJT=8%3%^%s%I$NBgItJ,$O!"(B
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$G$O(B
1/4$BJ?LL%b%G%k$K$*$$$FK\<AE*$K$OF1$8F0:n$r$9$k$h$&$K:FDj5A$5$l$F$$$^$9!#(B
$B$5$i$K!"%T%/%A%c!<!J(Bpicture$B!K%b!<%I$G$O!"(B
@kbd{C-c}$B$G;O$^$k%-!<Ns$r3($NJT=8MQ$NFCJL$J%3%^%s%I$H$7$FDj5A$7$^$9!#(B

@c   One of these keys, @kbd{C-c C-c}, is pretty important.  Often a
@c picture is part of a larger file that is usually edited in some other
@c major mode.  @kbd{M-x edit-picture} records the name of the previous
@c major mode so you can use the @kbd{C-c C-c} command
@c (@code{picture-mode-exit}) later to go back to that mode.  @kbd{C-c C-c}
@c also deletes spaces from the ends of lines, unless given a numeric
@c argument.
$B$3$l$i$N%-!<$N(B1$B$D$G$"$k(B@kbd{C-c C-c}$B$OHs>o$K=EMW$G$9!#(B
$B3($,!"IaDL$OJL$N%a%8%c!<%b!<%I$GJT=8$5$l$kBg$-$J%U%!%$%k$N(B
$B0lIt$G$"$k$3$H$,$7$P$7$P$"$j$^$9!#(B
@kbd{M-x edit-picture}$B$OD>A0$N%a%8%c!<%b!<%I$r5-O?$7$F$*$-!"(B
$B$"$H$G(B@kbd{C-c C-c}$B%3%^%s%I!J(B@code{picture-mode-exit}$B!K$G(B
$B$=$N%b!<%I$KLa$l$k$h$&$K$7$^$9!#(B
$B$^$?!"?t0z?t$r;XDj$7$J$1$l$P!"(B@kbd{C-c C-c}$B$O9TKv$N6uGr$r:o=|$7$^$9!#(B

@c   The special commands of Picture mode all work in other modes (provided
@c the @file{picture} library is loaded), but are not bound to keys except
@c in Picture mode.  The descriptions below talk of moving ``one column''
@c and so on, but all the picture mode commands handle numeric arguments as
@c their normal equivalents do.
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$N$9$Y$F$NFCJL$J%3%^%s%I$O!"(B
$B!J(B@file{picture}$B%i%$%V%i%j$,%m!<%I$5$l$F$$$l$P!K(B
$BB>$N%b!<%I$G$b;H$($^$9$,!"%T%/%A%c!<!J(Bpicture$B!K%b!<%I0J30$G$O(B
$B%-!<$K%P%$%s%I$5$l$F$$$^$;$s!#(B
$B0J2<$G$O!X(B1$B7e!Y0\F0$J$I$H@bL@$7$^$9$,!"(B
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$N$9$Y$F$N%3%^%s%I$O!"(B
$B$=$l$KBP1~$9$kDL>o$N%3%^%s%I$HF1$8$h$&$K?t0z?t$r07$($^$9!#(B

@vindex picture-mode-hook
@c   Turning on Picture mode runs the hook @code{picture-mode-hook}
@c (@pxref{Hooks}).
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$KF~$k$H$-$K(B
$B%U%C%/(B@code{picture-mode-hook}$B$r<B9T$7$^$9!J(B@pxref{Hooks}$B!K!#(B

@menu
* Basic Picture::         Basic concepts and simple commands of Picture Mode.
* Insert in Picture::     Controlling direction of cursor motion
                            after "self-inserting" characters.
* Tabs in Picture::       Various features for tab stops and indentation.
* Rectangles in Picture:: Clearing and superimposing rectangles.
@end menu

@node Basic Picture, Insert in Picture, Picture, Picture
@c @section Basic Editing in Picture Mode
@section $B%T%/%A%c!<%b!<%I$N4pK\JT=8(B

@findex picture-forward-column
@findex picture-backward-column
@findex picture-move-down
@findex picture-move-up
@c @cindex editing in Picture mode
@cindex $B%T%/%A%c!<%b!<%I$G$NJT=8(B

@c   Most keys do the same thing in Picture mode that they usually do, but
@c do it in a quarter-plane style.  For example, @kbd{C-f} is rebound to
@c run @code{picture-forward-column}, a command which moves point one
@c column to the right, inserting a space if necessary so that the actual
@c end of the line makes no difference.  @kbd{C-b} is rebound to run
@c @code{picture-backward-column}, which always moves point left one
@c column, converting a tab to multiple spaces if necessary.  @kbd{C-n} and
@c @kbd{C-p} are rebound to run @code{picture-move-down} and
@c @code{picture-move-up}, which can either insert spaces or convert tabs
@c as necessary to make sure that point stays in exactly the same column.
@c @kbd{C-e} runs @code{picture-end-of-line}, which moves to after the last
@c nonblank character on the line.  There is no need to change @kbd{C-a},
@c as the choice of screen model does not affect beginnings of
@c lines.
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$G$b!"$[$H$s$I$N%-!<$ODL>o$HF1$8F0:n$r$7$^$9$,!"(B
1/4$BJ?LLN.$NF0:n$G$9!#(B
$B$?$H$($P!"(B@kbd{C-f}$B$O!"(B
@code{picture-forward-column}$B$r<B9T$9$k$h$&$K:FDj5A$7$F$"$j$^$9!#(B
$B$3$N%3%^%s%I$O%]%$%s%H$r(B1$B7e1&$KF0$+$7!"(B
$BI,MW$J$i6uGr$rA^F~$7$F!"9TKv$,$J$$$+$N$h$&$K$U$k$^$$$^$9!#(B
@kbd{C-b}$B$O!"(B
@code{picture-backward-column}$B$r<B9T$9$k$h$&$K:FDj5A$7$F$"$j$^$9!#(B
$B$3$N%3%^%s%I$O%]%$%s%H$r(B1$B7e:8$KF0$+$7!"(B
$BI,MW$K1~$8$F%?%V$rJ#?t$N6uGr$KJQ49$7$^$9!#(B
@kbd{C-n}$B$H(B@kbd{C-p}$B$O!"$=$l$>$l(B@code{picture-move-down}$B$H(B
@code{picture-move-up}$B$r<B9T$9$k$h$&$K:FDj5A$7$F$"$j$^$9!#(B
$B$3$l$i$N%3%^%s%I$O!"I,MW$K1~$8$F6uGr$rA^F~$7$?$j%?%V$rJQ49$7$F!"(B
$B%]%$%s%H$,F1$87e0LCV$KN1$^$k$h$&$K0\F0$7$^$9!#(B
@kbd{C-e}$B$O(B@code{picture-end-of-line}$B$r<B9T$7$^$9!#(B
$B$3$N%3%^%s%I$O!"9T$N:G8e$NGrJ8;z0J30$NJ8;z$ND>8e$K0\F0$7$^$9!#(B
$B2hLL%b%G%k$O9TF,$K$O1F6A$7$J$$$N$G!"(B@kbd{C-a}$B$rJQ99$9$kI,MW$O$"$j$^$;$s!#(B

@findex picture-newline
@c   Insertion of text is adapted to the quarter-plane screen model through
@c the use of Overwrite mode (@pxref{Minor Modes}).  Self-inserting characters
@c replace existing text, column by column, rather than pushing existing text
@c to the right.  @key{RET} runs @code{picture-newline}, which just moves to
@c the beginning of the following line so that new text will replace that
@c line.
$B%F%-%9%H$NA^F~$O!">e=q$-!J(Boverwrite$B!K%b!<%I$rMQ$$$F(B
1/4$BJ?LL%b%G%k$KBP1~$5$;$F$"$j$^$9!J(B@pxref{Minor Modes}$B!K!#(B
$B<+8JA^F~J8;z$O!"4{B8$N%F%-%9%H$r1&B&$X2!$7$d$k$N$G$O$J$/!"(B
$B4{B8$N%F%-%9%H$r7e$4$H$KCV$-49$($^$9!#(B
@key{RET}$B$O(B@code{picture-newline}$B$r<B9T$7$^$9!#(B
$B$3$N%3%^%s%I$O!"$D$.$N9T$N@hF,$K0\F0$7!"(B
$B$=$N9T$,?7$?$J%F%-%9%H$GCV$-49$o$k$h$&$K$7$^$9!#(B

@findex picture-backward-clear-column
@findex picture-clear-column
@findex picture-clear-line
@c   Picture mode provides erasure instead of deletion and killing of
@c text.  @key{DEL} (@code{picture-backward-clear-column}) replaces the
@c preceding character with a space rather than removing it; this moves
@c point backwards.  @kbd{C-d} (@code{picture-clear-column}) replaces the
@c next character or characters with spaces, but does not move point.  (If
@c you want to clear characters to spaces and move forward over them, use
@c @key{SPC}.)  @kbd{C-k} (@code{picture-clear-line}) really kills the
@c contents of lines, but does not delete the newlines from the
@c buffer.
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$G$O!"%F%-%9%H$N:o=|$d%-%k$N$+$o$j$K>C5n$7$^$9!#(B
@key{DEL}$B!J(B@code{picture-backward-clear-column}$B!K$O!"(B
$BD>A0$NJ8;z$r:o=|$9$k$N$G$O$J$/6uGr$GCV$-49$(!"(B
$B$^$?!"%]%$%s%H$r(B1$B$D$^$($KLa$7$^$9!#(B
@kbd{C-d}$B!J(B@code{picture-clear-column}$B!K$OD>8e$N(B1$B$D0J>e$NJ8;z$r(B
$B6uGr$GCV$-49$($^$9$,!"%]%$%s%H$OF0$+$7$^$;$s!#(B
$B!JJ8;z$r6uGr$GCV$-49$($F!"$+$D!"%]%$%s%H$r@h$X?J$a$k$K$O!"(B@key{SPC}$B$r;H$&!#!K(B
@kbd{C-k}$B!J(B@code{picture-clear-line}$B!K$O9T$NFbMF$r<B:]$K%-%k$7$^$9$,!"(B
$B%P%C%U%!$+$i2~9T$r:o=|$7$^$;$s!#(B

@findex picture-open-line
@c   To do actual insertion, you must use special commands.  @kbd{C-o}
@c (@code{picture-open-line}) creates a blank line after the current line;
@c it never splits a line.  @kbd{C-M-o} (@code{split-line}) makes sense in
@c Picture mode, so it is not changed.  @kbd{C-j}
@c (@code{picture-duplicate-line}) inserts below the current line another
@c line with the same contents.@refill
$B<B:]$KA^F~$r9T$&$K$O!"FCJL$J%3%^%s%I$r;H$&I,MW$,$"$j$^$9!#(B
@kbd{C-o}$B!J(B@code{picture-open-line}$B!K$O!"(B
$B8=:_9T$N$D$.$K6u9T$r:n$j$^$9$,!"9T$rJ,3d$7$^$;$s!#(B
@kbd{C-M-o}$B!J(B@code{split-line}$B!K$O(B
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$G$b0UL#$,$"$k$N$GJQ99$7$F$"$j$^$;$s!#(B
@kbd{C-j}$B!J(B@code{picture-duplicate-line}$B!K$O(B
$B8=:_9T$N2<$K8=:_9T$HF1$8FbMF$N9T$rA^F~$7$^$9!#(B

@c @kindex C-c C-d @r{(Picture mode)}
@kindex C-c C-d @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@c    To do actual deletion in Picture mode, use @kbd{C-w}, @kbd{C-c C-d}
@c (which is defined as @code{delete-char}, as @kbd{C-d} is in other
@c modes), or one of the picture rectangle commands (@pxref{Rectangles in
@c Picture}).
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$G<B:]$K:o=|$r9T$&$K$O!"(B
@kbd{C-w}$B$+(B
$B!JB>$N%b!<%I$G$N(B@kbd{C-d}$B$HF1$8(B@code{delete-char}$B$KDj5A$5$l$F$$$k!K(B
@kbd{C-c C-d}$B!"$"$k$$$O!"3($N6k7ANN0h%3%^%s%I$N(B1$B$D$r;H$$$^$9(B
$B!J(B@pxref{Rectangles in Picture}$B!K!#(B

@node Insert in Picture, Tabs in Picture, Basic Picture, Picture
@c @section Controlling Motion after Insert
@section $BA^F~8e$N%]%$%s%H0\F0@)8f(B

@findex picture-movement-up
@findex picture-movement-down
@findex picture-movement-left
@findex picture-movement-right
@findex picture-movement-nw
@findex picture-movement-ne
@findex picture-movement-sw
@findex picture-movement-se
@c @kindex C-c < @r{(Picture mode)}
@c @kindex C-c > @r{(Picture mode)}
@c @kindex C-c ^ @r{(Picture mode)}
@c @kindex C-c . @r{(Picture mode)}
@c @kindex C-c ` @r{(Picture mode)}
@c @kindex C-c ' @r{(Picture mode)}
@c @kindex C-c / @r{(Picture mode)}
@c @kindex C-c \ @r{(Picture mode)}
@kindex C-c < @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@kindex C-c > @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@kindex C-c ^ @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@kindex C-c . @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@kindex C-c ` @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@kindex C-c ' @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@kindex C-c / @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@kindex C-c \ @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@c   Since ``self-inserting'' characters in Picture mode overwrite and move
@c point, there is no essential restriction on how point should be moved.
@c Normally point moves right, but you can specify any of the eight
@c orthogonal or diagonal directions for motion after a ``self-inserting''
@c character.  This is useful for drawing lines in the buffer.
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$G$O!X<+8JA^F~!YJ8;z$O(B
$B>e=q$-$7$F%]%$%s%H$rF0$+$7$^$9$+$i!"(B
$B%]%$%s%H$r$I$N$h$&$KF0$+$9$+$K$D$$$FK\<AE*$J@)8B$O$"$j$^$;$s!#(B
$BDL>o%]%$%s%H$O1&$KF0$-$^$9$,!"!X<+8JA^F~!YJ8;z$N$"$H$G(B
$B>e2<:81&<P$a$N(B8$BJ}8~$N$$$:$l$NJ}8~$X0\F0$9$k$+;XDj$G$-$^$9!#(B
$B$3$l$O!"%P%C%U%!$KD>@~$r0z$/$H$-$KLrN)$A$^$9!#(B

@table @kbd
@item C-c <
@c Move left after insertion (@code{picture-movement-left}).
$BA^F~8e!":8$X0\F0!J(B@code{picture-movement-left}$B!K!#(B
@item C-c >
@c Move right after insertion (@code{picture-movement-right}).
$BA^F~8e!"1&$X0\F0!J(B@code{picture-movement-right}$B!K!#(B
@item C-c ^
@c Move up after insertion (@code{picture-movement-up}).
$BA^F~8e!">e$X0\F0!J(B@code{picture-movement-up}$B!K!#(B
@item C-c .
@c Move down after insertion (@code{picture-movement-down}).
$BA^F~8e!"2<$X0\F0!J(B@code{picture-movement-down}$B!K!#(B
@item C-c `
@c Move up and left (``northwest'') after insertion (@code{picture-movement-nw}).
$BA^F~8e!":8>e!J!XKL@>!Y!K$X0\F0!J(B@code{picture-movement-nw}$B!K!#(B
@item C-c '
@c Move up and right (``northeast'') after insertion
@c (@code{picture-movement-ne}).
$BA^F~8e!"1&>e!J!XKLEl!Y!K$X0\F0!J(B@code{picture-movement-ne}$B!K!#(B
@item C-c /
@c Move down and left (``southwest'') after insertion
@c @*(@code{picture-movement-sw}).
$BA^F~8e!":82<!J!XFn@>!Y!K$X0\F0!J(B@code{picture-movement-sw}$B!K!#(B
@item C-c \
@c Move down and right (``southeast'') after insertion
@c @*(@code{picture-movement-se}).
$BA^F~8e!"1&2<!J!XFnEl!Y!K$X0\F0!J(B@code{picture-movement-se}$B!K!#(B
@end table

@c @kindex C-c C-f @r{(Picture mode)}
@c @kindex C-c C-b @r{(Picture mode)}
@kindex C-c C-f @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@kindex C-c C-b @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@findex picture-motion
@findex picture-motion-reverse
@c   Two motion commands move based on the current Picture insertion
@c direction.  The command @kbd{C-c C-f} (@code{picture-motion}) moves in the
@c same direction as motion after ``insertion'' currently does, while @kbd{C-c
@c C-b} (@code{picture-motion-reverse}) moves in the opposite direction.
2$B$D$N0\F0%3%^%s%I$O!"8=:_;XDj$5$l$F$$$kA^F~8e$N0\F0J}8~$K4p$E$$$FF0:n$7$^$9!#(B
$B%3%^%s%I(B@kbd{C-c C-f}$B!J(B@code{picture-motion}$B!K$O!"(B
$B8=:_;XDj$5$l$F$$$k!XA^F~!Y8e$N0\F0J}8~$HF1$8J}8~$X0\F0$7$^$9$,!"(B
@kbd{C-c C-b}$B!J(B@code{picture-motion-reverse}$B!K$OH?BPJ}8~$X0\F0$7$^$9!#(B

@node Tabs in Picture, Rectangles in Picture, Insert in Picture, Picture
@c @section Picture Mode Tabs
@section $B%T%/%A%c!<%b!<%I$N%?%V(B

@c @kindex M-TAB @r{(Picture mode)}
@kindex M-TAB @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@findex picture-tab-search
@vindex picture-tab-chars
@c   Two kinds of tab-like action are provided in Picture mode.  Use
@c @kbd{M-@key{TAB}} (@code{picture-tab-search}) for context-based tabbing.
@c With no argument, it moves to a point underneath the next
@c ``interesting'' character that follows whitespace in the previous
@c nonblank line.  ``Next'' here means ``appearing at a horizontal position
@c greater than the one point starts out at.''  With an argument, as in
@c @kbd{C-u M-@key{TAB}}, this command moves to the next such interesting
@c character in the current line.  @kbd{M-@key{TAB}} does not change the
@c text; it only moves point.  ``Interesting'' characters are defined by
@c the variable @code{picture-tab-chars}, which should define a set of
@c characters.  The syntax for this variable is like the syntax used inside
@c of @samp{[@dots{}]} in a regular expression---but without the @samp{[}
@c and the @samp{]}.  Its default value is @code{"!-~"}.
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$K$O%?%VAjEv$NF0:n$,(B2$B<oN`$"$j$^$9!#(B
$BJ8L.$K4p$E$/%?%V$r9T$&$K$O(B@kbd{M-@key{TAB}}
$B!J(B@code{picture-tab-search}$B!K$r;H$$$^$9!#(B
$B0z?t$r;XDj$7$J$$$H!"@h9T$9$k6u9T$G$J$$9T$K$*$$$FGrJ8;z$KB3$/(B
$B!X6=L#$"$k!Y$D$.$NJ8;z$N2<J}$K0\F0$7$^$9!#(B
$B$3$3$G!X$D$.!Y$H$O!X3+;O0LCV$h$j?eJ?0LCV$,(B1$B$h$jBg$-$$!Y$H$$$&0UL#$G$9!#(B
@kbd{C-u M-@key{TAB}}$B$N$h$&$K0z?t$r;XDj$9$k$H!"(B
$B8=:_9T$K$*$$$F!X6=L#$"$k!YJ8;z$K0\F0$7$^$9!#(B
@kbd{M-@key{TAB}}$B$O%F%-%9%H$rJQ99$;$:$K%]%$%s%H$r0\F0$9$k$@$1$G$9!#(B
$B!X6=L#$"$k!YJ8;z$O!"JQ?t(B@code{picture-tab-chars}$B$GDj5A$5$l$^$9$,!"(B
$BJ8;z=89g$rDj5A$9$kI,MW$,$"$j$^$9!#(B
$B$3$NJQ?t$N9=J8$O@55,I=8=$G;H$o$l$k(B@samp{[@dots{}]}$B$N9=J8$K;w$F$$$^$9$,!"(B
@samp{[}$B$H(B@samp{]}$B$G0O$_$^$;$s!#(B
$B$3$NJQ?t$N%G%U%)%k%HCM$O(B@code{"!-~"}$B$G$9!#(B

@findex picture-tab
@c   @key{TAB} itself runs @code{picture-tab}, which operates based on the
@c current tab stop settings; it is the Picture mode equivalent of
@c @code{tab-to-tab-stop}.  Normally it just moves point, but with a numeric
@c argument it clears the text that it moves over.
@key{TAB}$B$=$l<+?H$O!"(B@code{picture-tab}$B$r<B9T$7$^$9!#(B
$B$3$N%3%^%s%I$O!"8=:_$N%?%V%9%H%C%W$N@_Dj$K4p$E$$$FF0:n$7$^$9!#(B
$B$3$l$OB>$N%b!<%I$N(B@code{tab-to-tab-stop}$B$KAjEv$7$^$9!#(B
$BDL>o$3$l$O%]%$%s%H$rF0$+$9$@$1$G$9$,!"(B
$B?t0z?t$r;XDj$9$k$H0\F0@h$^$G$N%F%-%9%H$r%/%j%"$7$^$9!#(B

@c @kindex C-c TAB @r{(Picture mode)}
@kindex C-c TAB @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@findex picture-set-tab-stops
@c   The context-based and tab-stop-based forms of tabbing are brought
@c together by the command @kbd{C-c @key{TAB}} (@code{picture-set-tab-stops}).
@c This command sets the tab stops to the positions which @kbd{M-@key{TAB}}
@c would consider significant in the current line.  The use of this command,
@c together with @key{TAB}, can get the effect of context-based tabbing.  But
@c @kbd{M-@key{TAB}} is more convenient in the cases where it is sufficient.
$BJ8L.$K4p$E$/%?%V$H%?%V%9%H%C%W$K4p$E$/%?%V$O!"(B
$B%3%^%s%I(B@kbd{C-c @key{TAB}}$B!J(B@code{picture-set-tab-stops}$B!K$G(B
$B7k$SIU$1$k$3$H$,$G$-$^$9!#(B
$B$3$N%3%^%s%I$O!"8=:_9T$K$*$$$F(B@kbd{M-@key{TAB}}$B$,=EMW$H9M$($k0LCV$K(B
$B%?%V%9%H%C%W$r@_Dj$7$^$9!#(B
@key{TAB}$B$H$H$b$K$3$N%3%^%s%I$r;H$($P!"(B
$BJ8L.$K4p$E$/%?%V$HF1$88z2L$rF@$i$l$^$9!#(B
$B$7$+$7!"(B@kbd{M-@key{TAB}}$B$G==J,$J$i$P$=$N$[$&$,JXMx$G$7$g$&!#(B

@c   It may be convenient to prevent use of actual tab characters in
@c pictures.  For example, this prevents @kbd{C-x @key{TAB}} from messing
@c up the picture.  You can do this by setting the variable
@c @code{indent-tabs-mode} to @code{nil}.  @xref{Just Spaces}.
$BK\Ev$N%?%VJ8;z$r3($K;H$o$J$$$h$&$KM^@)$7$?$[$&$,JXMx$J>l9g$,$"$j$^$9!#(B
$B$?$H$($P!"(B@kbd{C-x @key{TAB}}$B$G3($r$a$A$c$/$A$c$K$7$F$7$^$&$3$H$rKI;_$G$-$^$9!#(B
$B%?%VJ8;z$N;HMQ$rM^@)$9$k$K$O!"(B
$BJQ?t(B@code{indent-tabs-mode}$B$K(B@code{nil}$B$r@_Dj$7$^$9!#(B
@xref{Just Spaces}$B!#(B

@node Rectangles in Picture,, Tabs in Picture, Picture
@c @section Picture Mode Rectangle Commands
@section $B%T%/%A%c!<%b!<%I$N6k7ANN0h%3%^%s%I(B
@c @cindex rectangles and Picture mode
@c @cindex Picture mode and rectangles
@cindex $B6k7ANN0h$H%T%/%A%c!<%b!<%I(B
@cindex $B%T%/%A%c!<%b!<%I$H6k7ANN0h(B

@c   Picture mode defines commands for working on rectangular pieces of the
@c text in ways that fit with the quarter-plane model.  The standard rectangle
@c commands may also be useful (@pxref{Rectangles}).
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$G$O!"(B
1/4$BJ?LL%b%G%k$KE,9g$9$k$h$&$K!"(B
$B%F%-%9%H$N6k7ANN0h$K:nMQ$9$k%3%^%s%I$rDj5A$7$^$9!#(B
$BI8=`E*$J6k7ANN0h%3%^%s%I$bLrN)$D$G$7$g$&(B
$B!J(B@pxref{Rectangles}$B!K!#(B

@table @kbd
@item C-c C-k
@c Clear out the region-rectangle with spaces
@c (@code{picture-clear-rectangle}).  With argument, delete the text.
$B6k7ANN0h$r6uGr$G%/%j%"$9$k!J(B@code{picture-clear-rectangle}$B!K!#(B
$B?t0z?t$r;XDj$9$k$H%F%-%9%H$r:o=|$9$k!#(B
@item C-c C-w @var{r}
@c Similar but save rectangle contents in register @var{r} first
@c (@code{picture-clear-rectangle-to-register}).
$BF1MM$@$,!"$^$:6k7ANN0h$NFbMF$r%l%8%9%?(B@var{r}$B$KJ]B8$9$k(B
$B!J(B@code{picture-clear-rectangle-to-register}$B!K!#(B
@item C-c C-y
@c Copy last killed rectangle into the buffer by overwriting, with upper
@c left corner at point (@code{picture-yank-rectangle}).  With argument,
@c insert instead.
$B%]%$%s%H0LCV$r:8>e6y$H$7$F:G8e$K%-%k$7$?6k7ANN0h$r%P%C%U%!$K>e=q$-$9$k(B
$B!J(B@code{picture-yank-rectangle}$B!K!#(B
$B?t0z?t$r;XDj$9$k$HA^F~$9$k!#(B
@item C-c C-x @var{r}
@c Similar, but use the rectangle in register @var{r}
@c (@code{picture-yank-rectangle-from-register}).
$BF1MM$@$,!"%l%8%9%?(B@var{r}$B$N6k7ANN0h$r;H$&(B
$B!J(B@code{picture-yank-rectangle-from-register}$B!K!#(B
@end table

@c @kindex C-c C-k @r{(Picture mode)}
@c @kindex C-c C-w @r{(Picture mode)}
@kindex C-c C-k @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@kindex C-c C-w @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@findex picture-clear-rectangle
@findex picture-clear-rectangle-to-register
@c   The picture rectangle commands @kbd{C-c C-k}
@c (@code{picture-clear-rectangle}) and @kbd{C-c C-w}
@c (@code{picture-clear-rectangle-to-register}) differ from the standard
@c rectangle commands in that they normally clear the rectangle instead of
@c deleting it; this is analogous with the way @kbd{C-d} is changed in Picture
@c mode.
$B3($N6k7ANN0h%3%^%s%I!"(B@kbd{C-c C-k}$B!J(B@code{picture-clear-rectangle}$B!K$H(B
@kbd{C-c C-w}$B!J(B@code{picture-clear-rectangle-to-register}$B!K$O!"(B
$BI8=`$N6k7ANN0h%3%^%s%I$,6k7ANN0h$r:o=|$9$k$N$KBP$7%/%j%"$9$kE@$G0[$J$j$^$9!#(B
$B$3$l$O!"%T%/%A%c!<!J(Bpicture$B!K%b!<%I$G$N(B@kbd{C-d}$B$N0UL#$NJQ99J}K!$K(B
$BN`;w$7$?$b$N$G$9!#(B

@c   However, deletion of rectangles can be useful in Picture mode, so
@c these commands delete the rectangle if given a numeric argument.
@c @kbd{C-c C-k} either with or without a numeric argument saves the
@c rectangle for @kbd{C-c C-y}.
$B$7$+$7!"%T%/%A%c!<!J(Bpicture$B!K%b!<%I$G$b6k7ANN0h$N:o=|$OJXMx$J$N$G!"(B
$B?t0z?t$rM?$($k$H$3$l$i$N%3%^%s%I$O6k7ANN0h$r:o=|$7$^$9!#(B
$B0z?t$r;XDj$7$F$b$7$J$/$F$b(B@kbd{C-c C-k}$B$O(B
@kbd{C-c C-y}$B$N$?$a$K6k7ANN0h$r!J%l%8%9%?$K!KJ]B8$7$^$9!#(B

@c @kindex C-c C-y @r{(Picture mode)}
@c @kindex C-c C-x @r{(Picture mode)}
@kindex C-c C-y @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@kindex C-c C-x @r{$B!J%T%/%A%c!<%b!<%I!K(B}
@findex picture-yank-rectangle
@findex picture-yank-rectangle-from-register
@c   The Picture mode commands for yanking rectangles differ from the
@c standard ones in overwriting instead of inserting.  This is the same way
@c that Picture mode insertion of other text differs from other modes.
@c @kbd{C-c C-y} (@code{picture-yank-rectangle}) inserts (by overwriting)
@c the rectangle that was most recently killed, while @kbd{C-c C-x}
@c (@code{picture-yank-rectangle-from-register}) does likewise for the
@c rectangle found in a specified register.
$B%T%/%A%c!<!J(Bpicture$B!K%b!<%I$N%d%s%/%3%^%s%I$OI8=`$N$=$l$H$O!"(B
$BA^F~$N$+$o$j$K>e=q$-$9$kE@$G0[$J$j$^$9!#(B
$B$3$l$O%T%/%A%c!<!J(Bpicture$B!K%b!<%I$G$N%F%-%9%H$NA^F~$,(B
$BB>$N%b!<%I$G$N$=$l$H0[$J$C$F$$$k$N$HF1$8$G$9!#(B
@kbd{C-c C-y}$B!J(B@code{picture-yank-rectangle}$B!K$O!"(B
$B$b$C$H$b:G6a$K%-%k$7$?6k7ANN0h$r!J>e=q$-$G!KA^F~$7$^$9$,!"(B
@kbd{C-c C-x}$B!J(B@code{picture-yank-rectangle-from-register}$B!K(B
$B$OF1MM$N$3$H$r;XDj$5$l$?%l%8%9%?Fb$N6k7ANN0h$G9T$$$^$9!#(B