From: Richard Stallman <rms@gnu.org>
To: Kevin Vigouroux <ke.vigouroux@laposte.net>
Cc: 42154@debbugs.gnu.org
Subject: bug#42154: 26.3; [DOC] This wording is too complex: frame's window-system window.
Date: Wed, 01 Jul 2020 23:47:13 -0400 [thread overview]
Message-ID: <E1jqqBt-00018E-EC@fencepost.gnu.org> (raw)
In-Reply-To: <878sg3w6il.fsf@laposte.net> (bug-gnu-emacs@gnu.org)
[[[ 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 this is above, the **frame's window-system window** is displayed above
One thing I notice is that this uses passive voice.
That tends to be harder to read; also, it leaves the
subject unstated, and that vagueness can hurt.
(I don't know what that doc string text means.)
--
Dr Richard Stallman
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)
next prev parent reply other threads:[~2020-07-02 3:47 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-07-01 16:21 bug#42154: 26.3; [DOC] This wording is too complex: frame's window-system window Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors
2020-07-01 16:49 ` Eli Zaretskii
2020-07-02 12:15 ` Kevin Vigouroux via Bug reports for GNU Emacs, the Swiss army knife of text editors
2020-07-02 13:30 ` Eli Zaretskii
2020-07-02 3:47 ` Richard Stallman [this message]
2020-07-02 13:03 ` Eli Zaretskii
2020-07-04 7:21 ` Eli Zaretskii
2020-07-05 2:35 ` Richard Stallman
2020-07-05 14:33 ` Eli Zaretskii
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
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=E1jqqBt-00018E-EC@fencepost.gnu.org \
--to=rms@gnu.org \
--cc=42154@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 external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.