GNU bug report logs - #7820
24.0.50; doc of `image-display-size'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 7820 in the body.
You can then email your comments to 7820 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 24.0.50; doc of `image-display-size'
Date: Mon, 10 Jan 2011 13:30:38 -0800

The doc string does not say what the function returns.
 
It talks about calculating "the display size" but does not say what is
meant by that.  All the doc really does is describe the implementation:
we say the function calls this or that or the other thing, then this...
 
`image-display-size' is called more than `image-size' is.  The former
appears to be the one of the two that should be better documented,
but there is no explanation of what the "display size" of an image is or
what the difference is between this "wrapper" and what it wraps.
 
And the Elisp manual describes only `image-size', which seems backwards.
 
Finally, saying that the wrapper exists "to handle slice display
properties" explains nothing.  If that is its raison d'etre then
explain that better.  In what way does it "handle" these properties.
I don't mean how it does it but what it does: what is meant by this
handling?  What is the result etc.?
 

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2011-01-03 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.4) --no-opt --cflags
-Ic:/imagesupport/include'
 

Message #8 received at 7820 <at> debbugs.gnu.org (full text, mbox):

From: Chong Yidong <cyd <at> stupidchicken.com>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 7820 <at> debbugs.gnu.org
Subject: Re: bug#7820: 24.0.50; doc of `image-display-size'
Date: Fri, 28 Jan 2011 14:13:40 -0500

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

> The doc string does not say what the function returns.

Fixed, thanks.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.