From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: ludo@gnu.org (Ludovic =?iso-8859-1?Q?Court=E8s?=) Newsgroups: gmane.lisp.guile.bugs Subject: Re: 1.8.2 srfi-19 warns about current-time Date: Wed, 10 Oct 2007 18:10:07 +0200 Message-ID: <87sl4jx868.fsf@chbouib.org> References: <470906BE.9050207@wilsonjc.us> <878x6esuva.fsf@chbouib.org> <877ilxfpwd.fsf@chbouib.org> <87k5pw2dbb.fsf@chbouib.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1192036321 3576 80.91.229.12 (10 Oct 2007 17:12:01 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 10 Oct 2007 17:12:01 +0000 (UTC) To: bug-guile@gnu.org Original-X-From: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Wed Oct 10 19:12:00 2007 Return-path: Envelope-to: guile-bugs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1Iff68-0003Ey-4I for guile-bugs@m.gmane.org; Wed, 10 Oct 2007 19:11:52 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Iff62-00060h-3e for guile-bugs@m.gmane.org; Wed, 10 Oct 2007 13:11:46 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Iff5m-0005s5-LH for bug-guile@gnu.org; Wed, 10 Oct 2007 13:11:30 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Iff5k-0005qL-TI for bug-guile@gnu.org; Wed, 10 Oct 2007 13:11:30 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Iff5k-0005qD-N2 for bug-guile@gnu.org; Wed, 10 Oct 2007 13:11:28 -0400 Original-Received: from main.gmane.org ([80.91.229.2] helo=ciao.gmane.org) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Iff5k-0003vl-5U for bug-guile@gnu.org; Wed, 10 Oct 2007 13:11:28 -0400 Original-Received: from list by ciao.gmane.org with local (Exim 4.43) id 1IfeSC-0008KK-LL for bug-guile@gnu.org; Wed, 10 Oct 2007 16:30:36 +0000 Original-Received: from adh419.fdn.fr ([80.67.176.9]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 10 Oct 2007 16:30:36 +0000 Original-Received: from ludo by adh419.fdn.fr with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 10 Oct 2007 16:30:36 +0000 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 47 Original-X-Complaints-To: usenet@sea.gmane.org X-Gmane-NNTP-Posting-Host: adh419.fdn.fr X-URL: http://www.laas.fr/~lcourtes/ X-PGP-Key-ID: 0xEB1F5364 X-PGP-Key: http://www.laas.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 821D 815D 902A 7EAB 5CEE D120 7FBA 3D4F EB1F 5364 X-OS: i486-pc-linux-gnu User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.1 (gnu/linux) Cancel-Lock: sha1:fEjPhw+lipxNyGUiF1E8EkzvpTE= X-Detected-Kernel: Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: bug-guile@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GUILE, GNU's Ubiquitous Extension Language" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Errors-To: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.bugs:3621 Archived-At: Hi, Gregory Marton writes: > Can I help? I mean, presuming that the sentence above, or some > extension, is reasonable documentation? I get a sense that there is a > reluctance to document things because that entails a commitment to > supporting them in the future -- is that the issue here? Not really. I was planning to document part of the `module-' procedure but never did it. In case you want to do it, those worth documenting (IMO) are the following: module-define! module-defined? module-duplicates-handlers module-export! module-for-each module-map module-name module-public-interface module-re-export! module-ref module-remove! module-replace! module-reverse-lookup ;; with xref to the "Variables" node module-set! module-variable ;; with xref to the "Variables" node This would go under the "Module System Reflection" node. Feel free to contribute! :-) > Being new to the community, I don't have a sense of how this strange > library system called srfi works. SRFIs are a community standardization process among Scheme implementors and users: http://srfi.schemers.org/ Anyone can propose an SRFI, but you wouldn't amend an SRFI just to make such or such implementation happier. The idea is to provide APIs portable among implementations. In practice, they are often implemented as a layer above the implementation's own API for the same purpose. Thanks, Ludovic. _______________________________________________ Bug-guile mailing list Bug-guile@gnu.org http://lists.gnu.org/mailman/listinfo/bug-guile