From unknown Sun Jun 22 00:37:39 2025 X-Loop: help-debbugs@gnu.org Subject: bug#7820: 24.0.50; doc of `image-display-size' 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: To: 7820@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.129469461814848 (code B ref -1); Mon, 10 Jan 2011 21:24:03 +0000 Received: (at submit) by debbugs.gnu.org; 10 Jan 2011 21:23:38 +0000 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 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 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 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_MED, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 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 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 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 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 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 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 Received: from abhmt006.oracle.com by acsmt354.oracle.com with ESMTP id 946541061294695037; Mon, 10 Jan 2011 13:30:37 -0800 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 10 Jan 2011 13:30:36 -0800 From: "Drew Adams" Date: Mon, 10 Jan 2011 13:30:38 -0800 Message-ID: <7509C05804C24E419F2080CF2636C15E@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit 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-Spam-Score: -6.4 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.4 (------) 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' From unknown Sun Jun 22 00:37:39 2025 X-Loop: help-debbugs@gnu.org Subject: bug#7820: 24.0.50; doc of `image-display-size' Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 28 Jan 2011 19:06:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 7820 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Drew Adams" Cc: 7820@debbugs.gnu.org Received: via spool by 7820-submit@debbugs.gnu.org id=B7820.129624152824621 (code B ref 7820); Fri, 28 Jan 2011 19:06:01 +0000 Received: (at 7820) by debbugs.gnu.org; 28 Jan 2011 19:05:28 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PitdQ-0006P4-LN for submit@debbugs.gnu.org; Fri, 28 Jan 2011 14:05:28 -0500 Received: from vm-emlprdomr-04.its.yale.edu ([130.132.50.145]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PitdP-0006Ot-AJ for 7820@debbugs.gnu.org; Fri, 28 Jan 2011 14:05:27 -0500 Received: from furball (dhcp128036014130.central.yale.edu [128.36.14.130]) (authenticated bits=0) by vm-emlprdomr-04.its.yale.edu (8.14.4/8.14.4) with ESMTP id p0SJDd8F013302 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Fri, 28 Jan 2011 14:13:40 -0500 Received: by furball (Postfix, from userid 1000) id 69BE91602C5; Fri, 28 Jan 2011 14:13:40 -0500 (EST) From: Chong Yidong References: <7509C05804C24E419F2080CF2636C15E@us.oracle.com> Date: Fri, 28 Jan 2011 14:13:40 -0500 In-Reply-To: <7509C05804C24E419F2080CF2636C15E@us.oracle.com> (Drew Adams's message of "Mon, 10 Jan 2011 13:30:38 -0800") Message-ID: <87wrlo96zf.fsf@stupidchicken.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Scanned-By: MIMEDefang 2.71 on 130.132.50.145 X-Spam-Score: -2.7 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) "Drew Adams" writes: > The doc string does not say what the function returns. Fixed, thanks. From debbugs-submit-bounces@debbugs.gnu.org Fri Jan 28 14:05:42 2011 Received: (at control) by debbugs.gnu.org; 28 Jan 2011 19:05:42 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Pitdd-0006PU-T3 for submit@debbugs.gnu.org; Fri, 28 Jan 2011 14:05:42 -0500 Received: from vm-emlprdomr-03.its.yale.edu ([130.132.50.144]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Pitdc-0006PI-Mg for control@debbugs.gnu.org; Fri, 28 Jan 2011 14:05:40 -0500 Received: from furball (dhcp128036014130.central.yale.edu [128.36.14.130]) (authenticated bits=0) by vm-emlprdomr-03.its.yale.edu (8.14.4/8.14.4) with ESMTP id p0SJDrKa030011 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT) for ; Fri, 28 Jan 2011 14:13:53 -0500 Received: by furball (Postfix, from userid 1000) id A09381602C5; Fri, 28 Jan 2011 14:13:53 -0500 (EST) From: Chong Yidong To: control@debbugs.gnu.org Subject: close 7820 Date: Fri, 28 Jan 2011 14:13:53 -0500 Message-ID: <87zkqkq1se.fsf@stupidchicken.com> MIME-Version: 1.0 Content-Type: text/plain X-Scanned-By: MIMEDefang 2.71 on 130.132.50.144 X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) close 7820 thanks