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: Re: linum-mode docstring is unclear Date: Sun, 25 Feb 2018 15:29:01 -0500 Message-ID: <878tbgke42.fsf@gmail.com> References: <86d10uq9x8.fsf@zoho.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1519590471 15910 195.159.176.226 (25 Feb 2018 20:27:51 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 25 Feb 2018 20:27:51 +0000 (UTC) User-Agent: mu4e 1.0-alpha3; emacs 26.0.91 Cc: help-gnu-emacs@gnu.org To: Emanuel Berg Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Sun Feb 25 21:27:46 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 1eq2te-0003eN-D0 for geh-help-gnu-emacs@m.gmane.org; Sun, 25 Feb 2018 21:27:46 +0100 Original-Received: from localhost ([::1]:55775 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eq2vf-0003tH-1m for geh-help-gnu-emacs@m.gmane.org; Sun, 25 Feb 2018 15:29:51 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50065) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eq2ux-0003sh-Lb for help-gnu-emacs@gnu.org; Sun, 25 Feb 2018 15:29:09 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eq2ut-00005y-MV for help-gnu-emacs@gnu.org; Sun, 25 Feb 2018 15:29:07 -0500 Original-Received: from mail-qt0-x22c.google.com ([2607:f8b0:400d:c0d::22c]:37296) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eq2ut-000052-I1 for help-gnu-emacs@gnu.org; Sun, 25 Feb 2018 15:29:03 -0500 Original-Received: by mail-qt0-x22c.google.com with SMTP id r16so7631701qtm.4 for ; Sun, 25 Feb 2018 12:29:03 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=references:user-agent:from:to:cc:subject:in-reply-to:date :message-id:mime-version; bh=YDqjK1ClH2GKsqGl3PnbqCuB5ZUOrsfuYm1BiUSHfO4=; b=dL8GwiIKlP1KWPu83A9yBGsXvlLDkfPt7G1tHt7Gv8VWHx07ytFmOltGY1hOytaEXg H0TEZe3eNKrjozNlrPcRDM8a84GPWwxY6y3gmh6r2v0AnBEp7bFTHq8rnJ5UwOne7DNx LK9wN+PW1Qc866lkBd/YwVbcxxxq6hS3Qx3Cc9Y2d6kGLNOsuvYciqyusPQMl0i42Nrr bo3vTOmW76rVXjEWxSA+iJUWszmBMXB/U+AcETHonDRCcnL1Rd9up8fVfiewKNwgJsuX jD8jRSH/1RUlsjA0MRTM1uOmrGMq0W5nluk+iQo92kqWKcoJFqrAYyyCTeul5o4MjN1E x6XQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:references:user-agent:from:to:cc:subject :in-reply-to:date:message-id:mime-version; bh=YDqjK1ClH2GKsqGl3PnbqCuB5ZUOrsfuYm1BiUSHfO4=; b=r5xG0UqBcH/EhgJykVHd0T7CMpGjaTS4CRc6Raj/DwG4s/eNpX1/YBEiRYVZFRjGMs 3DdrhJ5HLMJS4T2N4ia+TQ3y1QL3uw7PIzhy1bYXdzWrsrW/4t9L7aRHE2LKDBuE8K3x FaJG9zcVF3i0r8xolB5ZbbTTUJQJ9p25YQPyw9qT3uCMyja/y71TudpERkYguMoGqIIW v5QF3eI+zZUQlpEXWA631HVDnJyTcQEe6ZTVw8patH95HOwCCu+DArPcYwfznm2RzG4s xdEApseN7zKiVXNa/Nh9Kj8dmZD34ZtqbbkVj2s8H+aQ0yytAySBw3O7iYiLg0+m/6SK hyPQ== X-Gm-Message-State: APf1xPDxA0pGJLWBUxLTM75mFbUnNCtvM7Kk4sOK/XnxiLs742kHozsA WDiAV6G83kY1LVtqjowUrLhKTAd/ X-Google-Smtp-Source: AG47ELtY4c4Ri7AcySmbI65zeg3uuI4KQ5l2R+jj1tpJ48y3KAAINRcRDZ4NZqDFFbwr/UkWwWGGjQ== X-Received: by 10.200.20.141 with SMTP id l13mr10537081qtj.156.1519590542723; Sun, 25 Feb 2018 12:29:02 -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 m8sm826718qkm.26.2018.02.25.12.29.01 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 25 Feb 2018 12:29:02 -0800 (PST) In-reply-to: <86d10uq9x8.fsf@zoho.com> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:400d:c0d::22c 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:116078 Archived-At: I guess any mode that uses define-minor-mode is susceptible to this kind of problem. That said, I'm not aware about other modes with similar phrasing issues. I also sent a patch to fix linum-mode docstring to bug-gnu-emacs@gnu.org. cheers, -js Emanuel Berg writes: > John Shahid wrote: > >> 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 ? > > Well, obviously :) > > I wonder if this is a general problem/phrasing > that appears more than once?