From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.bugs Subject: bug#52328: 27.2; [DOC] Paragraph about quit-restore-window Date: Mon, 06 Dec 2021 23:15:19 -0500 Message-ID: References: <87tufm0xcd.fsf@laposte.net> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="19563"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 52328@debbugs.gnu.org To: Kevin Vigouroux Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Dec 07 05:16:14 2021 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 1muRtl-0004pc-MB for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 07 Dec 2021 05:16:13 +0100 Original-Received: from localhost ([::1]:49498 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1muRtk-0003Ks-B3 for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 06 Dec 2021 23:16:12 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:38734) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1muRta-0003Iz-TD for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 23:16:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52568) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1muRta-0005k7-LW for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 23:16:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1muRta-0003JH-Di for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 23:16:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Richard Stallman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 07 Dec 2021 04:16:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 52328 X-GNU-PR-Package: emacs X-Debbugs-Original-Cc: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.163885052312667 (code B ref -1); Tue, 07 Dec 2021 04:16:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 7 Dec 2021 04:15:23 +0000 Original-Received: from localhost ([127.0.0.1]:35880 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1muRsx-0003IE-F1 for submit@debbugs.gnu.org; Mon, 06 Dec 2021 23:15:23 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:49762) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1muRsv-0003I7-T1 for submit@debbugs.gnu.org; Mon, 06 Dec 2021 23:15:22 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:38480) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1muRsu-0002I1-N8 for bug-gnu-emacs@gnu.org; Mon, 06 Dec 2021 23:15:21 -0500 Original-Received: from [2001:470:142:3::e] (port=54038 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1muRst-0005Sy-FE; Mon, 06 Dec 2021 23:15:19 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From: mime-version; bh=YrjolYtxbQYkn8MNCrg5Z75YDgjMadcGUTjTOJV0Vo0=; b=cH/diWWjhO37 WBwOB4FXeQfgxpBCnr4uG0JLD68Dv2JZJHoVbHzOcoh59mBu1f9y/Mqw/aEfoEM/ZFCgSsfLOb+Ak b0LSlH50UyqtP3kPJv2y7heKuCfL3mkxlmjIo4/rGOK7vGpRyQXtcz7FJ/mQIL+tnuneAkVCAClR5 KsGH2MjC8H5by0hPtj4H+xU0b9EvBkdZsjy5IjjJjYuxsLIwpeDQAWW2ELKKSmkHe5UbTMt7eLbXs 6Ek6/S3GM0Ou9U9bl/3JZzGYuHYiM61HQtfgaCAFYV8a7R2s9oQ0dkMheH2oy2aIKNpSJlqdc8zHj SYP+3tiDMVFE9rt4PvcAng==; Original-Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1muRst-00055E-HJ; Mon, 06 Dec 2021 23:15:19 -0500 In-Reply-To: <87tufm0xcd.fsf@laposte.net> (bug-gnu-emacs@gnu.org) 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:221807 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > If the third element of the ‘quit-restore’ parameter is a list of > buffer, window start (*note Window Start and End), and point > (*note > Window Point), It would be clearer to present the list using Lisp syntax: (@var{buffer} @var{window-start} @var{new-point}) Then it can talk about these values with their names, which is clearer. and that buffer is still live, the buffer will be > displayed, and start and point set accordingly. It's bad to use passive voice; that is generally less clear because of the missing subject, as well as more cluttered. "Set accordingly" is hard work to interpret because it is not concrete. This clarification will make it easier to clarify the questions that Vigouroux is asking. -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)