From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 23 Feb 2015 21:21:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 19932@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.142472643731500 (code B ref -1); Mon, 23 Feb 2015 21:21:02 +0000 Received: (at submit) by debbugs.gnu.org; 23 Feb 2015 21:20:37 +0000 Received: from localhost ([127.0.0.1]:55872 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQ0Qe-0008Bq-C2 for submit@debbugs.gnu.org; Mon, 23 Feb 2015 16:20:36 -0500 Received: from eggs.gnu.org ([208.118.235.92]:48984) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQ0Qb-0008Bb-TC for submit@debbugs.gnu.org; Mon, 23 Feb 2015 16:20:35 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YQ0QQ-0007qw-Ld for submit@debbugs.gnu.org; Mon, 23 Feb 2015 16:20:28 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:56390) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQ0QQ-0007qs-IK for submit@debbugs.gnu.org; Mon, 23 Feb 2015 16:20:22 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:50691) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQ0QP-0006vq-Ko for bug-gnu-emacs@gnu.org; Mon, 23 Feb 2015 16:20:22 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YQ0QJ-0007nP-7p for bug-gnu-emacs@gnu.org; Mon, 23 Feb 2015 16:20:21 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:30600) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQ0QJ-0007fW-0o for bug-gnu-emacs@gnu.org; Mon, 23 Feb 2015 16:20:15 -0500 Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t1NLK6Q9020220 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 23 Feb 2015 21:20:08 GMT Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t1NLK5kK010773 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Mon, 23 Feb 2015 21:20:06 GMT Received: from abhmp0013.oracle.com (abhmp0013.oracle.com [141.146.116.19]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t1NLK5np018982 for ; Mon, 23 Feb 2015 21:20:05 GMT MIME-Version: 1.0 Message-ID: Date: Mon, 23 Feb 2015 13:20:04 -0800 (PST) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] 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: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) .. should not mention the prefix arg. This is not a command, and the function code does not access `current-prefix-arg'. The doc string should say that if `prefix-numeric-value' applied to the argument to the function is 0 then... In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2014-10-20 on LEG570 Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking=3Dyes,glyphs CPPFLAGS=3D-DGLYPH_DEBUG=3D1' From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 24 Feb 2015 21:03:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams , 19932@debbugs.gnu.org Received: via spool by 19932-submit@debbugs.gnu.org id=B19932.142481172531109 (code B ref 19932); Tue, 24 Feb 2015 21:03:02 +0000 Received: (at 19932) by debbugs.gnu.org; 24 Feb 2015 21:02:05 +0000 Received: from localhost ([127.0.0.1]:57055 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQMcH-00085h-1h for submit@debbugs.gnu.org; Tue, 24 Feb 2015 16:02:05 -0500 Received: from mail-we0-f173.google.com ([74.125.82.173]:43104) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQMcF-00085D-4Y for 19932@debbugs.gnu.org; Tue, 24 Feb 2015 16:02:03 -0500 Received: by wesu56 with SMTP id u56so27766887wes.10 for <19932@debbugs.gnu.org>; Tue, 24 Feb 2015 13:01:57 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:message-id:date:from:user-agent:mime-version:to:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=hbje57ojX0sI3dBanPls/x4SgdgznXPIWmB0Y52w0Ak=; b=aA8OCg8ycEi4FL+dswvNZiqoXNvWj0mw2ONymN7FRhtQgTbFuKdMR3YkD7/SWUmeAA PXqpwErl7SmXM7k7MIXKuXziRfewn+wyuSz5+OM1+LkP5U1SSO3DG/mBADQkf+5WINlG 8TQ/sTeuxO7mTGAlc8BPd2Kpv/ASyGpawVQmBtNvpkCvCfDitwcTvn+NoFNDmsC45Mee 7Baumj/mzoCPCEbfk6TYELIqTvaN6wm3U+v54xajjJy2eNcJr2NyTLlatR9v4pcOS3g+ Xvt7jxPle6Jmsn22c11lU3EhRpaLtWju2yNY8My55Z9/qjh/SQKTqv/5/+BwF4jAdv8n i+EQ== X-Received: by 10.194.8.99 with SMTP id q3mr36925782wja.88.1424811717460; Tue, 24 Feb 2015 13:01:57 -0800 (PST) Received: from [192.168.0.185] (static-nbl2-118.cytanet.com.cy. [212.31.107.118]) by mx.google.com with ESMTPSA id uo6sm61831743wjc.49.2015.02.24.13.01.56 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 24 Feb 2015 13:01:57 -0800 (PST) Message-ID: <54ECE6C3.3000602@yandex.ru> Date: Tue, 24 Feb 2015 23:01:55 +0200 From: Dmitry Gutov User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:36.0) Gecko/20100101 Thunderbird/36.0 MIME-Version: 1.0 References: In-Reply-To: Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) On 02/23/2015 11:20 PM, Drew Adams wrote: > .. should not mention the prefix arg. This is not a command, and the > function code does not access `current-prefix-arg'. Maybe it should just be undocumented. It's a private function, and it duplicates the docstring of its only caller. From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 24 Feb 2015 21:27:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Dmitry Gutov , 19932@debbugs.gnu.org Received: via spool by 19932-submit@debbugs.gnu.org id=B19932.1424813195754 (code B ref 19932); Tue, 24 Feb 2015 21:27:02 +0000 Received: (at 19932) by debbugs.gnu.org; 24 Feb 2015 21:26:35 +0000 Received: from localhost ([127.0.0.1]:57064 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQMzz-0000C6-08 for submit@debbugs.gnu.org; Tue, 24 Feb 2015 16:26:35 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:16414) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQMzx-0000Bt-HG for 19932@debbugs.gnu.org; Tue, 24 Feb 2015 16:26:34 -0500 Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t1OLQPbg020418 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Tue, 24 Feb 2015 21:26:26 GMT Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t1OLQOef018426 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Tue, 24 Feb 2015 21:26:25 GMT Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t1OLQOXo024904; Tue, 24 Feb 2015 21:26:24 GMT MIME-Version: 1.0 Message-ID: Date: Tue, 24 Feb 2015 13:26:23 -0800 (PST) From: Drew Adams References: <54ECE6C3.3000602@yandex.ru> In-Reply-To: <54ECE6C3.3000602@yandex.ru> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > > .. should not mention the prefix arg. This is not a command, and the > > function code does not access `current-prefix-arg'. >=20 > Maybe it should just be undocumented. It's a private function, and it > duplicates the docstring of its only caller. Maybe it should be documented properly. Emacs is the self-documenting editor. Maybe developers should drop the bad habit of thinking of documentation as only a chore and as only for others. There is nothing "private" in Emacs Lisp - this is not Java or C++. And even Emacs "internal" developers deserve to take advantage of the self-documentation Emacs is intended to provide. The duplication of its caller's docstring is the bug - it should have its own documentation. From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 25 Feb 2015 04:07:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Dmitry Gutov Cc: Drew Adams , 19932@debbugs.gnu.org Received: via spool by 19932-submit@debbugs.gnu.org id=B19932.14248371895333 (code B ref 19932); Wed, 25 Feb 2015 04:07:02 +0000 Received: (at 19932) by debbugs.gnu.org; 25 Feb 2015 04:06:29 +0000 Received: from localhost ([127.0.0.1]:57133 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQTEy-0001Nw-Pa for submit@debbugs.gnu.org; Tue, 24 Feb 2015 23:06:29 -0500 Received: from ironport2-out.teksavvy.com ([206.248.154.181]:53051) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQTEv-0001Nh-Uu for 19932@debbugs.gnu.org; Tue, 24 Feb 2015 23:06:27 -0500 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Ar8TAPOG1lRsoXmY/2dsb2JhbABbgwaDX4VTvhyCSQQCAoENRAEBAQEBAXyEDQEEAVYjBQsLDiYSFBgNJIg4CM4jAQEBAQEBBAEBAQEBHY94B4QqBYonn0uBRSKEDCCCcwEBAQ X-IPAS-Result: Ar8TAPOG1lRsoXmY/2dsb2JhbABbgwaDX4VTvhyCSQQCAoENRAEBAQEBAXyEDQEEAVYjBQsLDiYSFBgNJIg4CM4jAQEBAQEBBAEBAQEBHY94B4QqBYonn0uBRSKEDCCCcwEBAQ X-IronPort-AV: E=Sophos;i="5.09,536,1418101200"; d="scan'208";a="111406180" Received: from 108-161-121-152.dsl.teksavvy.com (HELO pastel.home) ([108.161.121.152]) by ironport2-out.teksavvy.com with ESMTP/TLS/DHE-RSA-AES256-SHA; 24 Feb 2015 23:06:20 -0500 Received: by pastel.home (Postfix, from userid 20848) id E5ED4280A; Tue, 24 Feb 2015 23:06:19 -0500 (EST) From: Stefan Monnier Message-ID: References: <54ECE6C3.3000602@yandex.ru> Date: Tue, 24 Feb 2015 23:06:19 -0500 In-Reply-To: <54ECE6C3.3000602@yandex.ru> (Dmitry Gutov's message of "Tue, 24 Feb 2015 23:01:55 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.3 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.3 (/) > Maybe it should just be undocumented. It's a private function, and it > duplicates the docstring of its only caller. Agreed, Stefan From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Nicolas Richard Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 25 Feb 2015 10:53:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Dmitry Gutov Cc: Drew Adams , 19932@debbugs.gnu.org Received: via spool by 19932-submit@debbugs.gnu.org id=B19932.142486152210527 (code B ref 19932); Wed, 25 Feb 2015 10:53:02 +0000 Received: (at 19932) by debbugs.gnu.org; 25 Feb 2015 10:52:02 +0000 Received: from localhost ([127.0.0.1]:57334 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQZZS-0002jY-9x for submit@debbugs.gnu.org; Wed, 25 Feb 2015 05:52:02 -0500 Received: from mxin.ulb.ac.be ([164.15.128.112]:43282) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQZZQ-0002jH-3O for 19932@debbugs.gnu.org; Wed, 25 Feb 2015 05:52:00 -0500 Received: from mathsrv4.ulb.ac.be (HELO localhost) ([164.15.133.241]) by smtp.ulb.ac.be with ESMTP; 25 Feb 2015 11:51:58 +0100 From: Nicolas Richard References: <54ECE6C3.3000602@yandex.ru> Date: Wed, 25 Feb 2015 11:52:38 +0100 In-Reply-To: <54ECE6C3.3000602@yandex.ru> (Dmitry Gutov's message of "Tue, 24 Feb 2015 23:01:55 +0200") Message-ID: <87egpee009.fsf@yahoo.fr> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) Dmitry Gutov writes: > On 02/23/2015 11:20 PM, Drew Adams wrote: >> .. should not mention the prefix arg. This is not a command, and the >> function code does not access `current-prefix-arg'. > > Maybe it should just be undocumented. It's a private function, and it > duplicates the docstring of its only caller. FWIW, I like when functions are documented, even private ones. -- Nicolas Richard From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 25 Feb 2015 11:18:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Nicolas Richard Cc: 19932@debbugs.gnu.org Received: via spool by 19932-submit@debbugs.gnu.org id=B19932.142486307512831 (code B ref 19932); Wed, 25 Feb 2015 11:18:01 +0000 Received: (at 19932) by debbugs.gnu.org; 25 Feb 2015 11:17:55 +0000 Received: from localhost ([127.0.0.1]:57345 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQZyV-0003Kt-1l for submit@debbugs.gnu.org; Wed, 25 Feb 2015 06:17:55 -0500 Received: from mail-wg0-f54.google.com ([74.125.82.54]:39470) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQZyS-0003Ke-45 for 19932@debbugs.gnu.org; Wed, 25 Feb 2015 06:17:52 -0500 Received: by wggx12 with SMTP id x12so2925079wgg.6 for <19932@debbugs.gnu.org>; Wed, 25 Feb 2015 03:17:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=XN3qI/kyWD8Y7mi8uVCm5rvDxsHeEIFo9mWpLkDIHEk=; b=rOzpsw2ZjcagO/z+tE8uQKzxpi/h9zvo/8CBWXr1WFR+AK+M3iNduRGzf9RjwXic87 N327cBcWiR92m6esx3FA+q/aAhO+DpChmlp9+dYNNIuyGFue9Ch0nleUCx/sZFsnu5SH 7TnNQzT28t+mDPveyltpZ0bOrvxObKTLQF5XknPqC9f3GFer6nGrE28aknNSNTMW9g7y kmGrwOqN+XoEScKmMW2nisLfWc2LrCMT08+mgUHyOxELZA1Y7BOf9VKcXNGGBhpHesxC qvDSR8oUWHuZDuYEOpsJj359wJhU5WS0WXNPyjvdTizF72KF2sdvQj4YnS8MMki+LFle YQYg== X-Received: by 10.194.121.136 with SMTP id lk8mr4922486wjb.49.1424863066442; Wed, 25 Feb 2015 03:17:46 -0800 (PST) Received: from [192.168.1.3] ([82.102.93.54]) by mx.google.com with ESMTPSA id q10sm64380341wjr.41.2015.02.25.03.17.45 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 25 Feb 2015 03:17:45 -0800 (PST) Message-ID: <54EDAF58.50904@yandex.ru> Date: Wed, 25 Feb 2015 13:17:44 +0200 From: Dmitry Gutov User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:36.0) Gecko/20100101 Thunderbird/36.0 MIME-Version: 1.0 References: <54ECE6C3.3000602@yandex.ru> <87egpee009.fsf@yahoo.fr> In-Reply-To: <87egpee009.fsf@yahoo.fr> Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) On 02/25/2015 12:52 PM, Nicolas Richard wrote: > FWIW, I like when functions are documented, even private ones. Would you like to enforce your preference and provide a patch that improves on the discussed drawbacks in that docstring? From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Nicolas Richard Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 25 Feb 2015 12:12:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Dmitry Gutov Cc: Nicolas Richard , 19932@debbugs.gnu.org Received: via spool by 19932-submit@debbugs.gnu.org id=B19932.142486628423594 (code B ref 19932); Wed, 25 Feb 2015 12:12:02 +0000 Received: (at 19932) by debbugs.gnu.org; 25 Feb 2015 12:11:24 +0000 Received: from localhost ([127.0.0.1]:57379 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQaoG-00068T-Dj for submit@debbugs.gnu.org; Wed, 25 Feb 2015 07:11:24 -0500 Received: from mxin.ulb.ac.be ([164.15.128.112]:47491) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQaoE-00068J-0L for 19932@debbugs.gnu.org; Wed, 25 Feb 2015 07:11:22 -0500 Received: from mathsrv4.ulb.ac.be (HELO localhost) ([164.15.133.241]) by smtp.ulb.ac.be with ESMTP; 25 Feb 2015 13:11:20 +0100 From: Nicolas Richard References: <54ECE6C3.3000602@yandex.ru> <87egpee009.fsf@yahoo.fr> <54EDAF58.50904@yandex.ru> Date: Wed, 25 Feb 2015 13:12:00 +0100 In-Reply-To: <54EDAF58.50904@yandex.ru> (Dmitry Gutov's message of "Wed, 25 Feb 2015 13:17:44 +0200") Message-ID: <87r3techrj.fsf@yahoo.fr> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) --=-=-= Content-Type: text/plain Dmitry Gutov writes: > On 02/25/2015 12:52 PM, Nicolas Richard wrote: > >> FWIW, I like when functions are documented, even private ones. > > Would you like to enforce your preference and provide a patch that > improves on the discussed drawbacks in that docstring? Would the following fit ? (I should be able to push it, if it turns out to be ok.) It's not as precise as what Drew suggested, but I didn't feel like being too verbose. --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=0001-lisp-progmodes-elisp-mode.el-elisp-eval-last-sexp-Do.patch >From 31d11bc29fd5157f2ff0f41e6d5d39b1115fcf8f Mon Sep 17 00:00:00 2001 From: Nicolas Richard Date: Wed, 25 Feb 2015 13:07:43 +0100 Subject: [PATCH] lisp/progmodes/elisp-mode.el (elisp--eval-last-sexp): Document argument. Fixes: 19932 --- lisp/ChangeLog | 4 ++++ lisp/progmodes/elisp-mode.el | 4 ++-- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/lisp/ChangeLog b/lisp/ChangeLog index e32dab0..f4f6097 100644 --- a/lisp/ChangeLog +++ b/lisp/ChangeLog @@ -1,3 +1,7 @@ +2015-02-25 Nicolas Richard + + * progmodes/elisp-mode.el (elisp--eval-last-sexp): Document argument. + 2014-12-23 Nicolas Richard * simple.el (count-words-region): Act on buffer if there is no region. diff --git a/lisp/progmodes/elisp-mode.el b/lisp/progmodes/elisp-mode.el index b2c5fbf..42e946c 100644 --- a/lisp/progmodes/elisp-mode.el +++ b/lisp/progmodes/elisp-mode.el @@ -883,8 +883,8 @@ (define-obsolete-function-alias 'preceding-sexp 'elisp--preceding-sexp "25.1") (defun elisp--eval-last-sexp (eval-last-sexp-arg-internal) "Evaluate sexp before point; print value in the echo area. -With argument, print output into current buffer. -With a zero prefix arg, print output with no limit on the length +If EVAL-LAST-SEXP-ARG-INTERNAL is non-nil, print output into current buffer. +If EVAL-LAST-SEXP-ARG-INTERNAL is `0', print output with no limit on the length and level of lists, and include additional formats for integers \(octal, hexadecimal, and character)." (let ((standard-output (if eval-last-sexp-arg-internal (current-buffer) t))) -- 2.1.4 --=-=-= Content-Type: text/plain -- Nicolas Richard --=-=-=-- From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 25 Feb 2015 12:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Nicolas Richard Cc: 19932@debbugs.gnu.org Received: via spool by 19932-submit@debbugs.gnu.org id=B19932.142486826932201 (code B ref 19932); Wed, 25 Feb 2015 12:45:02 +0000 Received: (at 19932) by debbugs.gnu.org; 25 Feb 2015 12:44:29 +0000 Received: from localhost ([127.0.0.1]:57383 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQbKH-0008NJ-F4 for submit@debbugs.gnu.org; Wed, 25 Feb 2015 07:44:29 -0500 Received: from mail-we0-f177.google.com ([74.125.82.177]:44977) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQbKF-0008N0-HQ for 19932@debbugs.gnu.org; Wed, 25 Feb 2015 07:44:28 -0500 Received: by wesk11 with SMTP id k11so3312507wes.11 for <19932@debbugs.gnu.org>; Wed, 25 Feb 2015 04:44:21 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=I+6Cor3OmRS4IyRSwAnSDL7Xv4kKyOP7MPdDab3O0Vc=; b=Iza9gJSadOyv1+RS5gTVMazWDH3heDsyfC3m3sXaf6gCVzUfY9kNyWT6IrLAxzsUcI DxALdpvAeRTVyEGb48OmI4WwswGtW4jJI28F3wGNKhXIBNQa5simC/1xDRCEDjpSo85h MonLJ8mKd9zloB/KqqkUZLfgG8kpPTqzc9Pt0cQTH4PMVTvFXULxzxucfIApxJ3HT6gL Vry9YxBXnhEDLWN/AgZWOthXmsAe38RGAPJSpRH6jWnohKfQ9ZrZa24Id64sFGG1Ou+y t+KaK7no/g/DoKxOyVqofYubr8ZjHu5AeDTh9dKx9PDswPNlNQeDG4gbSziChy2qW8BV 7Jeg== X-Received: by 10.180.86.227 with SMTP id s3mr39925619wiz.58.1424868261679; Wed, 25 Feb 2015 04:44:21 -0800 (PST) Received: from [192.168.1.3] ([82.102.93.54]) by mx.google.com with ESMTPSA id dn7sm13640032wid.12.2015.02.25.04.44.20 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 25 Feb 2015 04:44:21 -0800 (PST) Message-ID: <54EDC3A2.2050507@yandex.ru> Date: Wed, 25 Feb 2015 14:44:18 +0200 From: Dmitry Gutov User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:36.0) Gecko/20100101 Thunderbird/36.0 MIME-Version: 1.0 References: <54ECE6C3.3000602@yandex.ru> <87egpee009.fsf@yahoo.fr> <54EDAF58.50904@yandex.ru> <87r3techrj.fsf@yahoo.fr> In-Reply-To: <87r3techrj.fsf@yahoo.fr> Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) On 02/25/2015 02:12 PM, Nicolas Richard wrote: > Would the following fit ? (I should be able to push it, if it turns out > to be ok.) Looks fine to me. You might want to reflow it a bit, to adhere to emacs-lisp-docstring-fill-column. From unknown Fri Sep 19 20:44:07 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.503 (Entity 5.503) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Drew Adams Subject: bug#19932: closed (Re: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp') Message-ID: References: <54EDE7D0.70804@yahoo.fr> X-Gnu-PR-Message: they-closed 19932 X-Gnu-PR-Package: emacs Reply-To: 19932@debbugs.gnu.org Date: Wed, 25 Feb 2015 15:19:03 +0000 Content-Type: multipart/mixed; boundary="----------=_1424877543-14791-1" This is a multi-part message in MIME format... ------------=_1424877543-14791-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #19932: 25.0.50; doc string of `elisp--eval-last-sexp' which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 19932@debbugs.gnu.org. --=20 19932: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D19932 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1424877543-14791-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 19932-done) by debbugs.gnu.org; 25 Feb 2015 15:18:03 +0000 Received: from localhost ([127.0.0.1]:57887 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQdit-0003pF-2l for submit@debbugs.gnu.org; Wed, 25 Feb 2015 10:18:03 -0500 Received: from mxin.ulb.ac.be ([164.15.128.112]:6118) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQdiq-0003on-I2 for 19932-done@debbugs.gnu.org; Wed, 25 Feb 2015 10:18:01 -0500 Received: from mathsrv4.ulb.ac.be (HELO [172.19.79.241]) ([164.15.133.241]) by smtp.ulb.ac.be with ESMTP; 25 Feb 2015 16:18:00 +0100 Message-ID: <54EDE7D0.70804@yahoo.fr> Date: Wed, 25 Feb 2015 16:18:40 +0100 From: Nicolas Richard User-Agent: Mozilla/5.0 (X11; Linux i686; rv:31.0) Gecko/20100101 Thunderbird/31.2.0 MIME-Version: 1.0 To: Dmitry Gutov Subject: Re: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' References: <54ECE6C3.3000602@yandex.ru> <87egpee009.fsf@yahoo.fr> <54EDAF58.50904@yandex.ru> <87r3techrj.fsf@yahoo.fr> <54EDC3A2.2050507@yandex.ru> In-Reply-To: <54EDC3A2.2050507@yandex.ru> X-TagToolbar-Keys: D20150225161840079 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 19932-done Cc: 19932-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) Le 25/02/2015 13:44, Dmitry Gutov a écrit : > On 02/25/2015 02:12 PM, Nicolas Richard wrote: > >> Would the following fit ? (I should be able to push it, if it turns out >> to be ok.) > > Looks fine to me. You might want to reflow it a bit, to adhere to emacs-lisp-docstring-fill-column. Ok, done. Nico. ------------=_1424877543-14791-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 23 Feb 2015 21:20:37 +0000 Received: from localhost ([127.0.0.1]:55872 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQ0Qe-0008Bq-C2 for submit@debbugs.gnu.org; Mon, 23 Feb 2015 16:20:36 -0500 Received: from eggs.gnu.org ([208.118.235.92]:48984) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQ0Qb-0008Bb-TC for submit@debbugs.gnu.org; Mon, 23 Feb 2015 16:20:35 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YQ0QQ-0007qw-Ld for submit@debbugs.gnu.org; Mon, 23 Feb 2015 16:20:28 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:56390) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQ0QQ-0007qs-IK for submit@debbugs.gnu.org; Mon, 23 Feb 2015 16:20:22 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:50691) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQ0QP-0006vq-Ko for bug-gnu-emacs@gnu.org; Mon, 23 Feb 2015 16:20:22 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YQ0QJ-0007nP-7p for bug-gnu-emacs@gnu.org; Mon, 23 Feb 2015 16:20:21 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:30600) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YQ0QJ-0007fW-0o for bug-gnu-emacs@gnu.org; Mon, 23 Feb 2015 16:20:15 -0500 Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t1NLK6Q9020220 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 23 Feb 2015 21:20:08 GMT Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t1NLK5kK010773 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Mon, 23 Feb 2015 21:20:06 GMT Received: from abhmp0013.oracle.com (abhmp0013.oracle.com [141.146.116.19]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t1NLK5np018982 for ; Mon, 23 Feb 2015 21:20:05 GMT MIME-Version: 1.0 Message-ID: Date: Mon, 23 Feb 2015 13:20:04 -0800 (PST) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 25.0.50; doc string of `elisp--eval-last-sexp' X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0022.oracle.com [141.146.126.234] 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: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) .. should not mention the prefix arg. This is not a command, and the function code does not access `current-prefix-arg'. The doc string should say that if `prefix-numeric-value' applied to the argument to the function is 0 then... In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2014-10-20 on LEG570 Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking=3Dyes,glyphs CPPFLAGS=3D-DGLYPH_DEBUG=3D1' ------------=_1424877543-14791-1-- From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 25 Feb 2015 16:37:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Nicolas Richard , Dmitry Gutov Cc: 19932@debbugs.gnu.org Received: via spool by 19932-submit@debbugs.gnu.org id=B19932.142488218422526 (code B ref 19932); Wed, 25 Feb 2015 16:37:01 +0000 Received: (at 19932) by debbugs.gnu.org; 25 Feb 2015 16:36:24 +0000 Received: from localhost ([127.0.0.1]:57949 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQewi-0005rF-4x for submit@debbugs.gnu.org; Wed, 25 Feb 2015 11:36:24 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:27050) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQewf-0005r1-MZ for 19932@debbugs.gnu.org; Wed, 25 Feb 2015 11:36:22 -0500 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t1PGaFTa023194 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 25 Feb 2015 16:36:15 GMT Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t1PGaExp023167 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Wed, 25 Feb 2015 16:36:14 GMT Received: from abhmp0002.oracle.com (abhmp0002.oracle.com [141.146.116.8]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t1PGaDEl020541; Wed, 25 Feb 2015 16:36:13 GMT MIME-Version: 1.0 Message-ID: <582e7a02-3c80-4f17-a170-60238cc18c7f@default> Date: Wed, 25 Feb 2015 08:36:13 -0800 (PST) From: Drew Adams References: <54ECE6C3.3000602@yandex.ru> <87egpee009.fsf@yahoo.fr> In-Reply-To: <87egpee009.fsf@yahoo.fr> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > >> .. should not mention the prefix arg. This is not a command, and the > >> function code does not access `current-prefix-arg'. > > > > Maybe it should just be undocumented. It's a private function, and it > > duplicates the docstring of its only caller. >=20 > FWIW, I like when functions are documented, even private ones. Of course. And "private" means nothing in the context of Emacs Lisp. But perhaps some have dreams of turning it into C++. ;-) From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 25 Feb 2015 16:40:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams , Nicolas Richard Cc: 19932@debbugs.gnu.org Received: via spool by 19932-submit@debbugs.gnu.org id=B19932.142488240022876 (code B ref 19932); Wed, 25 Feb 2015 16:40:02 +0000 Received: (at 19932) by debbugs.gnu.org; 25 Feb 2015 16:40:00 +0000 Received: from localhost ([127.0.0.1]:57953 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQf0B-0005wu-Oq for submit@debbugs.gnu.org; Wed, 25 Feb 2015 11:39:59 -0500 Received: from mail-wg0-f53.google.com ([74.125.82.53]:33828) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQf0A-0005wf-4X for 19932@debbugs.gnu.org; Wed, 25 Feb 2015 11:39:58 -0500 Received: by wghn12 with SMTP id n12so4850193wgh.1 for <19932@debbugs.gnu.org>; Wed, 25 Feb 2015 08:39:52 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=z2jfz7m8A+Q+0ywQdHtXRkJVJextsMsIT//stsY5/R4=; b=TcrJVQYiZOxuJKYFJzlWwq5l6w3cdEPpVdkaASeyhKTfssM2pwRZCv5delnmg/DvWe WvDy1dWM+khlBPk0wiQCB8uNnHJtvysF18nEq/z0CpcneB8sLSqln3sPBb04BtIZryIm nx8eX1QdyFeMQYGwcbD98/DEHfVzUmItyD0YzVNljtsSHvJRC/X/L30fBf0sTiw3eAmd /6GmAhwHVuFQycg4+kEaw+DGJG2hf3pvBcwZUGHtiB5nxCxtHeMDwB0iPT15vq+dtap5 s+HzE1JpOHi/74UAX/K43gqpFu+akFo+n1x/iaEH5IaeigoU2X68D/9Y+0P3iOxjgIOC XsBg== X-Received: by 10.194.83.66 with SMTP id o2mr7903698wjy.55.1424882392554; Wed, 25 Feb 2015 08:39:52 -0800 (PST) Received: from [192.168.0.185] (static-nbl2-118.cytanet.com.cy. [212.31.107.118]) by mx.google.com with ESMTPSA id r3sm61261337wjw.7.2015.02.25.08.39.51 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 25 Feb 2015 08:39:51 -0800 (PST) Message-ID: <54EDFAD6.2060905@yandex.ru> Date: Wed, 25 Feb 2015 18:39:50 +0200 From: Dmitry Gutov User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:36.0) Gecko/20100101 Thunderbird/36.0 MIME-Version: 1.0 References: <54ECE6C3.3000602@yandex.ru> <87egpee009.fsf@yahoo.fr> <582e7a02-3c80-4f17-a170-60238cc18c7f@default> In-Reply-To: <582e7a02-3c80-4f17-a170-60238cc18c7f@default> Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) On 02/25/2015 06:36 PM, Drew Adams wrote: > And "private" means nothing in the context of Emacs Lisp. It means plenty, even if you choose to ignore it. For instance, third-party code mustn't call private functions, thus it's considerably less important to document them. From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 25 Feb 2015 16:41:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Nicolas Richard , Dmitry Gutov Cc: 19932@debbugs.gnu.org Received: via spool by 19932-submit@debbugs.gnu.org id=B19932.142488240722926 (code B ref 19932); Wed, 25 Feb 2015 16:41:01 +0000 Received: (at 19932) by debbugs.gnu.org; 25 Feb 2015 16:40:07 +0000 Received: from localhost ([127.0.0.1]:57957 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQf0J-0005xi-2V for submit@debbugs.gnu.org; Wed, 25 Feb 2015 11:40:07 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:29865) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQf0G-0005wr-7c for 19932@debbugs.gnu.org; Wed, 25 Feb 2015 11:40:04 -0500 Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t1PGdvG8028456 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 25 Feb 2015 16:39:58 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t1PGdufE029788 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 25 Feb 2015 16:39:57 GMT Received: from abhmp0002.oracle.com (abhmp0002.oracle.com [141.146.116.8]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t1PGduic006833; Wed, 25 Feb 2015 16:39:56 GMT MIME-Version: 1.0 Message-ID: Date: Wed, 25 Feb 2015 08:39:50 -0800 (PST) From: Drew Adams References: <54ECE6C3.3000602@yandex.ru> <87egpee009.fsf@yahoo.fr> <54EDAF58.50904@yandex.ru> <87r3techrj.fsf@yahoo.fr> In-Reply-To: <87r3techrj.fsf@yahoo.fr> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > >> FWIW, I like when functions are documented, even private ones. > > > > Would you like to enforce your preference and provide a patch that > > improves on the discussed drawbacks in that docstring? >=20 > Would the following fit ? (I should be able to push it, if it turns out > to be ok.) >=20 > It's not as precise as what Drew suggested, but I didn't feel like being > too verbose. Looks good. Thanks. From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 25 Feb 2015 16:46:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Dmitry Gutov , Nicolas Richard Cc: 19932@debbugs.gnu.org Received: via spool by 19932-submit@debbugs.gnu.org id=B19932.142488271523537 (code B ref 19932); Wed, 25 Feb 2015 16:46:02 +0000 Received: (at 19932) by debbugs.gnu.org; 25 Feb 2015 16:45:15 +0000 Received: from localhost ([127.0.0.1]:57982 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQf5G-00067Y-IP for submit@debbugs.gnu.org; Wed, 25 Feb 2015 11:45:14 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:17767) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQf5E-00067I-UH for 19932@debbugs.gnu.org; Wed, 25 Feb 2015 11:45:13 -0500 Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t1PGj6nK022278 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 25 Feb 2015 16:45:07 GMT Received: from userz7022.oracle.com (userz7022.oracle.com [156.151.31.86]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t1PGj5ZV019494 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 25 Feb 2015 16:45:06 GMT Received: from abhmp0002.oracle.com (abhmp0002.oracle.com [141.146.116.8]) by userz7022.oracle.com (8.14.5+Sun/8.14.4) with ESMTP id t1PGj4oV007133; Wed, 25 Feb 2015 16:45:05 GMT MIME-Version: 1.0 Message-ID: Date: Wed, 25 Feb 2015 08:45:04 -0800 (PST) From: Drew Adams References: <54ECE6C3.3000602@yandex.ru> <87egpee009.fsf@yahoo.fr> <582e7a02-3c80-4f17-a170-60238cc18c7f@default> <54EDFAD6.2060905@yandex.ru> In-Reply-To: <54EDFAD6.2060905@yandex.ru> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > > And "private" means nothing in the context of Emacs Lisp. >=20 > It means plenty, even if you choose to ignore it. For instance, > third-party code mustn't call private functions, thus it's considerably > less important to document them. There is nothing in Emacs Lisp that 3rd-party code "mustn't call". There may be things that code should not call, without inflicting pain somewhere. But that is exactly true and just much true of "core" (aka delivered-with-Emacs) Lisp code as it is true of 3rd-party Lisp code. From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Nicolas Richard Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 25 Feb 2015 16:49:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 19932@debbugs.gnu.org Received: via spool by 19932-submit@debbugs.gnu.org id=B19932.142488291724019 (code B ref 19932); Wed, 25 Feb 2015 16:49:02 +0000 Received: (at 19932) by debbugs.gnu.org; 25 Feb 2015 16:48:37 +0000 Received: from localhost ([127.0.0.1]:57998 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQf8X-0006FK-FL for submit@debbugs.gnu.org; Wed, 25 Feb 2015 11:48:37 -0500 Received: from mxin.ulb.ac.be ([164.15.128.112]:44359) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQf8V-0006F5-VV for 19932@debbugs.gnu.org; Wed, 25 Feb 2015 11:48:36 -0500 Received: from mathsrv4.ulb.ac.be (HELO [172.19.79.241]) ([164.15.133.241]) by smtp.ulb.ac.be with ESMTP; 25 Feb 2015 17:48:34 +0100 Message-ID: <54EDFD09.50200@yahoo.fr> Date: Wed, 25 Feb 2015 17:49:13 +0100 From: Nicolas Richard User-Agent: Mozilla/5.0 (X11; Linux i686; rv:31.0) Gecko/20100101 Thunderbird/31.2.0 MIME-Version: 1.0 References: <54ECE6C3.3000602@yandex.ru> <87egpee009.fsf@yahoo.fr> <582e7a02-3c80-4f17-a170-60238cc18c7f@default> In-Reply-To: <582e7a02-3c80-4f17-a170-60238cc18c7f@default> X-TagToolbar-Keys: D20150225174913383 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) Le 25/02/2015 17:36, Drew Adams a écrit : > Of course. And "private" means nothing in the context of Emacs Lisp. It means whatever we want it to mean when we use the word. I think we all (more or less) understand what it means in the current context, don't we ? Nico. From unknown Fri Sep 19 20:44:07 2025 X-Loop: help-debbugs@gnu.org Subject: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 25 Feb 2015 17:06:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19932 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Nicolas Richard Cc: 19932@debbugs.gnu.org Received: via spool by 19932-submit@debbugs.gnu.org id=B19932.142488392626205 (code B ref 19932); Wed, 25 Feb 2015 17:06:02 +0000 Received: (at 19932) by debbugs.gnu.org; 25 Feb 2015 17:05:26 +0000 Received: from localhost ([127.0.0.1]:58004 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQfOn-0006ob-VV for submit@debbugs.gnu.org; Wed, 25 Feb 2015 12:05:26 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:32611) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YQfOl-0006oK-PC for 19932@debbugs.gnu.org; Wed, 25 Feb 2015 12:05:24 -0500 Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t1PH5HTL019835 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 25 Feb 2015 17:05:18 GMT Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t1PH5GF6006323 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Wed, 25 Feb 2015 17:05:16 GMT Received: from abhmp0002.oracle.com (abhmp0002.oracle.com [141.146.116.8]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t1PH5FL5020819; Wed, 25 Feb 2015 17:05:15 GMT MIME-Version: 1.0 Message-ID: <19414826-ceac-4808-b1a6-892e0f56020a@default> Date: Wed, 25 Feb 2015 09:05:14 -0800 (PST) From: Drew Adams References: <54ECE6C3.3000602@yandex.ru> <87egpee009.fsf@yahoo.fr> <582e7a02-3c80-4f17-a170-60238cc18c7f@default> <54EDFD09.50200@yahoo.fr> In-Reply-To: <54EDFD09.50200@yahoo.fr> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) > > Of course. And "private" means nothing in the context of Emacs Lisp. >=20 > It means whatever we want it to mean when we use the word. I think we > all (more or less) understand what it means in the current context, > don't we ? Nope. You won't find it anywhere in the Emacs or Elisp doc, I'll bet. Or even in the source code (unless perhaps in some C code somewhere, as a comment). Use of the term here, by Dmitry, is new in the context of Emacs, AFAIK. I'll bet that even if you search bug reports and emacs-devel threads you won't find that term used. (And "internal" (also nebulous/dubious in the context of Emacs) is not the same as "private".) "Private", for software, is typically about encapsulation/visibility and modules. You could make a case that a notion of such privacy (importing, exporting etc.) exists in Common Lisp, wrt its packages. But no such module system exists for Elisp. If/when we add a module system to Elisp, then we can perhaps speak of things being "private". And even then the notion would no doubt be relative, as it is in, say, Common Lisp.