From debbugs-submit-bounces@debbugs.gnu.org Mon Feb 23 16:20:37 2015 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' From debbugs-submit-bounces@debbugs.gnu.org Tue Feb 24 16:02:05 2015 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 To: Drew Adams , 19932@debbugs.gnu.org Subject: Re: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' References: In-Reply-To: Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 19932 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 debbugs-submit-bounces@debbugs.gnu.org Tue Feb 24 16:26:35 2015 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 To: Dmitry Gutov , 19932@debbugs.gnu.org Subject: RE: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' 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-Debbugs-Envelope-To: 19932 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 debbugs-submit-bounces@debbugs.gnu.org Tue Feb 24 23:06:29 2015 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 To: Dmitry Gutov Subject: Re: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' 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-Debbugs-Envelope-To: 19932 Cc: Drew Adams , 19932@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: 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 debbugs-submit-bounces@debbugs.gnu.org Wed Feb 25 05:52:02 2015 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 To: Dmitry Gutov Subject: Re: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' 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-Debbugs-Envelope-To: 19932 Cc: Drew Adams , 19932@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 (--) 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 debbugs-submit-bounces@debbugs.gnu.org Wed Feb 25 06:17:55 2015 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 To: Nicolas Richard Subject: Re: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' 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-Debbugs-Envelope-To: 19932 Cc: 19932@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: -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 debbugs-submit-bounces@debbugs.gnu.org Wed Feb 25 07:11:24 2015 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 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> 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-Debbugs-Envelope-To: 19932 Cc: Nicolas Richard , 19932@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 (--) --=-=-= 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 debbugs-submit-bounces@debbugs.gnu.org Wed Feb 25 07:44:29 2015 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 To: Nicolas Richard 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> 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-Debbugs-Envelope-To: 19932 Cc: 19932@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: -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 debbugs-submit-bounces@debbugs.gnu.org Wed Feb 25 10:18:03 2015 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. From debbugs-submit-bounces@debbugs.gnu.org Wed Feb 25 11:36:24 2015 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 To: Nicolas Richard , 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> 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-Debbugs-Envelope-To: 19932 Cc: 19932@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 (--) > >> .. 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 debbugs-submit-bounces@debbugs.gnu.org Wed Feb 25 11:40:00 2015 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 To: Drew Adams , Nicolas Richard Subject: Re: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' 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-Debbugs-Envelope-To: 19932 Cc: 19932@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: -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 debbugs-submit-bounces@debbugs.gnu.org Wed Feb 25 11:40:07 2015 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 To: Nicolas Richard , 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> 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-Debbugs-Envelope-To: 19932 Cc: 19932@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 (--) > >> 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 debbugs-submit-bounces@debbugs.gnu.org Wed Feb 25 11:45:15 2015 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 To: Dmitry Gutov , Nicolas Richard Subject: RE: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' 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-Debbugs-Envelope-To: 19932 Cc: 19932@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 (--) > > 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 debbugs-submit-bounces@debbugs.gnu.org Wed Feb 25 11:48:37 2015 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 To: Drew Adams Subject: Re: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' 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-Debbugs-Envelope-To: 19932 Cc: 19932@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 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 debbugs-submit-bounces@debbugs.gnu.org Wed Feb 25 12:05:26 2015 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 To: Nicolas Richard Subject: RE: bug#19932: 25.0.50; doc string of `elisp--eval-last-sexp' 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-Debbugs-Envelope-To: 19932 Cc: 19932@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 (--) > > 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. From unknown Fri Sep 19 20:44:15 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 26 Mar 2015 11:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator