Re: (make-frame-visible), doesn't

[Jan Djärv]

Chris Moore skrev:
> Jan Djärv <address@hidden> writes:
> 
>> It is the intended behaviour.  Visible means not iconified and not
>> withdrawn.
> 
> OK, I was working with the more traditional definition:
>   "perceptible to the eye".
> 
> I don't know how common your definition is, but I would suggest that
> most people reading the function's docstring would probably
> misunderstand what it does based on the current text.

It is commin X11 terminology at least.  And it is even used in the
documentation for raise-frame:

"If frame is invisible or iconified, make it visible"

> 
> For an example of useful documentation see raise-frame - that
> describes what the function does in language that an "average Emacs
> user" (if there is any such creature) would understand.

There is always room for documentation improvements.  Do you have a suggestion?

        Jan D.