Subject: bug#17707: 24.4.50; doc string of `align-newline-and-indent'

From: Drew Adams <[email-masked]>
Date: Thu, 5 Jun 2014 14:21:59 -0700 (PDT)

Doc string:

  A replacement function for `newline-and-indent', aligning as it goes.

Aligning how?  Aligning what?  With respect to what?

Please spend some time to come up with a description of _what this
function does_.  In addition to indenting, it does some aligning - fine.
Aligning what to what?  How? (I.e., what does "aligning" mean in this
context?)

In GNU Emacs 24.4.50.1 (i686-pc-mingw32)
 of 2014-06-01 on ODIEONE
Bzr revision: 117212 [email-masked]
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/Devel/emacs/snapshot/trunk
 --enable-checking=yes,glyphs 'CFLAGS=-O0 -g3'
 LDFLAGS=-Lc:/Devel/emacs/lib 'CPPFLAGS=-DGC_MCHECK=1
 -Ic:/Devel/emacs/include''