From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: npostavs@users.sourceforge.net Newsgroups: gmane.emacs.bugs Subject: bug#25461: [Patch #2]: Missing doc strings for "," and ",@". Date: Mon, 23 Jan 2017 23:01:36 -0500 Message-ID: <871svtumvz.fsf@users.sourceforge.net> References: <20170116212257.GA4747@acm.fritz.box> <20170118194320.GB4108@acm.fritz.box> <87lgu7dbyz.fsf@web.de> <20170119175801.GB3397@acm.fritz.box> <877f5qbndp.fsf@web.de> <20170120165856.GA3384@acm.fritz.box> <87y3y5cfnl.fsf@web.de> <20170121155651.GB5394@acm> <20170121204648.GA21091@acm> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1485230496 27746 195.159.176.226 (24 Jan 2017 04:01:36 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 24 Jan 2017 04:01:36 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1 (gnu/linux) Cc: Michael Heerdegen , 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 24 05:01:31 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 1cVsI8-0004ZY-LY for geb-bug-gnu-emacs@m.gmane.org; Tue, 24 Jan 2017 05:01:08 +0100 Original-Received: from localhost ([::1]:45915 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cVsIA-0002DF-Iu for geb-bug-gnu-emacs@m.gmane.org; Mon, 23 Jan 2017 23:01:10 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35133) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cVsI5-0002Co-6c for bug-gnu-emacs@gnu.org; Mon, 23 Jan 2017 23:01:05 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cVsI2-0001Jq-6C for bug-gnu-emacs@gnu.org; Mon, 23 Jan 2017 23:01:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:41423) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cVsI2-0001Jk-2e for bug-gnu-emacs@gnu.org; Mon, 23 Jan 2017 23:01:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1cVsI1-0000AW-Ng for bug-gnu-emacs@gnu.org; Mon, 23 Jan 2017 23:01:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: npostavs@users.sourceforge.net Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 24 Jan 2017 04:01:01 +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.1485230438612 (code B ref 25461); Tue, 24 Jan 2017 04:01:01 +0000 Original-Received: (at 25461) by debbugs.gnu.org; 24 Jan 2017 04:00:38 +0000 Original-Received: from localhost ([127.0.0.1]:39622 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cVsHd-00009o-Pa for submit@debbugs.gnu.org; Mon, 23 Jan 2017 23:00:37 -0500 Original-Received: from mail-it0-f51.google.com ([209.85.214.51]:38477) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cVsHb-00009a-2x for 25461@debbugs.gnu.org; Mon, 23 Jan 2017 23:00:36 -0500 Original-Received: by mail-it0-f51.google.com with SMTP id c7so81546210itd.1 for <25461@debbugs.gnu.org>; Mon, 23 Jan 2017 20:00:34 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=t4E5EK/KRI4s2xryLfw0uFvLPQRoLwgoOoeHmioEY7g=; b=VKe+zV7nndNtCuxrOld0HwBLFck3Gw03tUQaY2iGj5J1FGYRssFzmoyX/kX1RzUn/8 Tfo8SjA/3E8wepV586NMPR2HSuMpV57X/TifW7EexeCftPXCJ0Gdmvfz7sok4gS5JXpq q41rIjqggd3XmzdfD9aFj2tfTppZK39q3coooxI3Fd5f8WJclrxr8mE3BqzGPZg7ULbk 1nEmvhDBMMayJnxaEQ3lwDK6SQZEmj0r3OBV/M2z0DANDYDJbA0VRLq6jgSIAZ+GCBe5 2JcpiuyyKkeZn4ADGMTkYybLb/nmLv5TGt8OiAiHPaMJ4Q+t4UyQlXjZ4nHXn09+Z5sD Gnzg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=t4E5EK/KRI4s2xryLfw0uFvLPQRoLwgoOoeHmioEY7g=; b=toYqBZNSG2yg6M49CMPCpbBXz9Uk+lQ0NphI02x3AK06miqSf25kHkSMC2E9hEbH45 qPgqgX8u+hPO3zE5zq2uVNYObmWvdKnANJFM0+FKADg2a3VWknZV+C7S4Sv3CKdxFDrV oN/MfpwPFLJLCSa2rALDqIDUupncjN3LAfbu+Utdhri1/G4bx77MGn3Cwq9mVjVp8bEb MtCttKpcy7U5daj99VoroQ1LSkPfOHTDVaB+5US7JFGkYgCzuleNkRRxgN+eJtE+3dgF WB7b2JXynm9uu1dPmOBvC16MdAOVgq9TtjtqqHWG5lPRQnrjOOHaBzoMS+3P98sIcV5U 4EeQ== X-Gm-Message-State: AIkVDXJhfStjzNLb+Ve6d7gQsK1hXUuPp5vnvQcgSRXiWnPDrMgeXNTqNAK3s/G6qGyv4Q== X-Received: by 10.36.64.70 with SMTP id n67mr9557502ita.21.1485230429575; Mon, 23 Jan 2017 20:00:29 -0800 (PST) Original-Received: from zony ([45.2.7.65]) by smtp.googlemail.com with ESMTPSA id p20sm10594473itc.2.2017.01.23.20.00.28 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 23 Jan 2017 20:00:29 -0800 (PST) In-Reply-To: <20170121204648.GA21091@acm> (Alan Mackenzie's message of "Sat, 21 Jan 2017 20:46:48 +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:128351 Archived-At: Alan Mackenzie writes: > > I've hacked all this together. What used to be called a "reader macro" > is now a "reader construct". I think "read syntax" is better just because the manual already uses that term. > +;; Give `,' and `,@' documentation strings which can be examined by C-h f. > +(put '\, 'function-documentation > + "See `\\=`' (also `pcase') for the details of `,'.") > +(put '\, 'reader-construct t) > + > +(put '\,@ 'function-documentation > + "See `\\=`' or `,' for the details of `,@'.") Linking from ",@" to "," seems a bit unhelpful, since "," hardly says anything and just links to "`".