[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Text collation

From: Neil Jerram
Subject: Re: Text collation
Date: Wed, 25 Oct 2006 19:43:22 +0100
User-agent: Gnus/5.1007 (Gnus v5.10.7) Emacs/21.4 (gnu/linux)

Rob Browning <address@hidden> writes:

> address@hidden (Ludovic Courtès) writes:
>> I don't think this is actually the case: there are currently 4
>> shared libraries in the `srfi' directory, but none of them is
>> documented in the manual and the C functions they export are not
>> mentioned either (that's what I meant by "practically preclude":
>> it's technically possible to use them but it's not documented).
> Actually, in general, the SRFI scm_* functions are intended for public
> use.  If not, then all of the relevant scm_* functions would/should
> have been named scm_i_*.
> Also, you definitely can't judge by the presence or lack of
> documentation.  Guile's documentation has often taken a while to catch
> up with the code.

I'm not sure I agree with that.  I accept that documentation can
sometimes take a while to catch up (although it shouldn't, and
recently I think we've all been pretty good about writing doc at the
same time as developing something), but in principle I think "presence
in the manual" is a better way of indicating to users whether an API
is officially supported than a coding convention.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]