GNU bug report logs - #52328
27.2; [DOC] Paragraph about quit-restore-window

Previous Next

Full log

Message #8 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Richard Stallman <rms <at> gnu.org>
To: Kevin Vigouroux <ke.vigouroux <at> laposte.net>
Cc: bug-gnu-emacs <at> gnu.org
Subject: Re: bug#52328: 27.2; [DOC] Paragraph about quit-restore-window
Date: Mon, 06 Dec 2021 23:15:19 -0500

[[[ 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)

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.