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

[Lars Ingebrigtsen]

Drew Adams <drew.adams@oracle.com> writes:

>> >   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?)
>> 
>> I've now made the doc string mention that it uses `align' to do
>> alignment.
>
> OK, but what alignment?  What does it align with what?

`align' presumably explains that sufficiently.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no