From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#55788: [PATCH] Improve documentation of the raise-sexp command Date: Mon, 06 Jun 2022 13:44:17 +0300 Message-ID: <83mteq841q.fsf@gnu.org> References: <87r1448wsk.fsf@gnus.org> <86h74ywae2.fsf@mail.linkov.net> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="8212"; mail-complaints-to="usenet@ciao.gmane.io" Cc: larsi@gnus.org, 55788@debbugs.gnu.org, mardani29@yahoo.es To: Juri Linkov Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Jun 06 12:52:11 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1nyALC-0001ua-Sp for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 06 Jun 2022 12:52:11 +0200 Original-Received: from localhost ([::1]:58674 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nyALB-0003nY-Kn for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 06 Jun 2022 06:52:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:57932) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nyAEI-0006XU-24 for bug-gnu-emacs@gnu.org; Mon, 06 Jun 2022 06:45:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:40579) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nyAEH-00015l-Ob for bug-gnu-emacs@gnu.org; Mon, 06 Jun 2022 06:45:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nyAEH-0000cG-KM for bug-gnu-emacs@gnu.org; Mon, 06 Jun 2022 06:45:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 06 Jun 2022 10:45:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 55788 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 55788-submit@debbugs.gnu.org id=B55788.16545122992343 (code B ref 55788); Mon, 06 Jun 2022 10:45:01 +0000 Original-Received: (at 55788) by debbugs.gnu.org; 6 Jun 2022 10:44:59 +0000 Original-Received: from localhost ([127.0.0.1]:34476 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nyAEF-0000bi-Ce for submit@debbugs.gnu.org; Mon, 06 Jun 2022 06:44:59 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:44690) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nyAEA-0000bL-OY for 55788@debbugs.gnu.org; Mon, 06 Jun 2022 06:44:57 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:33780) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nyAE5-00012F-2T; Mon, 06 Jun 2022 06:44:49 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=Cd9sgtmmT8M7/TijUuPfAMRHfWT9R6eZiTwM6KeriNQ=; b=aaOJNlFQs+Aoytkn1j2g i50I6GRJvtRlUcykFbkZw2tx+5GsY010+FbM6v/F/74oWg12z31jz6duSIc8YJR2bJwR+ha6W8HwS ZEgAyfBDsM1f9zMs254uRqnUDUmURCCAEgRrSfbgFVwQFRYM4l1K8ZqG5OyQHdV8Zfp+/NPHuLLob /MZJVZH9jvKL9lQVwklu7uvzGDZEHq8rVtHQWrB+RuSSozP5ULHboyn64DvHAZgyR7jsFmanvW9S6 FUHBTjN0hTYhiNJ355EH+iWiiodqyAMmGmYHOaWdg5MUA/xVUIiLB71/tIlg6D1rdpFhnBCSGHMfh Ar8vLonLXOGUBw==; Original-Received: from [87.69.77.57] (port=4973 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nyADk-0006e2-5z; Mon, 06 Jun 2022 06:44:40 -0400 In-Reply-To: <86h74ywae2.fsf@mail.linkov.net> (message from Juri Linkov on Mon, 06 Jun 2022 10:33:25 +0300) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:233768 Archived-At: > Cc: 55788@debbugs.gnu.org, Daniel Martín > From: Juri Linkov > Date: Mon, 06 Jun 2022 10:33:25 +0300 > > > "Raise ARG sexps higher up the tree. > > This means that the ARGth enclosing form will be deleted and > > replaced with the form that follows point. > > > > For instance, if you have: > > > > (let ((foo 2)) > > (progn > > (setq foo 3) > > (zot) > > (+ foo 2))) > > > > and point is before (zot), `M-x raise-sexp' will give you > > > > (let ((foo 2)) > > (zot))" > > It seems that new docstring suggests that `M-2 M-x raise-sexp' will give > > (zot) > > whereas really it will give > > (let ((foo 2)) > (zot) > (+ foo 2)) > > since ARG is the number of sexps that follow point and that will be raised. Right. Is the below better? Raise ARG sexps one level higher up the tree. This function removes the sexp enclosing the form which follows point, and then re-inserts ARG sexps following point, thus raising them one level up.