Inconsistent use of align/indent comments in info

Inconsistent use of align/indent comments in info

[Andrew M. Scott]

The info pages seem to inconsistently refer to aligning vs. indenting
comments, as shown by the "^^^^^" marks below. Any fix probably
depends on whether one considers aligning and indenting as
independent, or one as a subset of the other.


C-h i
m emacs
s comments takes you to 

Editing Programs
* Comments::	        Inserting, killing, and aligning comments.
                                                ^^^^^^^^
Hitting return * Comments above takes you to:

File: emacs,  Node: Comments,  Next: Documentation,  Prev: Parentheses,  Up: Programs

31.5 Manipulating Comments
==========================

Because comments are such an important part of programming, Emacs
provides special commands for editing and inserting comments.  It can
also do spell checking on comments with Flyspell Prog mode (*note
Spelling::).

* Menu:

* Comment Commands::    Inserting, killing, and indenting comments.
                                                ^^^^^^^^^
Hitting return on Comment Commands: takes you to
File: emacs,  Node: Comment Commands,  Next: Multi-Line Comments,  Up: Comments

31.5.1 Comment Commands
-----------------------

The comment commands in this table insert, kill and align comments.
                                                    ^^^^^
Andy Scott

Re: Inconsistent use of align/indent comments in info

[Richard Stallman]

Thanks for pointing out the inconsistency.  "Indentation"
refers to whitespace at the start of a line; thus, in general,
comments are aligned, not indented, but comments that do not
follow code may be described as "indented".  I've corrected
the text to follow that rule.

The command name comment-indent should really be comment-align, and
the variable names c-indent-comment-alist,
c-indent-comments-syntactically-p, and comment-indent-function really
ought to say "align" instead of "indent".  Perhaps we should make
new aliases for them.