* 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 external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.