Bug reports for GNU Emacs, the Swiss army knife of text editors

Michael Heerdegen | 2 Jul 2012 04:22

bug#11836: 24.1.50; docstring of `kill-whole-line' insufficient

Hi,

yes, it just says:

"If non-nil, `kill-line' with no arg at beg of line kills the whole
line."

But what does `kill-line' if `kill-whole-line' is nil?  Does it kill a
half of the line?  Does it do nothing?  The docstring doesn't provide
any help at all unless you already know the background.  So, please
add something like:

"This means that the entire line including the final newline is
killed."

Or clarify it some other way.

Thanks,

Michael.

In GNU Emacs 24.1.50.1 (i486-pc-linux-gnu, GTK+ Version 3.4.2)
 of 2012-07-01 on keller, modified by Debian
 (emacs-snapshot package, version 2:20120701-1)
Windowing system distributor `The X.Org Foundation', version 11.0.11201902
Configured using:
 `configure '--build' 'i486-linux-gnu' '--host' 'i486-linux-gnu'
 '--prefix=/usr' '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib'
 '--localstatedir=/var' '--infodir=/usr/share/info'
 '--mandir=/usr/share/man' '--with-pop=yes'

(Continue reading)

headers

Andreas Schwab | 2 Jul 2012 09:28

bug#11836: 24.1.50; docstring of `kill-whole-line' insufficient

Michael Heerdegen <michael_heerdegen <at> web.de> writes:

> But what does `kill-line' if `kill-whole-line' is nil? 

It does what kill-line says it does.

Andreas.

--

-- 
Andreas Schwab, schwab <at> linux-m68k.org
GPG Key fingerprint = 58CA 54C7 6D53 942B 1756  01D3 44D5 214B 8276 4ED5
"And now for something completely different."

headers

Glenn Morris | 3 Jul 2012 00:45

bug#11836: 24.1.50; docstring of `kill-whole-line' insufficient

tags 11836 notabug wontfix
close 11836
stop

Andreas Schwab wrote:

> Michael Heerdegen <michael_heerdegen <at> web.de> writes:
>
>> But what does `kill-line' if `kill-whole-line' is nil? 
>
> It does what kill-line says it does.

I agree there's no need to duplicate the doc of kill-line in the doc of
one option that affects it. The former is hyperlinked from the latter,
and is the obvious place to look.