Subject: bug#41026: Improve documentation of `makunbound' and `fmakunbound'

From: Richard Stallman <[email-masked]>
Date: Sat, 02 May 2020 23:43:28 -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. ]]]

  > > +       doc: /* Make variable SYMBOL's value be void.

  > What's a variable symbol?

That is a grammatical misparsing.
That sentence does not talk about a "variable symbol".
It talks about a variable, and SYMBOL stands for that variable.
It is like  "the buffer BUF".

Would it be clearer to say "Make the variable VAR's value be void"
and call the argument 'var'?

-- 
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)