Re: [Emacs-diffs] master b533552 2/5: Documentation fixes re quotes

[David Kastrup]

Richard Stallman <address@hidden> writes:

> [[[ 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. ]]]
>
>   >  DEFUN ("set-message-beep", Fset_message_beep, Sset_message_beep, 1, 1, 0,
>   >         doc: /* Set the sound generated when the bell is rung.
>   > -SOUND is 'asterisk, 'exclamation, 'hand, 'question, 'ok, or 'silent
>   > -to use the corresponding system sound for the bell.  The 'silent sound
>   > +SOUND is `asterisk', `exclamation', `hand', `question', `ok', or `silent'
>   > +to use the corresponding system sound for the bell.  The `silent' sound
>   >  prevents Emacs from making any sound at all.
>
> These changes are necessary in any case; the old text violates
> Emacs documentation conventions.  It is incorrect to indicate
> a symbol in text by writing a singlequote before it.
> The correct way is to write quotes around  it (except for t and nil).

Thanks.

My actual point of annoyance was the total inability to get any useful
feedback concerning such changes because of semantic gameplay.

-- 
David Kastrup