From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Doc of keyboard macros Date: Mon, 24 Sep 2018 20:07:25 +0300 Message-ID: <83va6uakoi.fsf@gnu.org> References: <835zyuc457.fsf@gnu.org> <834leec2s2.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1537808737 1854 195.159.176.226 (24 Sep 2018 17:05:37 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 24 Sep 2018 17:05:37 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Sep 24 19:05:33 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 1g4UId-0000JO-65 for ged-emacs-devel@m.gmane.org; Mon, 24 Sep 2018 19:05:31 +0200 Original-Received: from localhost ([::1]:46193 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g4UKj-00024L-JY for ged-emacs-devel@m.gmane.org; Mon, 24 Sep 2018 13:07:41 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49307) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g4UKd-000243-1S for emacs-devel@gnu.org; Mon, 24 Sep 2018 13:07:35 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1g4UKZ-0007yc-ST for emacs-devel@gnu.org; Mon, 24 Sep 2018 13:07:35 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:38715) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1g4UKZ-0007yW-Oo; Mon, 24 Sep 2018 13:07:31 -0400 Original-Received: from [176.228.60.248] (port=1520 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1g4UKZ-0001T0-CX; Mon, 24 Sep 2018 13:07:31 -0400 In-reply-to: (message from Stefan Monnier on Mon, 24 Sep 2018 12:36:35 -0400) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e 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:230028 Archived-At: > 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.