Subject: bug#42154: 26.3; [DOC] This wording is too complex: frame's window-system window.

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