doco scm_cons_star

doco scm_cons_star

[Kevin Ryde]

[-- Attachment #1: Type: text/plain, Size: 298 bytes --]

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.


[-- Attachment #2: scheme-compound.texi.cons-star.diff --]
[-- Type: text/plain, Size: 667 bytes --]

--- 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

[-- Attachment #3: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Guile-devel mailing list
Guile-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/guile-devel