all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#14305: 23.4; doc string of `frame-visible-p'
@ 2013-04-29 15:19 Drew Adams
  2014-02-08 11:03 ` Lars Ingebrigtsen
  0 siblings, 1 reply; 3+ messages in thread
From: Drew Adams @ 2013-04-29 15:19 UTC (permalink / raw)
  To: 14305

This makes it sound like "iconified" is something different from
"minimized":
 
  Return the symbol `icon' if FRAME is iconified or "minimized".
 
To imply that minimized means the same thing as iconified, you need a
comma after "iconified" (or put "'minimized'" in parens):
 
  Return the symbol `icon' if FRAME is iconified, or minimized.
 
  Return the symbol `icon' if FRAME is iconified (minimized).
 
The second is clearer, not requiring readers to notice the comma and
recognize how it changes parsing of the sentence.
 
And you can remove the quotes around "visible", "minimized", and
"taskbar".

In GNU Emacs 23.4.1 (i386-mingw-nt5.1.2600)
 of 2012-02-04 on MARVIN
Windowing system distributor `Microsoft Corp.', version 5.1.2600
Configured using:
 `configure --with-gcc (4.4) --cflags
 -ID:/devel/emacs/libs/libXpm-3.5.8/include
 -ID:/devel/emacs/libs/libXpm-3.5.8/src
 -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include
 -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include
 -ID:/devel/emacs/libs/giflib-4.1.4-1/include
 -ID:/devel/emacs/libs/jpeg-6b-4/include
 -ID:/devel/emacs/libs/tiff-3.8.2-1/include'
 






^ permalink raw reply	[flat|nested] 3+ messages in thread

* bug#14305: 23.4; doc string of `frame-visible-p'
  2013-04-29 15:19 bug#14305: 23.4; doc string of `frame-visible-p' Drew Adams
@ 2014-02-08 11:03 ` Lars Ingebrigtsen
  2014-02-10 21:45   ` Drew Adams
  0 siblings, 1 reply; 3+ messages in thread
From: Lars Ingebrigtsen @ 2014-02-08 11:03 UTC (permalink / raw)
  To: Drew Adams; +Cc: 14305

"Drew Adams" <drew.adams@oracle.com> writes:

> This makes it sound like "iconified" is something different from
> "minimized":
>
>   Return the symbol `icon' if FRAME is iconified or "minimized".
>
> To imply that minimized means the same thing as iconified, you need a
> comma after "iconified" (or put "'minimized'" in parens):
>
>   Return the symbol `icon' if FRAME is iconified, or minimized.
>
>   Return the symbol `icon' if FRAME is iconified (minimized).

Well, are they the same thing?  

> The second is clearer, not requiring readers to notice the comma and
> recognize how it changes parsing of the sentence.
>
> And you can remove the quotes around "visible", "minimized", and
> "taskbar".

Even if a frame is obscured by other frames (and is therefore not
visible), I think this function will still say that it is "visible".  So
I think the sneer quotes are correct here.  Closing.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/





^ permalink raw reply	[flat|nested] 3+ messages in thread

* bug#14305: 23.4; doc string of `frame-visible-p'
  2014-02-08 11:03 ` Lars Ingebrigtsen
@ 2014-02-10 21:45   ` Drew Adams
  0 siblings, 0 replies; 3+ messages in thread
From: Drew Adams @ 2014-02-10 21:45 UTC (permalink / raw)
  To: Lars Ingebrigtsen; +Cc: 14305

> Well, are they the same thing?

You tell me.  What's the content of the message to users here?
If they are the same, then add commas or otherwise make that clear.
If not, and if it is important to mention both, then it becomes
important to say what each is (what the difference is).

> > The second is clearer, not requiring readers to notice the comma
> > and recognize how it changes parsing of the sentence.
> >
> > And you can remove the quotes around "visible", "minimized", and
> > "taskbar".
> 
> Even if a frame is obscured by other frames (and is therefore not
> visible), I think this function will still say that it is "visible".
> So I think the sneer quotes are correct here. 

You might have a point there for "visible", but not for the other
two, AFAICT.  On some platforms a frame might be iconified on the
desktop, and the icon thus hidden by another frame.  But on other
platforms the icons are in a task bar or whatever, not covered by
another frame.  And I see no reason whatsover for quotes, sneer
or otherwise, around "taskbar".

> Closing.

Fixing is what should be done.





^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2014-02-10 21:45 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2013-04-29 15:19 bug#14305: 23.4; doc string of `frame-visible-p' Drew Adams
2014-02-08 11:03 ` Lars Ingebrigtsen
2014-02-10 21:45   ` Drew Adams

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.