sh.html

IEEE 1003.1-2003, Single Unix Specification v3

<dd>Redraw the current command line. Position the cursor at the same location on the redrawn line.</dd>

<dt><b>#</b></dt>

<dd>Insert the character <tt>'#'</tt> at the beginning of the current command line and treat the resulting edit line as a comment.
This line shall be entered into the command history; see <a href="fc.html"><i>fc</i></a> .</dd>

<dt><b>=</b></dt>

<dd>Display the possible shell word expansions (see <a href="xcu_chap02.html#tag_02_06"><i>Word Expansions</i></a> ) of the bigword
at the current command line position. <basefont size="2"> 

<dl>
<dt><b>Note:</b></dt>

<dd>This does not modify the content of the current line, and therefore does not cause the current line to become the edit
line.</dd>
</dl>

<basefont size="3"> 

<p>These expansions shall be displayed on subsequent terminal lines. If the bigword contains none of the characters <tt>'?'</tt> ,
<tt>'*'</tt> , or <tt>'['</tt> , an asterisk ( <tt>'*'</tt> ) shall be implicitly assumed at the end. If any directories are
matched, these expansions shall have a <tt>'/'</tt> character appended. After the expansion, the line shall be redrawn, the cursor
repositioned at the current cursor position, and <i>sh</i> shall be placed in command mode.</p>
</dd>

<dt><b>\</b></dt>

<dd>Perform pathname expansion (see <a href="xcu_chap02.html#tag_02_06_06"><i>Pathname Expansion</i></a> ) on the current bigword,
up to the largest set of characters that can be matched uniquely. If the bigword contains none of the characters <tt>'?'</tt> ,
<tt>'*'</tt> , or <tt>'['</tt> , an asterisk ( <tt>'*'</tt> ) shall be implicitly assumed at the end. This maximal expansion then
shall replace the original bigword in the command line, and the cursor shall be placed after this expansion. If the resulting
bigword completely and uniquely matches a directory, a <tt>'/'</tt> character shall be inserted directly after the bigword. If some
other file is completely matched, a single &lt;space&gt; shall be inserted after the bigword. After this operation, <i>sh</i> shall
be placed in insert mode.</dd>

<dt><b>*</b></dt>

<dd>Perform pathname expansion on the current bigword and insert all expansions into the command to replace the current bigword,
with each expansion separated by a single &lt;space&gt;. If at the end of the line, the current cursor position shall be moved to
the first column position following the expansions and <i>sh</i> shall be placed in insert mode. Otherwise, the current cursor
position shall be the last column position of the first character after the expansions and <i>sh</i> shall be placed in insert
mode. If the current bigword contains none of the characters <tt>'?'</tt> , <tt>'*'</tt> , or <tt>'['</tt> , before the operation,
an asterisk shall be implicitly assumed at the end.</dd>

<dt><b>@</b><i>letter</i></dt>

<dd>Insert the value of the alias named <i>_letter</i>. The symbol <i>letter</i> represents a single alphabetic character from the
portable character set; implementations may support additional characters as an extension. If the alias <i>_letter</i> contains
other editing commands, these commands shall be performed as part of the insertion. If no alias <i>_letter</i> is enabled, this
command shall have no effect.</dd>

<dt><b>[</b><i>count</i><b>]&#152;</b></dt>

<dd>Convert, if the current character is a lowercase letter, to the equivalent uppercase letter and <i>vice versa</i>, as
prescribed by the current locale. The current cursor position then shall be advanced by one character. If the cursor was positioned
on the last character of the line, the case conversion shall occur, but the cursor shall not advance. If the <tt>'&#152;'</tt>
command is preceded by a <i>count</i>, that number of characters shall be converted, and the cursor shall be advanced to the
character position after the last character converted. If the <i>count</i> is larger than the number of characters after the
cursor, this shall not be considered an error; the cursor shall advance to the last character on the line.</dd>

<dt><b>[</b><i>count</i><b>].</b></dt>

<dd>Repeat the most recent non-motion command, even if it was executed on an earlier command line. If the previous command was
preceded by a <i>count</i>, and no count is given on the <tt>'.'</tt> command, the count from the previous command shall be
included as part of the repeated command. If the <tt>'.'</tt> command is preceded by a <i>count</i>, this shall override any
<i>count</i> argument to the previous command. The <i>count</i> specified in the <tt>'.'</tt> command shall become the count for
subsequent <tt>'.'</tt> commands issued without a count.</dd>

<dt><b>[</b><i>number</i><b>]v</b></dt>

<dd>Invoke the <a href="../utilities/vi.html"><i>vi</i></a> editor to edit the current command line in a temporary file. When the
editor exits, the commands in the temporary file shall be executed and placed in the command history. If a <i>number</i> is
included, it specifies the command number in the command history to be edited, rather than the current command line.</dd>

<dt><b>[</b><i>count</i><b>]l</b>&nbsp;&nbsp;&nbsp;(ell)</dt>

<dt><b>[</b><i>count</i><b>]</b>&lt;space&gt;</dt>

<dd><br>
Move the current cursor position to the next character position. If the cursor was positioned on the last character of the line,
the terminal shall be alerted and the cursor shall not be advanced. If the <i>count</i> is larger than the number of characters
after the cursor, this shall not be considered an error; the cursor shall advance to the last character on the line.</dd>

<dt><b>[</b><i>count</i><b>]h</b></dt>

<dd>Move the current cursor position to the <i>count</i>th (default 1) previous character position. If the cursor was positioned on
the first character of the line, the terminal shall be alerted and the cursor shall not be moved. If the count is larger than the
number of characters before the cursor, this shall not be considered an error; the cursor shall move to the first character on the
line.</dd>

<dt><b>[</b><i>count</i><b>]w</b></dt>

<dd>Move to the start of the next word. If the cursor was positioned on the last character of the line, the terminal shall be
alerted and the cursor shall not be advanced. If the <i>count</i> is larger than the number of words after the cursor, this shall
not be considered an error; the cursor shall advance to the last character on the line.</dd>

<dt><b>[</b><i>count</i><b>]W</b></dt>

<dd>Move to the start of the next bigword. If the cursor was positioned on the last character of the line, the terminal shall be
alerted and the cursor shall not be advanced. If the <i>count</i> is larger than the number of bigwords after the cursor, this
shall not be considered an error; the cursor shall advance to the last character on the line.</dd>

<dt><b>[</b><i>count</i><b>]e</b></dt>

<dd>Move to the end of the current word. If at the end of a word, move to the end of the next word. If the cursor was positioned on
the last character of the line, the terminal shall be alerted and the cursor shall not be advanced. If the <i>count</i> is larger
than the number of words after the cursor, this shall not be considered an error; the cursor shall advance to the last character on
the line.</dd>

<dt><b>[</b><i>count</i><b>]E</b></dt>

<dd>Move to the end of the current bigword. If at the end of a bigword, move to the end of the next bigword. If the cursor was
positioned on the last character of the line, the terminal shall be alerted and the cursor shall not be advanced. If the
<i>count</i> is larger than the number of bigwords after the cursor, this shall not be considered an error; the cursor shall
advance to the last character on the line.</dd>

<dt><b>[</b><i>count</i><b>]b</b></dt>

<dd>Move to the beginning of the current word. If at the beginning of a word, move to the beginning of the previous word. If the
cursor was positioned on the first character of the line, the terminal shall be alerted and the cursor shall not be moved. If the
<i>count</i> is larger than the number of words preceding the cursor, this shall not be considered an error; the cursor shall
return to the first character on the line.</dd>

<dt><b>[</b><i>count</i><b>]B</b></dt>

<dd>Move to the beginning of the current bigword. If at the beginning of a bigword, move to the beginning of the previous bigword.
If the cursor was positioned on the first character of the line, the terminal shall be alerted and the cursor shall not be moved.
If the <i>count</i> is larger than the number of bigwords preceding the cursor, this shall not be considered an error; the cursor
shall return to the first character on the line.</dd>

<dt><b>^</b></dt>

<dd>Move the current cursor position to the first character on the input line that is not a &lt;blank&gt;.</dd>

<dt><b>$</b></dt>

<dd>Move to the last character position on the current command line.</dd>

<dt><b>0</b></dt>

<dd>(Zero.) Move to the first character position on the current command line.</dd>

<dt><b>[</b><i>count</i><b>]|</b></dt>

<dd>Move to the <i>count</i>th character position on the current command line. If no number is specified, move to the first
position. The first character position shall be numbered 1. If the count is larger than the number of characters on the line, this
shall not be considered an error; the cursor shall be placed on the last character on the line.</dd>

<dt><b>[</b><i>count</i><b>]f</b><i>c</i></dt>

<dd>Move to the first occurrence of the character <tt>'c'</tt> that occurs after the current cursor position. If the cursor was
positioned on the last character of the line, the terminal shall be alerted and the cursor shall not be advanced. If the character
<tt>'c'</tt> does not occur in the line after the current cursor position, the terminal shall be alerted and the cursor shall not
be moved.</dd>

<dt><b>[</b><i>count</i><b>]F</b><i>c</i></dt>

<dd>Move to the first occurrence of the character <tt>'c'</tt> that occurs before the current cursor position. If the cursor was
positioned on the first character of the line, the terminal shall be alerted and the cursor shall not be moved. If the character
<tt>'c'</tt> does not occur in the line before the current cursor position, the terminal shall be alerted and the cursor shall not
be moved.</dd>

<dt><b>[</b><i>count</i><b>]t</b><i>c</i></dt>

<dd>Move to the character before the first occurrence of the character <tt>'c'</tt> that occurs after the current cursor position.
If the cursor was positioned on the last character of the line, the terminal shall be alerted and the cursor shall not be advanced.
If the character <tt>'c'</tt> does not occur in the line after the current cursor position, the terminal shall be alerted and the
cursor shall not be moved.</dd>

<dt><b>[</b><i>count</i><b>]T</b><i>c</i></dt>

<dd>Move to the character after the first occurrence of the character <tt>'c'</tt> that occurs before the current cursor position.
If the cursor was positioned on the first character of the line, the terminal shall be alerted and the cursor shall not be moved.
If the character <tt>'c'</tt> does not occur in the line before the current cursor position, the terminal shall be alerted and the
cursor shall not be moved.</dd>

<dt><b>[</b><i>count</i><b>];</b></dt>

<dd>Repeat the most recent <b>f</b>, <b>F</b>, <b>t</b>, or <b>T</b> command. Any number argument on that previous command shall be
ignored. Errors are those described for the repeated command.</dd>

<dt><b>[</b><i>count</i><b>],</b></dt>

<dd>Repeat the most recent <b>f</b>, <b>F</b>, <b>t</b>, or <b>T</b> command. Any number argument on that previous command shall be
ignored. However, reverse the direction of that command.</dd>

<dt><b>a</b></dt>

<dd>Enter insert mode after the current cursor position. Characters that are entered shall be inserted before the next
character.</dd>

<dt><b>A</b></dt>

<dd>Enter insert mode after the end of the current command line.</dd>

<dt><b>i</b></dt>

<dd>Enter insert mode at the current cursor position. Characters that are entered shall be inserted before the current
character.</dd>

<dt><b>I</b></dt>

<dd>Enter insert mode at the beginning of the current command line.</dd>

<dt><b>R</b></dt>

<dd>Enter insert mode, replacing characters from the command line beginning at the current cursor position.</dd>

<dt><b>[</b><i>count</i><b>]c</b><i>motion</i></dt>

<dd><br>
Delete the characters between the current cursor position and the cursor position that would result from the specified motion
command. Then enter insert mode before the first character following any deleted characters. If <i>count</i> is specified, it shall
be applied to the motion command. A <i>count</i> shall be ignored for the following motion commands: 

<pre>
<tt>0    ^    $    c
</tt>
</pre>

<p>If the motion command is the character <tt>'c'</tt> , the current command line shall be cleared and insert mode shall be
entered. If the motion command would move the current cursor position toward the beginning of the command line, the character under
the current cursor position shall not be deleted. If the motion command would move the current cursor position toward the end of
the command line, the character under the current cursor position shall be deleted. If the <i>count</i> is larger than the number
of characters between the current cursor position and the end of the command line toward which the motion command would move the
cursor, this shall not be considered an error; all of the remaining characters in the aforementioned range shall be deleted and
insert mode shall be entered. If the motion command is invalid, the terminal shall be alerted, the cursor shall not be moved, and
no text shall be deleted.</p>
</dd>

<dt><b>C</b></dt>

<dd>Delete from the current character to the end of the line and enter insert mode at the new end-of-line.</dd>

<dt><b>S</b></dt>

<dd>Clear the entire edit line and enter insert mode.</dd>

<dt><b>[</b><i>count</i><b>]r</b><i>c</i></dt>

<dd>Replace the current character with the character <tt>'c'</tt> . With a number <i>count</i>, replace the current and the
following <i>count</i>-1 characters. After this command, the current cursor position shall be on the last character that was
changed. If the <i>count</i> is larger than the number of characters after the cursor, this shall not be considered an error; all
of the remaining characters shall be changed.</dd>