This section describes higher-level commands for inserting text, commands intended primarily for the user but useful also in Lisp programs.
This command inserts the entire contents of from-buffer-or-name
(which must exist) into the current buffer after point. It leaves
the mark after the inserted text. The value is nil
.
This command inserts the last character typed; it does so count
times, before point, and returns nil
. Most printing characters
are bound to this command. In routine use, self-insert-command
is the most frequently called function in SXEmacs, but programs rarely
use it except to install it on a keymap.
In an interactive call, count is the numeric prefix argument.
This command calls auto-fill-function
whenever that is
non-nil
and the character inserted is a space or a newline
(see Auto Filling).
This command performs abbrev expansion if Abbrev mode is enabled and the inserted character does not have word-constituent syntax. (See Abbrevs, and Syntax Class Table.)
This is also responsible for calling blink-paren-function
when
the inserted character has close parenthesis syntax (see Blinking).
This command inserts newlines into the current buffer before point. If count is supplied, that many newline characters are inserted.
This function calls auto-fill-function
if the current column
number is greater than the value of fill-column
and
count is nil
. Typically what
auto-fill-function
does is insert a newline; thus, the overall
result in this case is to insert two newlines at different places: one
at point, and another earlier in the line. newline
does not
auto-fill if count is non-nil
.
This command indents to the left margin if that is not zero. See Margins.
The value returned is nil
. In an interactive call, count
is the numeric prefix argument.
This command splits the current line, moving the portion of the line
after point down vertically so that it is on the next line directly
below where it was before. Whitespace is inserted as needed at the
beginning of the lower line, using the indent-to
function.
split-line
returns the position of point.
Programs hardly ever use this function.
This variable controls whether overwrite mode is in effect: a
non-nil
value enables the mode. It is automatically made
buffer-local when set in any fashion.