From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Kevin Ryde Newsgroups: gmane.lisp.guile.devel Subject: doco list and friends Date: Thu, 10 Jul 2003 08:19:41 +1000 Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Message-ID: <877k6rs5qa.fsf@zip.com.au> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1057790529 14463 80.91.224.249 (9 Jul 2003 22:42:09 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Wed, 9 Jul 2003 22:42:09 +0000 (UTC) Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Thu Jul 10 00:42:05 2003 Return-path: Original-Received: from monty-python.gnu.org ([199.232.76.173]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 19aNdV-0003kg-00 for ; Thu, 10 Jul 2003 00:42:05 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.20) id 19aNVU-0005jl-8z for guile-devel@m.gmane.org; Wed, 09 Jul 2003 18:33:48 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.20) id 19aNUf-0005M8-IJ for guile-devel@gnu.org; Wed, 09 Jul 2003 18:32:57 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.20) id 19aNOh-0001wC-FU for guile-devel@gnu.org; Wed, 09 Jul 2003 18:26:47 -0400 Original-Received: from snoopy.pacific.net.au ([61.8.0.36]) by monty-python.gnu.org with esmtp (Exim 4.20) id 19aNI8-0005c0-23 for guile-devel@gnu.org; Wed, 09 Jul 2003 18:20:00 -0400 Original-Received: from sunny.pacific.net.au (sunny.pacific.net.au [203.2.228.40]) by snoopy.pacific.net.au (8.12.3/8.12.3/Debian-6.3) with ESMTP id h69MJsZY030966 for ; Thu, 10 Jul 2003 08:19:54 +1000 Original-Received: from wisma.pacific.net.au (wisma.pacific.net.au [210.23.129.72]) by sunny.pacific.net.au with ESMTP id h69MJrQg022500 for ; Thu, 10 Jul 2003 08:19:53 +1000 (EST) Original-Received: from localhost (ppp84.dyn228.pacific.net.au [203.143.228.84]) by wisma.pacific.net.au (8.12.9/8.12.9) with ESMTP id h69MJqnh021923 for ; Thu, 10 Jul 2003 08:19:52 +1000 (EST) Original-Received: from gg by localhost with local (Exim 3.35 #1 (Debian)) id 19aNHq-00013B-00; Thu, 10 Jul 2003 08:19:42 +1000 Original-To: guile-devel@gnu.org Mail-Copies-To: never User-Agent: Gnus/5.090019 (Oort Gnus v0.19) Emacs/21.2 (gnu/linux) X-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.2 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 Xref: main.gmane.org gmane.lisp.guile.devel:2612 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.devel:2612 * scheme-compound.texi (List Constructors): In "list", reword for clarity. Add scm_list_1, scm_list_2, scm_list_3, scm_list_4, scm_list_5, scm_list_n. Remove scm_list, since it's a no-op. I think it's clearer to write something like "elem1 ... elemN" than ". objs". The latter will be fine for experienced programmers but I think newcomers would find a "..." style better. I take it scm_list_n is the replacement for gh_list and hence ought to be described. Should the rest be documented too? Plain scm_list seems a bit useless, since it does nothing but return the list you must create yourself to call it. I think it could be quietly dropped. - Scheme Procedure: list elem1 ... elemN - C Function: scm_list_1 (elem1) - C Function: scm_list_2 (elem1, elem2) - C Function: scm_list_3 (elem1, elem2, elem3) - C Function: scm_list_4 (elem1, elem2, elem3, elem4) - C Function: scm_list_5 (elem1, elem2, elem3, elem4, elem5) - C Function: scm_list_n (elem1, ..., elemN, SCM_UNDEFINED) Return a new list containing elements ELEM1 to ELEMN. `scm_list_n' takes a variable number of arguments, terminated by `SCM_UNDEFINED'. That final `SCM_UNDEFINED' is not included in the list. (Note that none of ELEM1 to ELEMN can themselves be `SCM_UNDEFINED', or `scm_list_n' will terminate at that point.) _______________________________________________ Guile-devel mailing list Guile-devel@gnu.org http://mail.gnu.org/mailman/listinfo/guile-devel