From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Noah Lavine Newsgroups: gmane.lisp.guile.devel Subject: Do you recognize these modules? Date: Tue, 1 May 2012 18:26:28 -0400 Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 X-Trace: dough.gmane.org 1335911199 8727 80.91.229.3 (1 May 2012 22:26:39 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 1 May 2012 22:26:39 +0000 (UTC) To: guile-devel Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Wed May 02 00:26:38 2012 Return-path: Envelope-to: guile-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1SPLWm-00070j-PU for guile-devel@m.gmane.org; Wed, 02 May 2012 00:26:36 +0200 Original-Received: from localhost ([::1]:60099 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SPLWm-0003iy-5a for guile-devel@m.gmane.org; Tue, 01 May 2012 18:26:36 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:55839) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SPLWi-0003iW-Rf for guile-devel@gnu.org; Tue, 01 May 2012 18:26:34 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SPLWg-0004EB-Vb for guile-devel@gnu.org; Tue, 01 May 2012 18:26:32 -0400 Original-Received: from mail-yw0-f41.google.com ([209.85.213.41]:33463) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SPLWg-0004E2-Oz for guile-devel@gnu.org; Tue, 01 May 2012 18:26:30 -0400 Original-Received: by yhr47 with SMTP id 47so25298yhr.0 for ; Tue, 01 May 2012 15:26:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:date:x-google-sender-auth:message-id:subject :from:to:content-type; bh=yAj14EO+AFImQhJoF/mkJefS0i+qe5AWkTomuI6IyHk=; b=AVa5X2F6px+d6yDsWlACUHPKKBKj3sJMNHdCkta2ySnkSjScD2todZdISBzy2qSBE9 IjoNID+7T7a1QWX+4nbjRm9hjvG+Pe/s9q3jAmQCBZ91uBgEXy2UG04rFzLU/0sjtizv QTJ/dOXzIt0Ysrk7oMikUqat30UYzc7RFa9sWqnfhWOyMNwuCJJzF32128CtG6DUrLAH 2efiIBiEwSKgiTA1D4dIoahn5i22qzXZHat1iqcW4gdQWD+MirHYNEdoRZwqMBpqU9fU Kyr6ddt9vfHctWTT8b0V4IRRn9TR18eySXLHrLkPZA30cvkb8NldCs7ab/9Z0s8OjHAl O+Iw== Original-Received: by 10.50.163.69 with SMTP id yg5mr3161234igb.56.1335911188823; Tue, 01 May 2012 15:26:28 -0700 (PDT) Original-Received: by 10.42.29.200 with HTTP; Tue, 1 May 2012 15:26:28 -0700 (PDT) X-Google-Sender-Auth: v1OsOZEdzoX_RREp7QDeHaAirRY X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 209.85.213.41 X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Original-Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.devel:14326 Archived-At: Hello all, I was inspired by a recent post about (ice-9 occam-channel) to take a look and see what modules don't have documentation. I've only looked at the (ice-9 ...) modules so far, but there are a lot of them. (I checked for documentation by going to the top-level info node for Guile documentation in Emacs and searching the manual for any mention of the module.) I am happy to add documentation for some of these modules, but I'd like to ask first to see if anyone on this list knows what they do. I think this is also the time to ask if we want to remove some of these modules instead of documenting them (especially (ice-9 lineio)). One nice thing I learned in this project is that Guile has a lot of cool data structures and algorithms built in. I think it would be great if they were discoverable too. Here are some notes I made as I went through ice-9/*.scm. Does anyone know anything about these modules? (ice-9 and-let-star) not documented (but also available as srfi-2?) (ice-9 binary-ports) not really documented except by brief mention under "R6RS I/O Ports" (ice-9 calling) not documented at all. (ice-9 channel) not documented at all. (ice-9 command-line) not documented at all. (ice-9 common-list) not documented at all. (ice-9 control): shift* and reset* need documentation. (ice-9 documentation) not documented at all. (ice-9 expect): all but expect and expect-strings need documentation. (ice-9 gap-buffer) not documented at all. is this module related to Elisp support? (ice-9 hcons) not documented at all. (ice-9 lineio) not documented at all. but a comment in that module says that it should be removed eventually. maybe the time is now? (ice-9 list) not documented at all. (ice-9 ls) not documented at all. (ice-9 mapping) not documented at all. (ice-9 match): everything except match needs documentation. (ice-9 null) not documented at all. but maybe it's not supposed to be. (ice-9 occam-channel) not documented at all. (ice-9 poe) not documented at all. (ice-9 poll) not documented at all. (ice-9 popen): port/pid-table needs documentation. (ice-9 runq): not documented at all. (ice-9 safe-r5rs): not documented at all. (ice-9 safe): not documented at all. (ice-9 save-stack): not documented at all. (ice-9 scm-style-repl): not documented at all. (ice-9 serialize): not documented at all. (ice-9 session): not documented at all. (ice-9 stack-catch): not documented at all. (ice-9 string-fun): not documented at all. (ice-9 threads): the *par* procedures need documentation. (ice-9 time): not documented at all. (ice-9 top-repl): not documented at all. (ice-9 weak-vector): not documented at all. Thanks, Noah