[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#42154: 26.3; [DOC] This wording is too complex: frame's window-syste
From: |
Richard Stallman |
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 |
[[[ 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)