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#13926: 24.3.50; doc string of `visual-line-mode' Date: Mon, 11 Mar 2013 13:19:30 -0700 Message-ID: <25665444134D45E08D468EC49539ACEA@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1363033214 395 80.91.229.3 (11 Mar 2013 20:20:14 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 11 Mar 2013 20:20:14 +0000 (UTC) To: 13926@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Mar 11 21:20:39 2013 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UF9D3-0007Dy-Sz for geb-bug-gnu-emacs@m.gmane.org; Mon, 11 Mar 2013 21:20:38 +0100 Original-Received: from localhost ([::1]:60440 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UF9Ch-0005Gw-3H for geb-bug-gnu-emacs@m.gmane.org; Mon, 11 Mar 2013 16:20:15 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:38728) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UF9Cb-0005Fi-AA for bug-gnu-emacs@gnu.org; Mon, 11 Mar 2013 16:20:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UF9CZ-0004Gh-DJ for bug-gnu-emacs@gnu.org; Mon, 11 Mar 2013 16:20:09 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:42727) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UF9CZ-0004GX-AO for bug-gnu-emacs@gnu.org; Mon, 11 Mar 2013 16:20:07 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1UF9DS-0008Tr-Bg for bug-gnu-emacs@gnu.org; Mon, 11 Mar 2013 16:21:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 11 Mar 2013 20:21:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 13926 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.136303324732573 (code B ref -1); Mon, 11 Mar 2013 20:21:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 11 Mar 2013 20:20:47 +0000 Original-Received: from localhost ([127.0.0.1]:46836 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1UF9DC-0008TK-Pl for submit@debbugs.gnu.org; Mon, 11 Mar 2013 16:20:47 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:55383) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1UF9DA-0008T8-BT for submit@debbugs.gnu.org; Mon, 11 Mar 2013 16:20:45 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UF9C9-0003f3-4b for submit@debbugs.gnu.org; Mon, 11 Mar 2013 16:19:43 -0400 Original-Received: from lists.gnu.org ([208.118.235.17]:41778) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UF9C9-0003ez-1R for submit@debbugs.gnu.org; Mon, 11 Mar 2013 16:19:41 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:38474) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UF9C6-00059l-AW for bug-gnu-emacs@gnu.org; Mon, 11 Mar 2013 16:19:40 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UF9C2-0003dI-Jq for bug-gnu-emacs@gnu.org; Mon, 11 Mar 2013 16:19:38 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:28117) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UF9C2-0003d7-Bk for bug-gnu-emacs@gnu.org; Mon, 11 Mar 2013 16:19:34 -0400 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by userp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r2BKJXaO002438 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 11 Mar 2013 20:19:33 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r2BKJWg3011745 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Mon, 11 Mar 2013 20:19:32 GMT Original-Received: from abhmt115.oracle.com (abhmt115.oracle.com [141.146.116.67]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id r2BKJVOM000358 for ; Mon, 11 Mar 2013 15:19:32 -0500 Original-Received: from dradamslap1 (/130.35.178.8) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 11 Mar 2013 13:19:31 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac4elbzSXp0yqPiQQLK1co3dOBgK7g== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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:72336 Archived-At: The doc string is misleading wrt the argument when called from Lisp. With a prefix argument ARG, enable Visual Line mode if ARG is positive, and disable it otherwise. If called from Lisp, enable the mode if ARG is omitted or nil. This makes no connection between the interactive prefix arg and the arg when called from Lisp. In particular, it can also give the incorrect impression that the mode is enabled ONLY if ARG is omitted or nil. There is nothing that suggests the behavior of a non-positive or positive ARG when called from Lisp. By way of contrast, the doc string of `define-minor-mode' correctly says what the argument values do when called from Lisp: When called from Lisp, the mode command toggles the mode if the argument is `toggle', disables the mode if the argument is a non-positive integer, and enables the mode otherwise (including if the argument is omitted or nil or a positive integer). This kind of careful description should probably be added automatically to functions defined by `define-minor-mode', to prevent misleading doc wrt the argument. In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600) of 2013-03-04 on ODIEONE Bzr revision: 111935 yamaoka@jpl.org-20130304102733-4qy111z41qwoh2as Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -IC:/Devel/emacs/build/include --ldflags -LC:/Devel/emacs/build/lib'