From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Andreas Schwab Newsgroups: gmane.emacs.bugs Subject: bug#25461: Missing doc strings for "," and ",@". Date: Tue, 17 Jan 2017 21:53:34 +0100 Message-ID: <87fukh5rxt.fsf@linux-m68k.org> 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 1484686482 15782 195.159.176.226 (17 Jan 2017 20:54:42 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 17 Jan 2017 20:54:42 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.91 (gnu/linux) Cc: 25461@debbugs.gnu.org To: Alan Mackenzie Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Jan 17 21:54:36 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 1cTale-0001Th-Pw for geb-bug-gnu-emacs@m.gmane.org; Tue, 17 Jan 2017 21:54:10 +0100 Original-Received: from localhost ([::1]:37643 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cTalj-000852-95 for geb-bug-gnu-emacs@m.gmane.org; Tue, 17 Jan 2017 15:54:15 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52827) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cTalZ-000846-Pl for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2017 15:54:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cTalW-00052u-J1 for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2017 15:54:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:35902) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cTalW-00052p-FJ for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2017 15:54:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1cTalW-0001LT-9O for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2017 15:54:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Andreas Schwab Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 17 Jan 2017 20:54: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.14846864195138 (code B ref 25461); Tue, 17 Jan 2017 20:54:02 +0000 Original-Received: (at 25461) by debbugs.gnu.org; 17 Jan 2017 20:53:39 +0000 Original-Received: from localhost ([127.0.0.1]:34101 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTal9-0001Ko-Jx for submit@debbugs.gnu.org; Tue, 17 Jan 2017 15:53:39 -0500 Original-Received: from mail-out.m-online.net ([212.18.0.10]:51625) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cTal7-0001Kg-JT for 25461@debbugs.gnu.org; Tue, 17 Jan 2017 15:53:37 -0500 Original-Received: from frontend01.mail.m-online.net (unknown [192.168.8.182]) by mail-out.m-online.net (Postfix) with ESMTP id 3v32Pr5tRKz3hpGq; Tue, 17 Jan 2017 21:53:36 +0100 (CET) Original-Received: from localhost (dynscan1.mnet-online.de [192.168.6.68]) by mail.m-online.net (Postfix) with ESMTP id 3v32Pr49zNzvkcP; Tue, 17 Jan 2017 21:53:36 +0100 (CET) X-Virus-Scanned: amavisd-new at mnet-online.de Original-Received: from mail.mnet-online.de ([192.168.8.182]) by localhost (dynscan1.mail.m-online.net [192.168.6.68]) (amavisd-new, port 10024) with ESMTP id RvdXb7JjpLnX; Tue, 17 Jan 2017 21:53:34 +0100 (CET) X-Auth-Info: aLGsKYMoa17/BQ1EFPyp0i33gWzp0/JZ7jPmsQmgtOGBpaKt+tV5BGPMvgwpVBWk Original-Received: from igel.home (ppp-88-217-6-86.dynamic.mnet-online.de [88.217.6.86]) (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits)) (No client certificate requested) by mail.mnet-online.de (Postfix) with ESMTPSA; Tue, 17 Jan 2017 21:53:34 +0100 (CET) Original-Received: by igel.home (Postfix, from userid 1000) id 29A452C4282; Tue, 17 Jan 2017 21:53:34 +0100 (CET) X-Yow: Hello... IRON CURTAIN? Send over a SAUSAGE PIZZA! World War III? No thanks! In-Reply-To: <20170117204119.GC4169@acm.fritz.box> (Alan Mackenzie's message of "Tue, 17 Jan 2017 20:41:19 +0000") 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:128182 Archived-At: On Jan 17 2017, Alan Mackenzie wrote: > I don't expect the typical novice Elisp hacker cares about such nice > distinctions. A doc string is not for introduction of basics, a novice is expected to read the manual for that. > She can get a doc string for `, so why not one for , or ,@? The paren doesn't have a doc string either. Andreas. -- Andreas Schwab, schwab@linux-m68k.org GPG Key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5 "And now for something completely different."