From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <guile-gtk-return-725-listarch-guile-gtk=sources.redhat.com@sources.redhat.com>
Received: (qmail 4523 invoked by alias); 30 May 2003 01:06:38 -0000
Mailing-List: contact guile-gtk-help@sources.redhat.com; run by ezmlm
Precedence: bulk
List-Subscribe: <mailto:guile-gtk-subscribe@sources.redhat.com>
List-Archive: <http://sources.redhat.com/ml/guile-gtk/>
List-Post: <mailto:guile-gtk@sources.redhat.com>
List-Help: <mailto:guile-gtk-help@sources.redhat.com>, <http://sources.redhat.com/ml/#faqs>
Sender: guile-gtk-owner@sources.redhat.com
Received: (qmail 4515 invoked from network); 30 May 2003 01:06:38 -0000
Received: from unknown (HELO lumo.pacujo.net) (209.77.185.85)
  by sources.redhat.com with SMTP; 30 May 2003 01:06:38 -0000
Received: (from marko@localhost)
	by lumo.pacujo.net (8.11.6/8.11.6/SuSE Linux 0.5) id h4U0vYH04731;
	Thu, 29 May 2003 17:57:34 -0700
To: guile-gtk@sources.redhat.com
Subject: Re: texinfo documentation
References: <87llxd2c59.fsf@zip.com.au> <m3bry9q6q6.fsf@lumo.pacujo.net>
	<874r3lmifw.fsf@zip.com.au> <m3llwxe0l4.fsf@lumo.pacujo.net>
	<87of1tjjwy.fsf@zip.com.au> <m3addddxo4.fsf@lumo.pacujo.net>
	<87znldi1wl.fsf@zip.com.au> <m3llwwdhjf.fsf@lumo.pacujo.net>
	<87el2mmymo.fsf@zip.com.au> <m3u1bibomb.fsf@lumo.pacujo.net>
	<87smr2lgge.fsf@zip.com.au> <m3addabfnx.fsf@lumo.pacujo.net>
	<877k89nx2w.fsf@zip.com.au>
From: Marko Rauhamaa <marko@pacujo.net>
Date: Fri, 30 May 2003 01:06:00 -0000
In-Reply-To: <877k89nx2w.fsf@zip.com.au>
Message-ID: <m33cix8d4x.fsf@lumo.pacujo.net>
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.1
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-SW-Source: 2003-q2/txt/msg00121.txt.bz2

Kevin Ryde <user42@zip.com.au>:

> Marko Rauhamaa <marko@pacujo.net> writes:
> >    guile-gtk: (gdk-string-to-compound str) => (string or #f
> >                                                encoding
> >                                                format)
> 
> Hmm.  (bool encoding format string) would better match the C function,
> in particular enough not to need to be described as a special case.
> 
> (Or only with a general note somewhere that gint returns that should
> be understdood as gboolean are treated that way by guile-gtk.)

Note that the C function returns 0 for success and any other value for
failure.

> Obviously there's no need to be absolutely slavish, but every
> difference is an inconsistency and a likely source of annoyance for
> programmers.

Since it's technically impossible to be absolutely slavish, I'm afraid
we will have to publish the signatures of each and every guile-gtk
function -- no other explanations are necessary.


Marko

-- 
Marko Rauhamaa      mailto:marko@pacujo.net     http://pacujo.net/marko/