From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: Doc of keyboard macros Date: Mon, 24 Sep 2018 15:00:08 -0400 Message-ID: References: <835zyuc457.fsf@gnu.org> <834leec2s2.fsf@gnu.org> <83va6uakoi.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1537815538 4961 195.159.176.226 (24 Sep 2018 18:58:58 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 24 Sep 2018 18:58:58 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Sep 24 20:58:54 2018 Return-path: Envelope-to: ged-emacs-devel@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 1g4W4J-00017f-LU for ged-emacs-devel@m.gmane.org; Mon, 24 Sep 2018 20:58:51 +0200 Original-Received: from localhost ([::1]:46536 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g4W6Q-0001Os-Bf for ged-emacs-devel@m.gmane.org; Mon, 24 Sep 2018 15:01:02 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57415) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g4W5f-0000zO-TW for emacs-devel@gnu.org; Mon, 24 Sep 2018 15:00:18 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g4W5b-0002UE-C0 for emacs-devel@gnu.org; Mon, 24 Sep 2018 15:00:15 -0400 Original-Received: from pruche.dit.umontreal.ca ([132.204.246.22]:35194) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g4W5b-0002SM-37; Mon, 24 Sep 2018 15:00:11 -0400 Original-Received: from fmsmemgm.homelinux.net (lechon.iro.umontreal.ca [132.204.27.242]) by pruche.dit.umontreal.ca (8.14.7/8.14.1) with ESMTP id w8OJ08ts029596; Mon, 24 Sep 2018 15:00:08 -0400 Original-Received: by fmsmemgm.homelinux.net (Postfix, from userid 20848) id 36060AE251; Mon, 24 Sep 2018 15:00:08 -0400 (EDT) In-Reply-To: <83va6uakoi.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 24 Sep 2018 20:07:25 +0300") X-NAI-Spam-Flag: NO X-NAI-Spam-Threshold: 5 X-NAI-Spam-Score: 0 X-NAI-Spam-Rules: 2 Rules triggered EDT_SA_DN_PASS=0, RV6380=0 X-NAI-Spam-Version: 2.3.0.9418 : core <6380> : inlines <6893> : streams <1799403> : uri <2717256> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 132.204.246.22 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:230036 Archived-At: Fixed and pushed, Thank you, Stefan Eli Zaretskii writes: >> From: Stefan Monnier >> Date: Mon, 24 Sep 2018 12:36:35 -0400 >> >> >> . You are breaking the manual's style when describing commands: we >> >> always start with a list of the commands with short descriptions, >> >> and follow that by the detailed descriptions. >> >> Not sure exactly in which way I broke with that convention. >> Does it mean that I should move the "details" (like the C-u/C-uC-u and >> the F4-vs-C-xe discussion) to after the table? > > Yes, I think so. > >> Now that I think a bit more about it, I actually wonder why we bother >> discussing this C-u business so early in the "Basic Keyboard Macro". > > Because they have very different effect, not just some minor variation > of the original command. > >> @table @kbd >> +@item C-x ( >> @item @key{F3} > > The second one should be @itemx, not @item. And I think we should > have F3 first, because "C-x (" is deprecated, and we are now > reinstating it for the benefit of some systems that are either rare or > ones that we aren't supposed to care about too much. > >> +@item C-x e >> @item @key{F4} > > Same here. > >> +@item C-u C-x ( >> @item C-u @key{F3} > > Same here. > >> +@item C-u C-u C-x ( >> @item C-u C-u @key{F3} > > Same here. > > Thanks.