From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Adam Porter Newsgroups: gmane.emacs.devel Subject: Re: Incorporate package macrostep into Emacs core Date: Sat, 20 Apr 2024 12:14:58 -0500 Message-ID: References: <86mspoa7ok.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="24152"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla Thunderbird Cc: emacs-devel@gnu.org, jb@jeremybryant.net, monnier@iro.umontreal.ca To: eliz@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Apr 20 19:16:13 2024 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1ryEJw-0005z2-8i for ged-emacs-devel@m.gmane-mx.org; Sat, 20 Apr 2024 19:16:13 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ryEJ2-0003g4-B4; Sat, 20 Apr 2024 13:15:16 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ryEIv-0003fR-CW for emacs-devel@gnu.org; Sat, 20 Apr 2024 13:15:09 -0400 Original-Received: from quail.birch.relay.mailchannels.net ([23.83.209.151]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ryEIt-0000yF-1m; Sat, 20 Apr 2024 13:15:08 -0400 X-Sender-Id: dreamhost|x-authsender|adam@alphapapa.net Original-Received: from relay.mailchannels.net (localhost [127.0.0.1]) by relay.mailchannels.net (Postfix) with ESMTP id E9301C2D6F; Sat, 20 Apr 2024 17:15:00 +0000 (UTC) Original-Received: from pdx1-sub0-mail-a303.dreamhost.com (unknown [127.0.0.6]) (Authenticated sender: dreamhost) by relay.mailchannels.net (Postfix) with ESMTPA id 641EFC2CF4; Sat, 20 Apr 2024 17:15:00 +0000 (UTC) ARC-Seal: i=1; s=arc-2022; d=mailchannels.net; t=1713633300; a=rsa-sha256; cv=none; b=Mc/v/r4rmXIee/t0SvswvzxlI+wp/jwuQoHynaFxLXygmoOAA5l73J+KG7z0rjaOYORY+H kMUmdlBpwLZ6qsXqHzRKA4N7xv4p/lC3bIdkdIqrYYLdzuWcbG3UM91WISuL4f1K/GJrEo BQ9cx3S4yR/U7SRuYywiAp6ZnZWQS7cpFPP2HsMMNDd/xRcr2GLQoEU+6rZoQyfSnFJPmj +h0jp7XSf9ndB94stSiKXOp2PVEgiH0vej41Un5v6OnPTKk5l75nmdd44dRcFv6PkPVMRo 4VS+tsB5KC7BY0hDrdWY3maGr8YIVZ5sKUCI0X9hw80SIYi4E6G5ShKtPdl/uA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=mailchannels.net; s=arc-2022; t=1713633300; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=wcF/ewiuQSaE4H4k8NbJYHja/SWecqU1FxW4PEiCCEw=; b=3H/BN6J0bkMVMZEQZyoSkEFJgV0rd9JngtTiPZZc7KPl+RucLRVc8mOTH24dOEfaMrCkss dI6Qg2tDO+OPMqDkD7o+k+8yNzBfRkK295gdRYw3BmOz9N8hvunmvCHuMKb8yNZE2FIFmM HSohRwxb2GDvXt4WcdQTI0m7l8EkzP3wfCrVIGpSVXXk1epFFr4bP6o2tJVGBb9z2sCS6N L6mCXHn9IkmInx+Qh3ZQACyPU5y6szzG6uLRfPLBYvXwx5drO1cFUnXdkNXU2kKx1FAaiz jNZ+DJwXTWT0/ayek3MW0/3V5jZ5peOaWmvzkCHAsaa8VjGbLuKaPgsgam3YZg== ARC-Authentication-Results: i=1; rspamd-878bcf566-2df8x; auth=pass smtp.auth=dreamhost smtp.mailfrom=adam@alphapapa.net X-Sender-Id: dreamhost|x-authsender|adam@alphapapa.net X-MC-Relay: Neutral X-MailChannels-SenderId: dreamhost|x-authsender|adam@alphapapa.net X-MailChannels-Auth-Id: dreamhost X-Scare-Reign: 0f6609f817c01675_1713633300661_1104520895 X-MC-Loop-Signature: 1713633300661:2382006751 X-MC-Ingress-Time: 1713633300661 Original-Received: from pdx1-sub0-mail-a303.dreamhost.com (pop.dreamhost.com [64.90.62.162]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384) by 100.124.56.137 (trex/6.10.3); Sat, 20 Apr 2024 17:15:00 +0000 Original-Received: from [10.28.0.158] (unknown [45.131.192.18]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: adam@alphapapa.net) by pdx1-sub0-mail-a303.dreamhost.com (Postfix) with ESMTPSA id 4VMJ6W2MC4z1G; Sat, 20 Apr 2024 10:14:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alphapapa.net; s=dreamhost; t=1713633299; bh=wcF/ewiuQSaE4H4k8NbJYHja/SWecqU1FxW4PEiCCEw=; h=Date:To:Cc:Subject:From:Content-Type:Content-Transfer-Encoding; b=oDNjVk8g+V2kmwzjJp2bvHoH0KyHKXakrztoG5ZraSz9FIOSZznNMgUdzSPkGi6x/ 0W5dkFAyF8fiqd4i7OH/7b9MSyWpXZ/4E4d8RdD20pZ/VvcFEt8cG4KxsYhPcJKLbt qUm067dKO762he4CKKla3NKyjhfB7PbyEDScPm9VjMIoK3l5P3bVDxh3QJahHUjJ2U NXBkqsYVdOHCsm902dM37URZyi/IGK9zB9rPJWgzmjN2US+gO4LYk1OWhd3KHH8flr TgM3K68hnROQ6nCbUqfVWoffIY8c5V4BfZ1uXDAryOm83b8Tgv+wyQoeDaHdUB9RJM vTL0/Pnz2S38A== Content-Language: en-US In-Reply-To: <86mspoa7ok.fsf@gnu.org> Received-SPF: neutral client-ip=23.83.209.151; envelope-from=adam@alphapapa.net; helo=quail.birch.relay.mailchannels.net X-Spam_score_int: -12 X-Spam_score: -1.3 X-Spam_bar: - X-Spam_report: (-1.3 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_NEUTRAL=0.779 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:317887 Archived-At: >> If it works only for Emacs Lisp macros, then it makes sense to put it in >> the ELisp manual. > > It's a minor mode, and the documentation describes commands of that > mode. I don't think the ELisp manual is a good place for such > features. We have "Programs" in the user manual, which describes > features for developing programs using Emacs, and I think it's a good > place for describing this feature. Not that I necessarily disagree, but I think it warrants at least a mention in the Elisp manual section about macros, because it's very helpful for understanding how macros work. If it were only mentioned in the Emacs manual, new Elispers who are reading up on macros could easily overlook this great tool.