From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Noam Postavsky Newsgroups: gmane.emacs.bugs Subject: bug#24607: 25.1; comment-dwim doc is confused Date: Tue, 13 Feb 2018 22:25:17 -0500 Message-ID: <87zi4c8d7m.fsf@users.sourceforge.net> References: <201610041140493910850@yahoo.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 1518578737 25740 195.159.176.226 (14 Feb 2018 03:25:37 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 14 Feb 2018 03:25:37 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.90 (gnu/linux) Cc: 24607@debbugs.gnu.org To: "liu.huanjie\@yahoo.com" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Feb 14 04:25:33 2018 Return-path: Envelope-to: geb-bug-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 1elnhF-0005qO-Px for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Feb 2018 04:25:25 +0100 Original-Received: from localhost ([::1]:56935 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1elnjF-0000By-SZ for geb-bug-gnu-emacs@m.gmane.org; Tue, 13 Feb 2018 22:27:29 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59633) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1elnhv-0007rV-Sb for bug-gnu-emacs@gnu.org; Tue, 13 Feb 2018 22:26:09 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1elnhq-0003bI-VK for bug-gnu-emacs@gnu.org; Tue, 13 Feb 2018 22:26:07 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:34141) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1elnhq-0003az-Qx for bug-gnu-emacs@gnu.org; Tue, 13 Feb 2018 22:26:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1elnhq-0003xD-Fo for bug-gnu-emacs@gnu.org; Tue, 13 Feb 2018 22:26:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 14 Feb 2018 03:26:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24607 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 24607-submit@debbugs.gnu.org id=B24607.151857872815157 (code B ref 24607); Wed, 14 Feb 2018 03:26:02 +0000 Original-Received: (at 24607) by debbugs.gnu.org; 14 Feb 2018 03:25:28 +0000 Original-Received: from localhost ([127.0.0.1]:42038 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1elnhH-0003wP-Vi for submit@debbugs.gnu.org; Tue, 13 Feb 2018 22:25:28 -0500 Original-Received: from mail-io0-f177.google.com ([209.85.223.177]:36368) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1elnhF-0003wC-EK for 24607@debbugs.gnu.org; Tue, 13 Feb 2018 22:25:25 -0500 Original-Received: by mail-io0-f177.google.com with SMTP id t22so3702228iob.3 for <24607@debbugs.gnu.org>; Tue, 13 Feb 2018 19:25:25 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=57Cyhm6TIUjHIb4A6GHbyndxYSF9VVx+MAqy4lVQW/Y=; b=THZhEXdK0ziiHtqcOV27PXEIfZSKCgdBsJgReMu49nP+NyWi8Xh8qVDF1dOsLR8HQy yQaUhsAEqj9w8wa3DxW5Tr9/d8CYS7qzq3XReBG4F2tv/J7qZ1cMoNL/TjGES0wgGXJI 0Tubb0N0TNW3Rgq/iaG+252mj7JtXsgn5GMKxN9UnxksRq8Vl6jphhxlRG1c7/rcUU5H /AjPjG2757yly7O5++4qyC8IfbixIpjQLdHr0+PaSTIzErPOClBVNypUSDN7jCRQXepi 0XaEW9EsaKLdR1fFmPgU//HOm3K8Ek2fkh+e87MQDnMblUC804WlrmKbAaaImul5JtEx LxPw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version :content-transfer-encoding; bh=57Cyhm6TIUjHIb4A6GHbyndxYSF9VVx+MAqy4lVQW/Y=; b=Cff/+IvmqEHmhl5VxG3CXKJJq3syNhscdONjyXTUsplNBdi9izUI7ttgPQeSWigGHM F0q1BpwKPQuPxy+QiBegWwMfVqnqhtzon3Ceqo5wrf6KF9kWYVfDbl3F0XNsoNmMnB1J HjnBmcDqlhUo/9q6y4rNt/GxTy7IcpbGFTrM1qtzjAXWECTe5vaE79L5P+lLY9HDr2FC zaiWN5Gl73kz85UJr8bEq8hRDqFjfyepPLQjKWFCx+4RHfEp3Og+6tg8sRvrKs9UbtTu bK0hsDOE1rChvMSz2qr91oR6FI17LAy8TihBXSAd0CzOm1pE2ysI6O8GWobTTfaOXsWv s0nQ== X-Gm-Message-State: APf1xPA6g6Oo7CJfoUC+ULPmaONkMypLAZSaHHbxBJsQ9IqVPs6Hxnrt fghIvXReGKMoFna8cisq2yx5+g== X-Google-Smtp-Source: AH8x225iIscRJHykbDqCrOcw9FL1LxvnAlEi9UNf4SS+K+ECP7T7r/a/sChgNInV7St9DrPDSfooJg== X-Received: by 10.107.151.209 with SMTP id z200mr3781861iod.29.1518578719817; Tue, 13 Feb 2018 19:25:19 -0800 (PST) Original-Received: from zebian (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34]) by smtp.googlemail.com with ESMTPSA id b72sm7873533iob.50.2018.02.13.19.25.18 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 13 Feb 2018 19:25:18 -0800 (PST) In-Reply-To: <201610041140493910850@yahoo.com> (liu's message of "Tue, 4 Oct 2016 11:40:52 +0800") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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" Xref: news.gmane.org gmane.emacs.bugs:143266 Archived-At: "liu.huanjie@yahoo.com" writes: > Today I try to write a function that call comment-dwim, it works > when I 'M-x comment-dwim', but when I call it as (comment-dwim), it > says wrong argument number, but after checking the doc and read the > source, I still can't figure out how to give args, which what I want > is the current line where my cursor is. > I add 'nil' to 'comment-dwim' and fixed, but it will be better to > add something about what args should a caller give, and that will > not confused to at least elisp newbie, and it is better. The docstring says (comment-dwim ARG) [...] Else if a prefix ARG is specified, call =E2=80=98comment-kill=E2=80=99. It's a bit terse, but `(elisp) Prefix Command Arguments' says * `nil', meaning there is no prefix argument. as a possible value for prefix arguments. I don't think we should explain that again in every function docstring which takes a prefix argument.