From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Neil Jerram Newsgroups: gmane.lisp.guile.devel Subject: Re: Text collation Date: Wed, 25 Oct 2006 19:43:22 +0100 Message-ID: <87k62otewl.fsf@ossau.uklinux.net> References: <877j00cirs.fsf@laas.fr> <87hcz3mqhr.fsf@zip.com.au> <87r6x0qjyy.fsf@laas.fr> <877iyrbxj7.fsf@raven.defaultvalue.org> <87wt6rxy6z.fsf@laas.fr> <87ac3m2joj.fsf@raven.defaultvalue.org> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: sea.gmane.org 1161801895 11121 80.91.229.2 (25 Oct 2006 18:44:55 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 25 Oct 2006 18:44:55 +0000 (UTC) Cc: Guile-Devel Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Wed Oct 25 20:44:52 2006 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1Gcnjp-0007g0-HL for guile-devel@m.gmane.org; Wed, 25 Oct 2006 20:44:29 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Gcnjp-0005lj-1B for guile-devel@m.gmane.org; Wed, 25 Oct 2006 14:44:29 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Gcnjb-0005hP-Tc for guile-devel@gnu.org; Wed, 25 Oct 2006 14:44:15 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Gcnjb-0005h6-B3 for guile-devel@gnu.org; Wed, 25 Oct 2006 14:44:15 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Gcnjb-0005h1-4b for guile-devel@gnu.org; Wed, 25 Oct 2006 14:44:15 -0400 Original-Received: from [80.84.72.33] (helo=mail3.uklinux.net) by monty-python.gnu.org with esmtp (Exim 4.52) id 1Gcnjb-0001jR-4D for guile-devel@gnu.org; Wed, 25 Oct 2006 14:44:15 -0400 Original-Received: from laruns (host86-145-51-69.range86-145.btcentralplus.com [86.145.51.69]) by mail3.uklinux.net (Postfix) with ESMTP id 3CA0040A97D; Wed, 25 Oct 2006 18:44:14 +0000 (UTC) Original-Received: from laruns (laruns [127.0.0.1]) by laruns (Postfix) with ESMTP id 198EF6F773; Wed, 25 Oct 2006 19:43:22 +0100 (BST) Original-To: Rob Browning In-Reply-To: <87ac3m2joj.fsf@raven.defaultvalue.org> (Rob Browning's message of "Tue, 24 Oct 2006 01:37:48 -0700") User-Agent: Gnus/5.1007 (Gnus v5.10.7) Emacs/21.4 (gnu/linux) X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:6180 Archived-At: Rob Browning writes: > ludovic.courtes@laas.fr (Ludovic Court=E8s) 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. Regards, Neil _______________________________________________ Guile-devel mailing list Guile-devel@gnu.org http://lists.gnu.org/mailman/listinfo/guile-devel