From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#25461: Missing doc strings for "," and ",@". Date: Wed, 18 Jan 2017 02:44:28 +0100 Message-ID: <87h94xdtvn.fsf@web.de> References: <20170116212257.GA4747@acm.fritz.box> <3w1sw11nwn.fsf@fencepost.gnu.org> <20170117195627.GA4169@acm.fritz.box> <87k29t5sqp.fsf@linux-m68k.org> <20170117204119.GC4169@acm.fritz.box> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1484703932 1428 195.159.176.226 (18 Jan 2017 01:45:32 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 18 Jan 2017 01:45:32 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.91 (gnu/linux) Cc: Andreas Schwab , 25461@debbugs.gnu.org To: Alan Mackenzie Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jan 18 02:45:26 2017 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 1cTfJE-0006jZ-5C for geb-bug-gnu-emacs@m.gmane.org; Wed, 18 Jan 2017 02:45:08 +0100 Original-Received: from localhost ([::1]:38695 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cTfJI-0002dG-UJ for geb-bug-gnu-emacs@m.gmane.org; Tue, 17 Jan 2017 20:45:12 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36137) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cTfJC-0002bZ-5j for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2017 20:45:07 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cTfJ9-0002yu-1e for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2017 20:45:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:35984) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cTfJ8-0002yX-UD for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2017 20:45:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1cTfJ8-0008BV-IF for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2017 20:45:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 18 Jan 2017 01:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25461 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 25461-submit@debbugs.gnu.org id=B25461.148470388131416 (code B ref 25461); Wed, 18 Jan 2017 01:45:02 +0000 Original-Received: (at 25461) by debbugs.gnu.org; 18 Jan 2017 01:44:41 +0000 Original-Received: from localhost ([127.0.0.1]:34183 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTfIn-0008Ae-2H for submit@debbugs.gnu.org; Tue, 17 Jan 2017 20:44:41 -0500 Original-Received: from mout.web.de ([212.227.17.12]:51991) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTfIk-0008AP-2U for 25461@debbugs.gnu.org; Tue, 17 Jan 2017 20:44:39 -0500 Original-Received: from drachen.dragon ([92.74.161.233]) by smtp.web.de (mrweb101 [213.165.67.124]) with ESMTPSA (Nemesis) id 0MF3nL-1cE2MQ0txL-00GInT; Wed, 18 Jan 2017 02:44:29 +0100 In-Reply-To: <20170117204119.GC4169@acm.fritz.box> (Alan Mackenzie's message of "Tue, 17 Jan 2017 20:41:19 +0000") X-Provags-ID: V03:K0:W8GCKurzd1grPw04LcoafxlOdSxxGC5itm5L6fDpVz4ZGJxAvXv ihGqcs2RnAxz7lekgDTM5oEWvHsFMbDS8zE0JDd+DUyOWYT4t6NigV3PsNhyRRhpRf5gMyF zzQki2IhAkEIBRrF5d2CnIWOD3ZRwfcrGhicY0P6pYhsQMFRX+ek3YxQ3YwZN2BxPBRhIa4 DzK82bpeG2h31/tHC1C8g== X-UI-Out-Filterresults: notjunk:1;V01:K0:XwzW8dHcRx4=:kO5cp31eCkjk3x2eI4mjYz sexgoA8eDP+6QBdVbp5JaasUhGbJ//btgz2+swvdPeWkI90tK1eBfG16LSDqIMMXhTVw8cKA3 8L4fVSLal7a5w71tZMKHd6054z6Ypdcr1jRmmAb+aS25FItNOjjZ35T/QX3kF0F0EcEs9UA1Z rGisRGb2fS+fpZvpAMETalZGIF4kvvzWqkuQffyiQGR9VUqFzc5LbLTMb5DnPwgUIWbt5H2nB l0TRVPNrjsKT+931jI+4VcjNign/Tk/I8KYabXnka2hwVeE51ZfK4Wq5ynYToHwd8r6yozvSR wENE9JfgAgSqIBgCSvxWcTJoZoUUd85C+AkQamUWzu13Ax3j7JOTJPON4Bd/ZUDU1dFkiHUdU v16IOrPL1Xh8mRWmKeyp9Suo2orwlVWO1tROUfI3z3jX49vvgSjlCXhpo7sy2xnLXp5fEbIae ziLHs689RA6fk6kGA7zkAbfYXqSkk7KBk8p3hRoivnmXRHZe7chK96tkRUkhX8YxGxgIguYQC Mf9cTMmBBEYiCiIU1IZrTqFsh9GTh42SZh7DHDCz1iOOEuKkJSSSFFti567vtmo65vY6kN5XG w4TJ/OyZlUQm5eZHgb4KWMS25FPkQhJAJdRdox4EddDo1D4YzZzyMLT7VZLpXExW56GMMlCn4 NiPjt5XnXuQKfp18ozxV74nQ1/p7YwfuiVovDxEIgIRttift3LNaL1Skm4tc+Ffdnx0DG50Wm oX0/NprO0m1lPH/+8lTHHQ6c0zTZzt+iLgrVpP7tYzDakqmFfof5Fh7IKozFDTxZZ0C2jCLz 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:128190 Archived-At: Alan Mackenzie writes: > I don't expect the typical novice Elisp hacker cares about such nice > distinctions. She can get a doc string for `, so why not one for , or > ,@? ' and #' also "don't have a docstring". That ` "has a docstring" is just coincidence - because the reader transforms `expr to (` expr) and the symbol ` has an associated symbol-function. FWIW when I first saw `, , and ,@, it looked strange enough to me to open the manual, because the syntax seemed so unusual that I believed that I missed an essential part of knowledge about Elisp. At least this is what I think happened... But I agree that some people might try C-h f on any of these, and we would not all die if we would show something useful in this case. We could just say that C-f explains symbol functions and "reader macros" and the thing would still be consistent. OTOH, I think that saying anything about `pcase' there would be a bad idea. Michael.