Re: Documentation not clear for the Lisp function set-variable

[Eli Zaretskii]

> Date: Mon, 27 Jun 2005 15:04:58 +0200
> From: Juanma Barranquero <address@hidden>
> Cc: address@hidden, address@hidden
> 
> Try this patch, please. It doesn't modify `set-variable' but
> `user-variable-p', so it returns t for non-obsolete aliases of user
> variables.

This patch produces the following text:

   Determined by whether the first character of the documentation
  for the variable is `*', the variable is customizable (has a non-nil
  value of `standard-value' or of `custom-autoload' on its property list),
  or it is a non-obsolete alias for another user variable.

Does anyone else think that this sentence is so confusing in its
structure as to be almost unparsable?  (The old sentence was even less
clear.)

I think this sentence sorely needs rephrasing.  For starters, it
should not use passive tense.