* bug#8614: 24.0.50; doc of `deactivate-mark'
@ 2011-05-04 16:16 Drew Adams
2011-07-15 13:21 ` Lars Magne Ingebrigtsen
2012-01-28 14:30 ` Chong Yidong
0 siblings, 2 replies; 4+ messages in thread
From: Drew Adams @ 2011-05-04 16:16 UTC (permalink / raw)
To: 8614
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'
^ permalink raw reply [flat|nested] 4+ messages in thread
* bug#8614: 24.0.50; doc of `deactivate-mark'
2011-05-04 16:16 bug#8614: 24.0.50; doc of `deactivate-mark' Drew Adams
@ 2011-07-15 13:21 ` Lars Magne Ingebrigtsen
2011-07-15 14:13 ` Drew Adams
2012-01-28 14:30 ` Chong Yidong
1 sibling, 1 reply; 4+ messages in thread
From: Lars Magne Ingebrigtsen @ 2011-07-15 13:21 UTC (permalink / raw)
To: Drew Adams; +Cc: 8614
"Drew Adams" <drew.adams@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/
^ permalink raw reply [flat|nested] 4+ messages in thread
* bug#8614: 24.0.50; doc of `deactivate-mark'
2011-07-15 13:21 ` Lars Magne Ingebrigtsen
@ 2011-07-15 14:13 ` Drew Adams
0 siblings, 0 replies; 4+ messages in thread
From: Drew Adams @ 2011-07-15 14:13 UTC (permalink / raw)
To: 'Lars Magne Ingebrigtsen'; +Cc: 8614
> > 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.
^ permalink raw reply [flat|nested] 4+ messages in thread
* bug#8614: 24.0.50; doc of `deactivate-mark'
2011-05-04 16:16 bug#8614: 24.0.50; doc of `deactivate-mark' Drew Adams
2011-07-15 13:21 ` Lars Magne Ingebrigtsen
@ 2012-01-28 14:30 ` Chong Yidong
1 sibling, 0 replies; 4+ messages in thread
From: Chong Yidong @ 2012-01-28 14:30 UTC (permalink / raw)
To: Drew Adams; +Cc: 8614
"Drew Adams" <drew.adams@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.
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2012-01-28 14:30 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2011-05-04 16:16 bug#8614: 24.0.50; doc of `deactivate-mark' Drew Adams
2011-07-15 13:21 ` Lars Magne Ingebrigtsen
2011-07-15 14:13 ` Drew Adams
2012-01-28 14:30 ` Chong Yidong
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).