* doc/lispref/text.texi (Margins): Fix the description of RET and `C-j'.
* doc/emacs/programs.texi (Basic Indent):
(Other C Commands): Fix the description of RET and `C-j'.
* doc/emacs/indent.texi (Indentation Commands): Move the description of
`C-j' from here...
* doc/emacs/basic.texi (Inserting Text): ... to here.
++2014-02-27 Xue Fuqiao <xfq@gnu.org>
++
++ * programs.texi (Basic Indent):
++ (Other C Commands): Fix the description of RET and `C-j'.
++
++ * indent.texi (Indentation Commands): Move the description of
++ `C-j' from here...
++ * basic.texi (Inserting Text): ... to here.
++
2014-02-25 Glenn Morris <rgm@gnu.org>
* custom.texi (Terminal Init):
@xref{Point}.
@kindex RET
++@kindex C-j
@cindex newline
++@findex electric-indent-just-newline
To end a line and start a new one, type @key{RET} (@code{newline}).
(The @key{RET} key may be labeled @key{Return} or @key{Enter} on your
keyboard, but we refer to it as @key{RET} in this manual.) This
--command inserts a newline character into the buffer. If point is at
--the end of the line, the effect is to create a new blank line after
--it; if point is in the middle of a line, the line is split at that
--position.
++command inserts a newline character into the buffer, then indent
++(@pxref{Indentation}) accroding to major mode. If point is at the end
++of the line, the effect is to create a new blank line after it and
++indent the new line; if point is in the middle of a line, the line is
++split at that position. To turn off the auto-indentation, you can
++either desable Electric Indent mode (@pxref{Indent Convenience}) or
++type @kbd{C-j}, which inserts just a newline, without any
++auto-indentation.
As we explain later in this manual, you can change the way Emacs
handles text insertion by turning on @dfn{minor modes}. For instance,
ways.
@table @kbd
--@item C-j
--@kindex C-j
--@findex newline-and-indent
--Perform @key{RET} followed by @key{TAB} (@code{newline-and-indent}).
--
@item C-M-o
@kindex C-M-o
@findex split-line
@table @kbd
@item @key{TAB}
Adjust indentation of current line (@code{indent-for-tab-command}).
--@item C-j
++@item @key{RET}
Insert a newline, then adjust indentation of following line
--(@code{newline-and-indent}).
++(@code{newline}).
@end table
@kindex TAB @r{(programming modes)}
the preceding lines; if the region is active, @key{TAB} indents each
line within the region, not just the current line.
--@kindex C-j @r{(indenting source code)}
--@findex newline-and-indent
-- The command @kbd{C-j} (@code{newline-and-indent}), which was
--documented in @ref{Indentation Commands}, does the same as @key{RET}
--followed by @key{TAB}: it inserts a new line, then adjusts the line's
--indentation.
++ The command @key{RET} (@code{newline}), which was documented in
++@ref{Inserting Text}, does the same as @key{C-j} followed by
++@key{TAB}: it inserts a new line, then adjusts the line's indentation.
When indenting a line that starts within a parenthetical grouping,
Emacs usually places the start of the line under the preceding line
@findex c-context-line-break
This command inserts a line break and indents the new line in a manner
appropriate to the context. In normal code, it does the work of
--@kbd{C-j} (@code{newline-and-indent}), in a C preprocessor line it
--additionally inserts a @samp{\} at the line break, and within comments
--it's like @kbd{M-j} (@code{c-indent-new-comment-line}).
++@key{RET} (@code{newline}), in a C preprocessor line it additionally
++inserts a @samp{\} at the line break, and within comments it's like
++@kbd{M-j} (@code{c-indent-new-comment-line}).
@code{c-context-line-break} isn't bound to a key by default, but it
needs a binding to be useful. The following code will bind it to
--@kbd{C-j}. We use @code{c-initialization-hook} here to make sure
++@kbd{RET}. We use @code{c-initialization-hook} here to make sure
the keymap is loaded before we try to change it.
@example
(defun my-bind-clb ()
-- (define-key c-mode-base-map "\C-j"
++ (define-key c-mode-base-map "\C-m"
'c-context-line-break))
(add-hook 'c-initialization-hook 'my-bind-clb)
@end example
@table @kbd
@item @key{TAB}
@code{tab-to-tab-stop}.
++@c FIXME: Maybe this should be consistent with other programming modes.
@item C-j
Insert a newline and then indent using @code{tab-to-tab-stop}.
@item :
2014-02-27 Xue Fuqiao <xfq@gnu.org>
++ * text.texi (Margins): Fix the description of RET and `C-j'.
++
* frames.texi (Multiple Terminals): Document
`display-monitor-attributes-list' and `display-monitor-attributes'.
(Display Feature Testing): Add some notes about multi-monitor.
@defopt left-margin
This variable specifies the base left margin column. In Fundamental
--mode, @kbd{C-j} indents to this column. This variable automatically
++mode, @kbd{RET} indents to this column. This variable automatically
becomes buffer-local when set in any fashion.
@end defopt
@end itemize
@table @asis
++@c FIXME: This should be `electric-indent-just-newline' since GNU Emacs 24.4.
@item @kbd{C-j} (@code{newline-and-indent})
@kindex C-j
@findex newline-and-indent
@kindex RET
@kindex C-j
@emph{Why doesn't the @kbd{RET} key indent the new line?}
++@c FIXME: `electric-indent-mode' is enabled by default in GNU Emacs 24.4.
Emacs's convention is that @kbd{RET} just adds a newline, and that
@kbd{C-j} adds a newline and indents it. You can make @kbd{RET} do this
in one of your Emacs startup files.
@end table
++@c FIXME: `electric-indent-mode' is enabled by default in GNU Emacs 24.4.
A common problem is that the @key{RET} key does @emph{not} indent the
line to where the new text should go after inserting the newline. This
is because the standard Emacs convention is that @key{RET} (aka
@kindex 011 TAB (@code{indent-for-tab-command})
Indent line for current major mode (@code{indent-for-tab-command}).
@item C-j
++@c FIXME: This should be `electric-indent-just-newline' since GNU Emacs 24.4.
@kindex 012 @kbd{C-j} (@code{newline-and-indent})
Insert a newline, then indent according to mode (@code{newline-and-indent}).
@item C-k
HCoop / bpt / emacs.git / commitdiff