Subject: Re: bug#52328: 27.2; [DOC] Paragraph about quit-restore-window

From: Richard Stallman <[email-masked]>
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)