From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#7820: 24.0.50; doc of `image-display-size' Date: Mon, 10 Jan 2011 13:30:38 -0800 Message-ID: <7509C05804C24E419F2080CF2636C15E@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1294696571 730 80.91.229.12 (10 Jan 2011 21:56:11 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 10 Jan 2011 21:56:11 +0000 (UTC) To: 7820@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jan 10 22:56:07 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PcPig-0002as-Vw for geb-bug-gnu-emacs@m.gmane.org; Mon, 10 Jan 2011 22:56:07 +0100 Original-Received: from localhost ([127.0.0.1]:42500 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PcPig-0001zT-FK for geb-bug-gnu-emacs@m.gmane.org; Mon, 10 Jan 2011 16:56:06 -0500 Original-Received: from [140.186.70.92] (port=56474 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PcPgq-0000Qq-8Z for bug-gnu-emacs@gnu.org; Mon, 10 Jan 2011 16:54:13 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PcPgo-0008Sx-Vn for bug-gnu-emacs@gnu.org; Mon, 10 Jan 2011 16:54:12 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:38810) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PcPgo-0008St-ST for bug-gnu-emacs@gnu.org; Mon, 10 Jan 2011 16:54:10 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PcPDg-0003sG-GI; Mon, 10 Jan 2011 16:24:04 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 10 Jan 2011 21:24:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 7820 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.129469461814848 (code B ref -1); Mon, 10 Jan 2011 21:24:03 +0000 Original-Received: (at submit) by debbugs.gnu.org; 10 Jan 2011 21:23:38 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PcPDF-0003rQ-Eg for submit@debbugs.gnu.org; Mon, 10 Jan 2011 16:23:37 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PcPDD-0003rF-GY for submit@debbugs.gnu.org; Mon, 10 Jan 2011 16:23:35 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PcPKO-0002hC-Gu for submit@debbugs.gnu.org; Mon, 10 Jan 2011 16:31:01 -0500 Original-Received: from lists.gnu.org ([199.232.76.165]:42568) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PcPKO-0002h8-E5 for submit@debbugs.gnu.org; Mon, 10 Jan 2011 16:31:00 -0500 Original-Received: from [140.186.70.92] (port=56830 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PcPKN-0002P2-8c for bug-gnu-emacs@gnu.org; Mon, 10 Jan 2011 16:31:00 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PcPKM-0002gZ-80 for bug-gnu-emacs@gnu.org; Mon, 10 Jan 2011 16:30:59 -0500 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]:20801) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PcPKL-0002gL-Ss for bug-gnu-emacs@gnu.org; Mon, 10 Jan 2011 16:30:58 -0500 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id p0ALUrsH023770 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 10 Jan 2011 21:30:54 GMT Original-Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154]) by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id p0AInoGS004875 for ; Mon, 10 Jan 2011 21:30:53 GMT Original-Received: from abhmt006.oracle.com by acsmt354.oracle.com with ESMTP id 946541061294695037; Mon, 10 Jan 2011 13:30:37 -0800 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 10 Jan 2011 13:30:36 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcuxDZ+bNh/lg501RDa+yqSjqM3LAg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Mon, 10 Jan 2011 16:24:04 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:43243 Archived-At: 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'