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

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

[Michael Heerdegen]

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'
 '--enable-locallisppath=/etc/emacs-snapshot:/etc/emacs:/usr/local/share/emacs/24.1.50/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/24.1.50/site-lisp:/usr/share/emacs/site-lisp'
 '--without-compress-info' '--with-crt-dir=/usr/lib/i386-linux-gnu/'
 '--with-x=yes' '--with-x-toolkit=gtk3' '--with-imagemagick=yes'
 'build_alias=i486-linux-gnu' 'host_alias=i486-linux-gnu'
 'CFLAGS=-DDEBIAN -DSITELOAD_PURESIZE_EXTRA=5000 -g -O2' 'LDFLAGS=-g
 -Wl,--as-needed -znocombreloc' 'CPPFLAGS=-D_FORTIFY_SOURCE=2''

Important settings:
  value of $LC_ALL: de_DE.utf8
  value of $LC_TIME: C
  value of $LANG: de_DE.utf8
  locale-coding-system: utf-8-unix
  default enable-multibyte-characters: t

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

[Andreas Schwab]

Michael Heerdegen <michael_heerdegen@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@linux-m68k.org
GPG Key fingerprint = 58CA 54C7 6D53 942B 1756  01D3 44D5 214B 8276 4ED5
"And now for something completely different."

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

[Glenn Morris]

tags 11836 notabug wontfix
close 11836
stop

Andreas Schwab wrote:

> Michael Heerdegen <michael_heerdegen@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.