From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#8614: 24.0.50; doc of `deactivate-mark' Date: Fri, 15 Jul 2011 07:13:37 -0700 Message-ID: <6EF7F068BC364B2396FDFD2D3A111799@us.oracle.com> References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1310739882 10781 80.91.229.12 (15 Jul 2011 14:24:42 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 15 Jul 2011 14:24:42 +0000 (UTC) Cc: 8614@debbugs.gnu.org To: "'Lars Magne Ingebrigtsen'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jul 15 16:24:38 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1QhjJl-0001Cr-Is for geb-bug-gnu-emacs@m.gmane.org; Fri, 15 Jul 2011 16:24:37 +0200 Original-Received: from localhost ([::1]:54840 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhjJk-0001gj-1C for geb-bug-gnu-emacs@m.gmane.org; Fri, 15 Jul 2011 10:24:36 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:52658) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qhj9Z-0007ca-If for bug-gnu-emacs@gnu.org; Fri, 15 Jul 2011 10:14:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qhj9X-0002xj-2y for bug-gnu-emacs@gnu.org; Fri, 15 Jul 2011 10:14:05 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:36185) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qhj9W-0002xY-Px for bug-gnu-emacs@gnu.org; Fri, 15 Jul 2011 10:14:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Qhj9W-0000jI-5P; Fri, 15 Jul 2011 10:14:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 15 Jul 2011 14:14:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 8614 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 8614-submit@debbugs.gnu.org id=B8614.13107392352780 (code B ref 8614); Fri, 15 Jul 2011 14:14:02 +0000 Original-Received: (at 8614) by debbugs.gnu.org; 15 Jul 2011 14:13:55 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qhj9O-0000in-8Q for submit@debbugs.gnu.org; Fri, 15 Jul 2011 10:13:54 -0400 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qhj9M-0000ia-5l for 8614@debbugs.gnu.org; Fri, 15 Jul 2011 10:13:52 -0400 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p6FEDiQ1015754 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 15 Jul 2011 14:13:46 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p6FEDhNl004911 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 15 Jul 2011 14:13:44 GMT Original-Received: from abhmt103.oracle.com (abhmt103.oracle.com [141.146.116.55]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p6FEDcSF021425; Fri, 15 Jul 2011 09:13:38 -0500 Original-Received: from dradamslap1 (/10.159.34.212) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 15 Jul 2011 07:13:37 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: AcxC8qaCzzlYvGN8RLec2xrwTo56qAABg1Yg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090207.4E204B1A.0089:SCFMA922111,ss=1,re=-4.000,fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Fri, 15 Jul 2011 10:14:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:49141 Archived-At: > > 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.