From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: XPM images Date: Tue, 01 Oct 2002 02:17:32 -0400 Sender: emacs-devel-admin@gnu.org Message-ID: References: Reply-To: rms@gnu.org NNTP-Posting-Host: localhost.gmane.org X-Trace: main.gmane.org 1033453117 16932 127.0.0.1 (1 Oct 2002 06:18:37 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Tue, 1 Oct 2002 06:18:37 +0000 (UTC) Cc: emacs-devel@gnu.org Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 17wGMc-0004On-00 for ; Tue, 01 Oct 2002 08:18:34 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 17wH6e-0006Ld-00 for ; Tue, 01 Oct 2002 09:06:09 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10) id 17wGMt-00048L-00; Tue, 01 Oct 2002 02:18:51 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10) id 17wGLf-00044V-00 for emacs-devel@gnu.org; Tue, 01 Oct 2002 02:17:35 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10) id 17wGLd-00044B-00 for emacs-devel@gnu.org; Tue, 01 Oct 2002 02:17:34 -0400 Original-Received: from fencepost.gnu.org ([199.232.76.164]) by monty-python.gnu.org with esmtp (Exim 4.10) id 17wGLd-000445-00 for emacs-devel@gnu.org; Tue, 01 Oct 2002 02:17:33 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.10) id 17wGLc-0006cq-00; Tue, 01 Oct 2002 02:17:32 -0400 Original-To: alkibiades@gmx.de In-reply-to: (message from Oliver Scholz on Mon, 30 Sep 2002 14:10:45 +0200) Errors-To: emacs-devel-admin@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.0.11 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: Xref: main.gmane.org gmane.emacs.devel:8278 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:8278 My apologies. Only two functions are supposed to be used from the "outside": `xpm-image-from-file' and `xpm-image-from-string'. Those names suggest functions that return an xpm image. However, this file is supposed to convert xpm to ppm. So those names are confusing. The function names for functions that return ppm images should probably say they return ppm images. At the very least the doc strings should say so. Besides that, the whole process of converting to and applying PPM was meant to be transparent. What the two main functions `xpm-image-from-string' and `xpm-image-from-file' actually return is an image descriptor, as a function like `insert-image' takes it as an argument. But I refer to the image descriptors in the doc-strings only as "images"; thus mimicking the documentation strings of `insert-image', `create-image' or `find-image'. That convention is very hard to understand; I recommend you find a clearer way to describe this.