From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <guile-gtk-return-723-listarch-guile-gtk=sources.redhat.com@sources.redhat.com>
Received: (qmail 32383 invoked by alias); 29 May 2003 23:37:56 -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 32364 invoked from network); 29 May 2003 23:37:55 -0000
Received: from unknown (HELO snoopy.pacific.net.au) (61.8.0.36)
  by sources.redhat.com with SMTP; 29 May 2003 23:37:55 -0000
Received: from sunny.pacific.net.au (sunny.pacific.net.au [203.2.228.40])
	by snoopy.pacific.net.au (8.12.3/8.12.3/Debian-6.3) with ESMTP id h4TNbrPB028425
	for <guile-gtk@sources.redhat.com>; Fri, 30 May 2003 09:37:54 +1000
Received: from wisma.pacific.net.au (wisma.pacific.net.au [210.23.129.72])
          by sunny.pacific.net.au with ESMTP
          id h4TNbrQg028825 for <guile-gtk@sources.redhat.com>; Fri, 30 May 2003 09:37:53 +1000 (EST)
Received: from localhost (ppp16.dyn228.pacific.net.au [203.143.228.16])
	by wisma.pacific.net.au (8.12.9/8.12.9) with ESMTP id h4TNbpYZ027662
	for <guile-gtk@sources.redhat.com>; Fri, 30 May 2003 09:37:51 +1000 (EST)
Received: from gg by localhost with local (Exim 3.35 #1 (Debian))
	id 19LWxt-0000lk-00; Fri, 30 May 2003 09:37:45 +1000
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>
From: Kevin Ryde <user42@zip.com.au>
Mail-Copies-To: never
Date: Thu, 29 May 2003 23:37:00 -0000
In-Reply-To: <m3addabfnx.fsf@lumo.pacujo.net> (Marko Rauhamaa's message of
 "25 May 2003 19:33:22 -0700")
Message-ID: <877k89nx2w.fsf@zip.com.au>
User-Agent: Gnus/5.090019 (Oort Gnus v0.19) Emacs/21.2 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-SW-Source: 2003-q2/txt/msg00119.txt.bz2

Marko Rauhamaa <marko@pacujo.net> writes:
>
>    guile-gtk: (gdk-rectangle-intersect rect1 rect2) => rect or #f
>
>    guile-gtk: (gdk-rectangle-union rect1 rect2) => rect

These two look sensible, and will suit typical rectangle arithmetic.

>    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.)


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