bug#8614: 24.0.50; doc of `deactivate-mark'

[Drew Adams]

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'