From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#32064: 26; doc string of `eval-last-sexp' Date: Fri, 06 Jul 2018 12:39:18 +0300 Message-ID: <83va9sln3t.fsf@gnu.org> References: <0d7bb132-057e-431e-a5fa-86e15b99879a@default> <87bmbldxg3.fsf@gmail.com> NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1530869891 30555 195.159.176.226 (6 Jul 2018 09:38:11 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 6 Jul 2018 09:38:11 +0000 (UTC) Cc: 32064@debbugs.gnu.org To: Noam Postavsky Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jul 06 11:38:07 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 1fbNBl-0007ov-4G for geb-bug-gnu-emacs@m.gmane.org; Fri, 06 Jul 2018 11:38:05 +0200 Original-Received: from localhost ([::1]:56671 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fbNDs-0003l1-6R for geb-bug-gnu-emacs@m.gmane.org; Fri, 06 Jul 2018 05:40:16 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:43315) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fbNDi-0003j5-Tc for bug-gnu-emacs@gnu.org; Fri, 06 Jul 2018 05:40:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fbNDe-00024S-D0 for bug-gnu-emacs@gnu.org; Fri, 06 Jul 2018 05:40:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:40341) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fbNDe-00022m-8w for bug-gnu-emacs@gnu.org; Fri, 06 Jul 2018 05:40:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fbNDd-0000BW-VB for bug-gnu-emacs@gnu.org; Fri, 06 Jul 2018 05:40:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 06 Jul 2018 09:40:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 32064 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 32064-submit@debbugs.gnu.org id=B32064.1530869967662 (code B ref 32064); Fri, 06 Jul 2018 09:40:01 +0000 Original-Received: (at 32064) by debbugs.gnu.org; 6 Jul 2018 09:39:27 +0000 Original-Received: from localhost ([127.0.0.1]:48237 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fbND5-0000Ab-2n for submit@debbugs.gnu.org; Fri, 06 Jul 2018 05:39:27 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:52187) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fbND3-0000AP-ET for 32064@debbugs.gnu.org; Fri, 06 Jul 2018 05:39:25 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fbNCv-0007HM-4Q for 32064@debbugs.gnu.org; Fri, 06 Jul 2018 05:39:20 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:47359) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fbNCv-0007Gc-0T; Fri, 06 Jul 2018 05:39:17 -0400 Original-Received: from [176.228.60.248] (port=4986 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1fbNCu-0004AH-Dr; Fri, 06 Jul 2018 05:39:16 -0400 In-reply-to: <87bmbldxg3.fsf@gmail.com> (message from Noam Postavsky on Thu, 05 Jul 2018 20:23:08 -0400) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:148247 Archived-At: > From: Noam Postavsky > Date: Thu, 05 Jul 2018 20:23:08 -0400 > Cc: 32064@debbugs.gnu.org > > Drew Adams writes: > > > This is all a confusing mess, I'm afraid. And the code (e.g. of > > `eval-last-sexp' and its helper `elisp--eval-last-sexp') is not very > > clear either. > > I agree. I think the solution is to simplify the interface somewhat. These additional features weer added just recently, so I see no reason why we should remove them now. Certainly not because the doc string needs to be fixed. > As it stands, we're trying to cram a lot of functionality into the > prefix argument, and the encoding is too difficult to remember (both in > terms of implementing & documenting, as well as for using). I had no difficulty bringing the doc string in line with the implementation, please take a look.