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 scm_cons_star Date: Fri, 18 Jul 2003 09:23:57 +1000 Sender: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Message-ID: <8765m03fg2.fsf@zip.com.au> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Trace: main.gmane.org 1058484411 15743 80.91.224.249 (17 Jul 2003 23:26:51 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Thu, 17 Jul 2003 23:26:51 +0000 (UTC) Original-X-From: guile-devel-bounces+guile-devel=m.gmane.org@gnu.org Fri Jul 18 01:26:48 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 19dI99-00045b-00 for ; Fri, 18 Jul 2003 01:26:47 +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 19dI9v-0002xq-UI for guile-devel@m.gmane.org; Thu, 17 Jul 2003 19:27:35 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.20) id 19dI8k-0002bX-7q for guile-devel@gnu.org; Thu, 17 Jul 2003 19:26:22 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.20) id 19dI7x-0001fc-Q0 for guile-devel@gnu.org; Thu, 17 Jul 2003 19:25:34 -0400 Original-Received: from snoopy.pacific.net.au ([61.8.0.36]) by monty-python.gnu.org with esmtp (Exim 4.20) id 19dI7W-0001aF-7q for guile-devel@gnu.org; Thu, 17 Jul 2003 19:25:06 -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 h6HNP2ZY021885 for ; Fri, 18 Jul 2003 09:25:02 +1000 Original-Received: from wisma.pacific.net.au (wisma.pacific.net.au [210.23.129.72]) by sunny.pacific.net.au with ESMTP id h6HNP2Qg022533 for ; Fri, 18 Jul 2003 09:25:02 +1000 (EST) Original-Received: from localhost (ppp74.dyn228.pacific.net.au [203.143.228.74]) by wisma.pacific.net.au (8.12.9/8.12.9) with ESMTP id h6HNOhnh004076 for ; Fri, 18 Jul 2003 09:24:52 +1000 (EST) Original-Received: from gg by localhost with local (Exim 3.35 #1 (Debian)) id 19dI6Q-0001sU-00; Fri, 18 Jul 2003 09:23:58 +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:2627 X-Report-Spam: http://spam.gmane.org/gmane.lisp.guile.devel:2627 --=-=-= It strikes me that scm_cons_star doesn't do much good for a C program, in the way it expects the caller to have done the consing already. I think it could be quietly dropped from the documentation. * scheme-compound.texi (List Constructors): Remove scm_cons_star, since it's not very helpful. --=-=-= Content-Disposition: attachment; filename=scheme-compound.texi.cons-star.diff --- scheme-compound.texi.~1.9.~ 2003-06-05 01:29:27.000000000 +1000 +++ scheme-compound.texi 2003-07-17 09:29:40.000000000 +1000 @@ -239,8 +239,11 @@ @code{list}. @end deffn +@c C Function scm_cons_star(arg1,rest) used to be documented here, +@c but it's not really a useful interface, since it expects the +@c caller to have already consed up all but the first argument. +@c @deffn {Scheme Procedure} cons* arg1 arg2 @dots{} -@deffnx {C Function} scm_cons_star (arg1, rest) Like @code{list}, but the last arg provides the tail of the constructed list, returning @code{(cons @var{arg1} (cons @var{arg2} (cons @dots{} @var{argn})))}. Requires at least one --=-=-= Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Guile-devel mailing list Guile-devel@gnu.org http://mail.gnu.org/mailman/listinfo/guile-devel --=-=-=--