From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: John Shahid Newsgroups: gmane.emacs.help Subject: linum-mode docstring is unclear Date: Sat, 24 Feb 2018 17:31:37 -0500 Message-ID: <87muzyow8m.fsf@gmail.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1519511848 19953 195.159.176.226 (24 Feb 2018 22:37:28 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 24 Feb 2018 22:37:28 +0000 (UTC) User-Agent: mu4e 1.0-alpha3; emacs 26.0.91 To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Sat Feb 24 23:37:24 2018 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1epiRX-0004lk-Qi for geh-help-gnu-emacs@m.gmane.org; Sat, 24 Feb 2018 23:37:23 +0100 Original-Received: from localhost ([::1]:51750 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1epiTa-0001Vd-6t for geh-help-gnu-emacs@m.gmane.org; Sat, 24 Feb 2018 17:39:30 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56631) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1epiM8-00009e-KW for help-gnu-emacs@gnu.org; Sat, 24 Feb 2018 17:31:49 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1epiM5-0007ew-BW for help-gnu-emacs@gnu.org; Sat, 24 Feb 2018 17:31:48 -0500 Original-Received: from mail-qk0-x232.google.com ([2607:f8b0:400d:c09::232]:46407) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1epiM5-0007eb-7s for help-gnu-emacs@gnu.org; Sat, 24 Feb 2018 17:31:45 -0500 Original-Received: by mail-qk0-x232.google.com with SMTP id 130so10206787qkd.13 for ; Sat, 24 Feb 2018 14:31:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=user-agent:from:to:subject:date:message-id:mime-version :content-transfer-encoding; bh=tAb5dTfESxAwWrf36P0tTdpSADlm33r7G1blCvWbG2Q=; b=d5JzDGvFHpITItx16MCW5DEwyriSOBrrAjpwc4jhV4dMP11KB5EK0jbwObn+Eo5wuO arBJ60qNkM08FUDDDS3IYb2BYTqGf7DbO1u6deefbMgCqkMMeqwY1GDcjQejIcqrlr0X 4DYvwWgbi7HM+BH0T29V30KNquiNEsLV9lV2vkkLW0jNXoKRSnQZgSlVVWWMmE2wnr1Q EaAJbglzgxwxgYMQzcSwnyWuwqSWq4iHwdypE62KVh3NBm3HrAvB12urOddthze1CDgA vKn2wsUO5tEXK2GDDC1MOLnFDLbOw+Wx/kFcF/54DDbWWr3uxb1ocT1qkJ+C1n2Y3m63 2Sdw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:user-agent:from:to:subject:date:message-id :mime-version:content-transfer-encoding; bh=tAb5dTfESxAwWrf36P0tTdpSADlm33r7G1blCvWbG2Q=; b=ACKRDZS/2I303AWOQKKGulb2Djtx9YjLLyN53eVqeU4RNgqrqBj0MvEOCK8xmA8Ses oX1f6CyieAZtYiqRPOqy9Xg/202dAtpvuw2iJBfRmQXseX9pLuB80xcQifY510woho9f /2pxutBTpf+s+zyOPTkUOUfdXQDE5os3gONPM1TkscuPGybx9ovYdwU1utiERju4aVTr eOKtJA3E9yZWJU53T3swr3NcrjX5xW/N+dScbxnSCXv78o3pu42V1xe1J5JweTptBW9L x0mG3x4EsziGJOZHXyVdHDZUMX5H/IgdzfBLG2gf1K0Ev/UONzOj0s2aMS9MhlNRgga8 sdgw== X-Gm-Message-State: APf1xPCnyz78UqqPzhcxTU9RzzPthTJvqbNEHqP6ilUL7/aclO0RTrnh BFRd2vr+QghXuYJy7ksyTlob5KPv X-Google-Smtp-Source: AG47ELt/Nn1zT2fTJ54T1xo0dEI92EvbDLCAAc4z397O7ds+fxf1Sqo114OV/ekXCATBcH6x/csRDA== X-Received: by 10.55.110.194 with SMTP id j185mr9900106qkc.327.1519511504096; Sat, 24 Feb 2018 14:31:44 -0800 (PST) Original-Received: from amun (cpe-184-152-54-116.nyc.res.rr.com. [184.152.54.116]) by smtp.gmail.com with ESMTPSA id u16sm1390474qke.97.2018.02.24.14.31.43 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 24 Feb 2018 14:31:43 -0800 (PST) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:400d:c09::232 X-Mailman-Approved-At: Sat, 24 Feb 2018 17:39:00 -0500 X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.org gmane.emacs.help:116071 Archived-At: Hey all, I think the linum-mode docstring is unclear about when the mode is turned on when called from Lisp. According to the docstring: ".... If called from Lisp, enable the mode if ARG is omitted or nil." This isn't true. In fact, passing any value other than 0 will turn on the mode. Furthermore, the docstring doesn't mention that passing 'toggle will toggle the state of the mode. WDYT, is that something that can be/need clarification ? I was thinking about borrowing the following from define-minor-mode: "When called from Lisp, the mode command toggles the mode if the argument is =E2=80=98toggle=E2=80=99, disables the mode if the argument i= s a non-positive integer, and enables the mode otherwise (including if the argument is omitted or nil or a positive integer)." - js