\section{Deletion Commands}
\label{Deletion Commands}

     Table~\ref{Text Deletion Commands} summarizes the text  deletion  commands,  which  permit
     deletion  of  single  characters,  groups of adjacent characters,
     single lines, or groups of adjacent lines.


\medskip
\subsection*{DELETE commands}
\medskip

\begin{table}[h]
\caption{\bf{Text Deletion Commands}}
\label{Text Deletion Commands}
\end{table}
\nopagebreak

\begin{list}{}{\labelsep 20pt}

     \item [{\tt D}]         Delete  the  first  character  following  the   current
               position of the buffer pointer.

     \item [{\tt nD}]        Execute the {\tt D} command {\tt n} times.  If {\tt n} is positive, the {\tt n}
               characters  following  the current pointer position are
               deleted.  If {\tt n} is negative, the {\tt n} characters  preceding
               the  current  pointer  position  are  deleted.  If {\tt n} is
               zero, the command is ignored.

     \item [{\tt -D}]        Equivalent to {\tt -1D}.


\iftecoelevenonly
     \item [{\tt m,nD}]      Equivalent to {\tt m,nK}.
               {\em [TECO-11 only]}
\fi

\iftecotenonly
     \item [{\tt n:D}]       Same as {\tt nD} but returns a value (-1 if command succeeds,
               0  if command failed because the range of characters to
               be deleted fell outside the text buffer).
               {\em [TECO-10 only]}

     \item [{\tt FDtext}\escape ]   Search for the specified text  string  
	and  delete  it.
               (See search commands in section~\ref{Search Commands}
               {\tt [TECO-10 only}]
\fi

     \item [{\tt @FD/text/ }] Equivalent to {\tt FDtext}\escape 
	 except that the {\tt <DELIM>} character
               is not necessary.

     \item [{\tt FR}\escape ]       Equivalent to {\tt -nD} where {\tt n} 
	is the  length  of  the  last
               insert,  get or search command.  See the description of
               the {\tt FRtext}\escape command in section~\ref{Insertion Commands} for more details.

     \item [{\tt @FR//}]     Form of the {\tt FR}\escape command that does not  require  use  of
               the {\tt <DELIM>} character.

\medskip
\subsection*{KILL commands}
\medskip

     \item [{\tt K}]         Deletes the contents of the  buffer  from  the  current
               position  of  the  buffer pointer through and including
               the next line terminator character.

     \item [{\tt nK}]        Executes the {\tt K} command {\tt n} times.  If {\tt n} is positive,  the
               {\tt n}  lines  following  the  current  pointer position are
               deleted.  If {\tt n} is negative, the {\tt n} lines  preceding  the
               current  pointer  position  are deleted.  If {\tt n} is zero,
               the contents of the buffer from the  beginning  of  the
               line  on which the pointer is located up to the pointer
               is deleted.  It is not  an  error  if  more  lines  are
               specified than occur when a boundary of the text buffer
               is encountered.

     \item [{\tt -K}]        Equivalent to {\tt -1K}.

     \item [{\tt m,nK}]      Deletes the contents  of  the  buffer  between  pointer
               positions  {\tt m}  and {\tt n}.  The pointer moves to the point of
               the  deletion.   The  {\tt ?POP}  error   message   (or   its
               equivalent) is issued if either m or {\tt n} is out of range.

\iftecotenonly
     \item [{\tt FKtext}\escape ]   Executes a {\tt Stext}\escape command then  deletes  all  the  text
               from  the  initial  pointer position to the new pointer
               position.
               {\em [TECO-10 only]}

     \item [{\tt @FK/text/}] Equivalent to {\tt FKtext}\escape except that  
		{\tt text}  may  contain
               any  character,  including  {\tt <ESCAPE>},  other  than  the
               delimiter (shown here as /).
               {\em [TECO-10 only]}
\fi

     \item [{\tt HK}]        Deletes the entire contents of the buffer.
\end{list}
