GNU bug report logs - #8614
24.0.50; doc of `deactivate-mark'

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 8614 in the body.
You can then email your comments to 8614 AT debbugs.gnu.org in the normal way.

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

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

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 24.0.50; doc of `deactivate-mark'
Date: Wed, 4 May 2011 09:16:35 -0700

The doc for this function is now woefully inadequate.  The function does
much, much more nowadays than is hinted in the doc.  Please update the
doc to describe ALL of the many things that this function does,
including conditional behavior that depends on the current context,
including various variables.

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2011-04-25 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.5) --no-opt --cflags
-Ic:/imagesupport/include'
 

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

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 8614 <at> debbugs.gnu.org
Subject: Re: 24.0.50; doc of `deactivate-mark'
Date: Fri, 15 Jul 2011 15:21:10 +0200

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

> The doc for this function is now woefully inadequate.  The function does
> much, much more nowadays than is hinted in the doc.  Please update the
> doc to describe ALL of the many things that this function does,
> including conditional behavior that depends on the current context,
> including various variables.

Do you have a suggestion for a new doc string?

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

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

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Lars Magne Ingebrigtsen'" <larsi <at> gnus.org>
Cc: 8614 <at> debbugs.gnu.org
Subject: RE: 24.0.50; doc of `deactivate-mark'
Date: Fri, 15 Jul 2011 07:13:37 -0700

> > The doc for this function is now woefully inadequate.  The 
> > function does much, much more nowadays than is hinted in the
> > doc.  Please update the doc to describe ALL of the many things
> > that this function does, including conditional behavior that
> > depends on the current context, including various variables.
> 
> Do you have a suggestion for a new doc string?

Sorry, I'm not the expert on what it does.  But it is clear to even me that it
does much more than is suggested in the doc.

If someone comes up with a complete list of what to say about what it does then
I can suggest wording.  Someone knowledgable needs to come up with the content.

"Someone knowledgable" could include those who have changed its behavior most
recently.  When the behavior is extended and becomes more complex, so can the
doc need to be updated.

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

From: Chong Yidong <cyd <at> gnu.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 8614 <at> debbugs.gnu.org
Subject: Re: bug#8614: 24.0.50; doc of `deactivate-mark'
Date: Sat, 28 Jan 2012 22:30:11 +0800

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

> The doc for this function is now woefully inadequate.  The function does
> much, much more nowadays than is hinted in the doc.  Please update the
> doc to describe ALL of the many things that this function does,
> including conditional behavior that depends on the current context,
> including various variables.

Fixed, thanks.

Previous Next

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