* bug#17707: 24.4.50; doc string of `align-newline-and-indent'
@ 2014-06-05 21:21 Drew Adams
2016-04-29 20:14 ` Lars Ingebrigtsen
0 siblings, 1 reply; 5+ messages in thread
From: Drew Adams @ 2014-06-05 21:21 UTC (permalink / raw)
To: 17707
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 michael.albinus@gmx.de-20140601104945-g88x0mwrxorz302h
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''
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#17707: 24.4.50; doc string of `align-newline-and-indent'
2014-06-05 21:21 bug#17707: 24.4.50; doc string of `align-newline-and-indent' Drew Adams
@ 2016-04-29 20:14 ` Lars Ingebrigtsen
2016-04-29 22:24 ` Drew Adams
0 siblings, 1 reply; 5+ messages in thread
From: Lars Ingebrigtsen @ 2016-04-29 20:14 UTC (permalink / raw)
To: Drew Adams; +Cc: 17707
Drew Adams <drew.adams@oracle.com> writes:
> 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?)
I've now made the doc string mention that it uses `align' to do
alignment.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#17707: 24.4.50; doc string of `align-newline-and-indent'
2016-04-29 20:14 ` Lars Ingebrigtsen
@ 2016-04-29 22:24 ` Drew Adams
2016-04-29 22:28 ` Lars Ingebrigtsen
0 siblings, 1 reply; 5+ messages in thread
From: Drew Adams @ 2016-04-29 22:24 UTC (permalink / raw)
To: Lars Ingebrigtsen; +Cc: 17707
> > 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?
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#17707: 24.4.50; doc string of `align-newline-and-indent'
2016-04-29 22:24 ` Drew Adams
@ 2016-04-29 22:28 ` Lars Ingebrigtsen
2016-04-29 22:56 ` Drew Adams
0 siblings, 1 reply; 5+ messages in thread
From: Lars Ingebrigtsen @ 2016-04-29 22:28 UTC (permalink / raw)
To: Drew Adams; +Cc: 17707
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
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#17707: 24.4.50; doc string of `align-newline-and-indent'
2016-04-29 22:28 ` Lars Ingebrigtsen
@ 2016-04-29 22:56 ` Drew Adams
0 siblings, 0 replies; 5+ messages in thread
From: Drew Adams @ 2016-04-29 22:56 UTC (permalink / raw)
To: Lars Ingebrigtsen; +Cc: 17707
> >> > 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.
Do you think it does, for what `align-newline-and-indent' does?
If so, can you describe what it does for `align-newline-and-indent'?
If no, then you, like I, are wondering. If yes, then please
add that description to the doc string.
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2016-04-29 22:56 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2014-06-05 21:21 bug#17707: 24.4.50; doc string of `align-newline-and-indent' Drew Adams
2016-04-29 20:14 ` Lars Ingebrigtsen
2016-04-29 22:24 ` Drew Adams
2016-04-29 22:28 ` Lars Ingebrigtsen
2016-04-29 22:56 ` Drew Adams
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).