The basic indentation commands indent a single line according to the
usual conventions of the language you are editing.
+@need 1000
@table @kbd
@item @key{TAB}
Adjust indentation of current line.
comments in certain contexts. For example, in Lisp code, comments which
start with two semicolons are indented as if they were lines of code,
instead of at the comment column. Comments which start with three
-semicolons are supposed to start at the left margin. Emacs understands
+semicolons are supposed to start at the left margin and are often used
+for sectioning purposes. Emacs understands
these conventions by indenting a double-semicolon comment using @key{TAB},
and by not changing the indentation of a triple-semicolon comment at all.
@example
-;; This function is just an example
+;; This function is just an example.
;;; Here either two or three semicolons are appropriate.
(defun foo (x)
-;;; And now, the first part of the function:
+;;; And now, the first part of the function:
;; The following line adds one.
(1+ x)) ; This line adds one.
@end example
for a file name.
If you use @kbd{C-h S} in a major mode that does not support it,
-it asks you to specify the ``symbol help mode''. You should enter
+it asks you to specify the ``symbol help mode.'' You should enter
a command such as @code{c-mode} that would select a major
mode which @kbd{C-h S} does support.
@itemx M-x c-subword-mode
@findex c-subword-mode
Enable (or disable) @dfn{subword mode}. In subword mode, Emacs's word
-commands then recognize upper case letters in
+commands recognize upper case letters in
@samp{StudlyCapsIdentifiers} as word boundaries. This is indicated by
the flag @samp{/w} on the mode line after the mode name
(e.g. @samp{C/law}). You can even use @kbd{M-x c-subword-mode} in
@kbd{C-j}. We use @code{c-initialization-hook} here to make sure
the keymap is loaded before we try to change it.
-@example
+@smallexample
(defun my-bind-clb ()
(define-key c-mode-base-map "\C-j" 'c-context-line-break))
(add-hook 'c-initialization-hook 'my-bind-clb)
-@end example
+@end smallexample
@item C-M-h
Put mark at the end of a function definition, and put point at the