GNU bug report logs - #5215
23.1.50; blink-cursor-mode docstring

Previous Next

Package: emacs;

Reported by: jidanni <at> jidanni.org

Date: Tue, 15 Dec 2009 00:05:04 UTC

Severity: normal

Done: Glenn Morris <rgm <at> gnu.org>

Bug is archived. No further changes may be made.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 5215 in the body.
You can then email your comments to 5215 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-submit-list <at> lists.donarmstrong.com, Emacs Bugs <bug-gnu-emacs <at> gnu.org>:
bug#5215; Package emacs. (Tue, 15 Dec 2009 00:05:05 GMT) Full text and rfc822 format available.
Acknowledgement sent to jidanni <at> jidanni.org:
New bug report received and forwarded. Copy sent to Emacs Bugs <bug-gnu-emacs <at> gnu.org>. (Tue, 15 Dec 2009 00:05:05 GMT) Full text and rfc822 format available.

Message #5 received at submit <at> emacsbugs.donarmstrong.com (full text, mbox):

From: jidanni <at> jidanni.org
To: emacs-pretest-bug <at> gnu.org
Subject: 23.1.50; blink-cursor-mode docstring
Date: Tue, 15 Dec 2009 05:40:15 +0800

One finds
(custom-set-variables
 '(blink-cursor-mode nil)...
However
  blink-cursor-mode is an interactive compiled Lisp function in...
  With a numeric argument, turn blinking cursor mode on if ARG is
  positive,...
But only numeric arguments are mentioned. And a quick peek in the Emacs
Lisp manual doesn't say if nil is a numeric argument. Therefore the
docstring of blink-cursor-mode should be beefed up perhaps.

Compare
  size-indication-mode is an interactive compiled Lisp function in...
  With ARG, turn Size Indication mode on if ARG is positive...
Information forwarded to bug-submit-list <at> lists.donarmstrong.com, Emacs Bugs <bug-gnu-emacs <at> gnu.org>:
bug#5215; Package emacs. (Tue, 15 Dec 2009 08:35:03 GMT) Full text and rfc822 format available.
Acknowledgement sent to Kevin Rodgers <kevin.d.rodgers <at> gmail.com>:
Extra info received and forwarded to list. Copy sent to Emacs Bugs <bug-gnu-emacs <at> gnu.org>. (Tue, 15 Dec 2009 08:35:04 GMT) Full text and rfc822 format available.

Message #10 received at submit <at> emacsbugs.donarmstrong.com (full text, mbox):

From: Kevin Rodgers <kevin.d.rodgers <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Cc: emacs-pretest-bug <at> gnu.org
Subject: Re: bug#5215: 23.1.50; blink-cursor-mode docstring
Date: Tue, 15 Dec 2009 01:27:11 -0700

jidanni <at> jidanni.org wrote:
> One finds
> (custom-set-variables
>  '(blink-cursor-mode nil)...
> However
>   blink-cursor-mode is an interactive compiled Lisp function in...
>   With a numeric argument, turn blinking cursor mode on if ARG is
>   positive,...

According to its doc string, custom-set-variables sets each SYMBOL's
value cell.  It does not call each SYBMOL's function cell.

Do you understand the difference between a variable and a function?

> But only numeric arguments are mentioned. And a quick peek in the Emacs
> Lisp manual doesn't say if nil is a numeric argument. Therefore the
> docstring of blink-cursor-mode should be beefed up perhaps.
> 
> Compare
>   size-indication-mode is an interactive compiled Lisp function in...
>   With ARG, turn Size Indication mode on if ARG is positive...

-- 
Kevin Rodgers
Denver, Colorado, USA
bug closed, send any further explanations to jidanni <at> jidanni.org Request was from Glenn Morris <rgm <at> gnu.org> to control <at> debbugs.gnu.org. (Fri, 15 Jan 2010 02:35:01 GMT) Full text and rfc822 format available.
bug archived. Request was from Debbugs Internal Request <bug-gnu-emacs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Fri, 12 Feb 2010 12:24:04 GMT) Full text and rfc822 format available.
This bug report was last modified 15 years and 132 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.