unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#7820: 24.0.50; doc of `image-display-size'
@ 2011-01-10 21:30 Drew Adams
  2011-01-28 19:13 ` Chong Yidong
  0 siblings, 1 reply; 2+ messages in thread
From: Drew Adams @ 2011-01-10 21:30 UTC (permalink / raw)
  To: 7820

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'
 






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

end of thread, other threads:[~2011-01-28 19:13 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2011-01-10 21:30 bug#7820: 24.0.50; doc of `image-display-size' Drew Adams
2011-01-28 19:13 ` Chong Yidong

Code repositories for project(s) associated with this public inbox

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

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).