GNU bug report logs - #3856
23.0.96; doc string of `widget-complete'

Previous Next

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

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

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

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <emacs-pretest-bug <at> gnu.org>
Subject: 23.0.96; doc string of `widget-complete'
Date: Wed, 15 Jul 2009 08:51:07 -0700

Doc string:
 
  Complete content of editable field from point.
  When not inside a field, move to the previous button or field.
 
Remove the second sentence; it makes no sense.
`widget-complete' is used only for a field.
 
 
 
In GNU Emacs 23.0.96.1 (i386-mingw-nt5.1.2600)
 of 2009-07-09 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'
 

Message #10 received at 3856 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 3856 <at> debbugs.gnu.org
Subject: Re: 23.0.96; doc string of `widget-complete'
Date: Tue, 12 Jul 2011 17:28:26 +0200

"Drew Adams" <drew.adams <at> oracle.com> writes:

> Doc string:
>
>   Complete content of editable field from point.
>   When not inside a field, move to the previous button or field.
>
> Remove the second sentence; it makes no sense.
> `widget-complete' is used only for a field.

This has been changed to:

---
;; This used to say:
;; "When not inside a field, move to the previous button or field."
;; but AFAICS, it has always just thrown an error.
(defun widget-complete ()
  "Complete content of editable field from point.
When not inside a field, signal an error."
---

But I think you're right, anyway.  This is only bound to a keystroke on
widget fields (as far as I can tell), so it seems unnecessary to say
anything about what happens if you call the function from somewhere
else.

Opinions?

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

Message #13 received at 3856 <at> debbugs.gnu.org (full text, mbox):

From: Chong Yidong <cyd <at> stupidchicken.com>
To: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
Cc: 3856 <at> debbugs.gnu.org, Drew Adams <drew.adams <at> oracle.com>
Subject: Re: bug#3856: 23.0.96; doc string of `widget-complete'
Date: Tue, 12 Jul 2011 11:56:16 -0400

Lars Magne Ingebrigtsen <larsi <at> gnus.org> writes:

> (defun widget-complete ()
>   "Complete content of editable field from point.
> When not inside a field, signal an error."
>
> But I think you're right, anyway.  This is only bound to a keystroke on
> widget fields (as far as I can tell), so it seems unnecessary to say
> anything about what happens if you call the function from somewhere
> else.
>
> Opinions?

It's not important, but I think the docstring fine as is.  Closing.

Previous Next

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