From: Eli Zaretskii <eliz@gnu.org>
To: Kevin Vigouroux <ke.vigouroux@laposte.net>
Cc: 52328@debbugs.gnu.org
Subject: bug#52328: 27.2; [DOC] Paragraph about quit-restore-window
Date: Tue, 07 Dec 2021 20:31:46 +0200 [thread overview]
Message-ID: <83pmq8xo4t.fsf@gnu.org> (raw)
In-Reply-To: <87tufm0xcd.fsf@laposte.net> (bug-gnu-emacs@gnu.org)
> Date: Mon, 06 Dec 2021 12:46:58 +0100
> From: Kevin Vigouroux via "Bug reports for GNU Emacs,
> the Swiss army knife of text editors" <bug-gnu-emacs@gnu.org>
>
> 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), and that buffer is still live, the buffer will be
> displayed, and start and point set accordingly. If, in addition,
> WINDOW’s buffer was temporarily resized, this function will also try to
> restore the original height of WINDOW.
> #+end_quote
>
> It seems to me that there could be an error in the presentation or in
> the designation of the elements.
>
> Is it the WINDOW parameter (second element of ‘quit-restore’) or is it
> the window selected at the time the parameter was created (third element
> of ‘quit-restore’)?
Neither, AFAIU. It's the WINDOW argument of quit-restore-window
function, i.e. the window the function is quitting. The upper-case
WINDOW signals that it refers to an argument of a function, not to
some symbol by that name.
I do agree that the description of the function is very hard to
understand, due to the multitude of possible formats of the
quit-restore parameter and the meaning of its elements.
next prev parent reply other threads:[~2021-12-07 18:31 UTC|newest]
Thread overview: 17+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-12-06 11:46 bug#52328: 27.2; [DOC] Paragraph about quit-restore-window Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-12-07 4:15 ` Richard Stallman
2021-12-07 18:36 ` Eli Zaretskii
2021-12-08 4:35 ` Richard Stallman
2021-12-08 11:02 ` martin rudalics
2021-12-09 4:16 ` Richard Stallman
2021-12-09 8:05 ` martin rudalics
2021-12-11 4:06 ` Richard Stallman
2021-12-11 4:48 ` bug#52328: [External] : " Drew Adams
2021-12-12 4:00 ` Richard Stallman
2021-12-11 4:06 ` Richard Stallman
2021-12-11 8:44 ` martin rudalics
2021-12-12 4:00 ` Richard Stallman
2021-12-12 7:02 ` Eli Zaretskii
2021-12-12 13:09 ` Eli Zaretskii
2021-12-07 18:31 ` Eli Zaretskii [this message]
2021-12-08 11:00 ` martin rudalics
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=83pmq8xo4t.fsf@gnu.org \
--to=eliz@gnu.org \
--cc=52328@debbugs.gnu.org \
--cc=ke.vigouroux@laposte.net \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).