Re: texinfo documentation

[Kevin Ryde <user42 at zip dot com dot au>]

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.