Next: , Previous: Indentation, Up: Indentation


29.1 Indentation Commands and Techniques

To move over the indentation on a line, do M-m (back-to-indentation). This command, given anywhere on a line, positions point at the first nonblank character on the line, if any, or else at the end of the line.

To insert an indented line before the current line, do C-a C-o <TAB>. To make an indented line after the current line, use C-e C-j.

If you just want to insert a tab character in the buffer, you can type C-q <TAB>.

C-M-o (split-line) moves the text from point to the end of the line vertically down, so that the current line becomes two lines. C-M-o first moves point forward over any spaces and tabs. Then it inserts after point a newline and enough indentation to reach the same column point is on. Point remains before the inserted newline; in this regard, C-M-o resembles C-o.

To join two lines cleanly, use the M-^ (delete-indentation) command. It deletes the indentation at the front of the current line, and the line boundary as well, replacing them with a single space. As a special case (useful for Lisp code) the single space is omitted if the characters to be joined are consecutive open parentheses or closing parentheses, or if the junction follows another newline. To delete just the indentation of a line, go to the beginning of the line and use M-\ (delete-horizontal-space), which deletes all spaces and tabs around the cursor.

If you have a fill prefix, M-^ deletes the fill prefix if it appears after the newline that is deleted. See Fill Prefix.

There are also commands for changing the indentation of several lines at once. They apply to all the lines that begin in the region. C-M-\ (indent-region) indents each line in the “usual” way, as if you had typed <TAB> at the beginning of the line. A numeric argument specifies the column to indent to, and each line is shifted left or right so that its first nonblank character appears in that column. C-x <TAB> (indent-rigidly) moves all of the lines in the region right by its argument (left, for negative arguments). The whole group of lines moves rigidly sideways, which is how the command gets its name.

If you want to remove all indentation from all of the line in the region, invoke C-x <TAB> with a large negative argument, such as -1000.

M-x indent-relative indents at point based on the previous line (actually, the last nonempty line). It inserts whitespace at point, moving point, until it is underneath the next indentation point in the previous line. An indentation point is the end of a sequence of whitespace or the end of the line. If point is farther right than any indentation point in the previous line, indent-relative runs tab-to-tab-stop unless it is called with a numeric argument, in which case it does nothing.

See Format Indentation, for another way of specifying the indentation for part of your text.