diff options
author | Andy Wingo <wingo@pobox.com> | 2013-01-21 11:16:29 +0100 |
---|---|---|
committer | Andy Wingo <wingo@pobox.com> | 2013-01-22 15:17:50 +0100 |
commit | a6bd32406d952689494124de56b2d4de7cafac98 (patch) | |
tree | 961f307d6bd9da883891764ad2f2458f75f7aa00 /doc/ref/api-scheduling.texi | |
parent | 5a35d42aa5be26f1048fceea9acfa21bc9f6bc3e (diff) | |
download | guile-a6bd32406d952689494124de56b2d4de7cafac98.tar.gz |
add fluid->parameter
* module/ice-9/boot-9.scm (make-parameter): Add a docstring.
(fluid->parameter): New interface. Use it when turning port fluids
into parameters.
* doc/ref/api-scheduling.texi (Parameters): Deffn instead of defun for
make-parameter documentation. Add docs for fluid->parameter.
Diffstat (limited to 'doc/ref/api-scheduling.texi')
-rw-r--r-- | doc/ref/api-scheduling.texi | 21 |
1 files changed, 18 insertions, 3 deletions
diff --git a/doc/ref/api-scheduling.texi b/doc/ref/api-scheduling.texi index 9c2b4132a..749583a1b 100644 --- a/doc/ref/api-scheduling.texi +++ b/doc/ref/api-scheduling.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Guile Reference Manual. -@c Copyright (C) 1996, 1997, 2000, 2001, 2002, 2003, 2004, 2007, 2009, 2010, 2012 +@c Copyright (C) 1996, 1997, 2000, 2001, 2002, 2003, 2004, 2007, 2009, 2010, 2012, 2013 @c Free Software Foundation, Inc. @c See the file guile.texi for copying conditions. @@ -869,7 +869,7 @@ through several layers of calls before reaching the point they should affect. And introducing a new setting to existing code is often easier with a parameter object than adding arguments. -@defun make-parameter init [converter] +@deffn {Scheme Procedure} make-parameter init [converter] Return a new parameter object, with initial value @var{init}. If a @var{converter} is given, then a call @code{(@var{converter} @@ -888,7 +888,7 @@ canonical form. For example, (my-param 0.75) (my-param) @result{} 3/4 @end example -@end defun +@end deffn @deffn {library syntax} parameterize ((param value) @dots{}) body1 body2 @dots{} Establish a new dynamic scope with the given @var{param}s bound to new @@ -926,6 +926,21 @@ locations. That includes the separate locations when outside any separate initial location in each dynamic state, all initialized to the given @var{init} value. +New code should probably just use parameters instead of fluids, because +the interface is better. But for migrating old code or otherwise +providing interoperability, Guile provides the @code{fluid->parameter} +procedure: + +@deffn {Scheme Procedure} fluid->parameter fluid [conv] +Make a parameter that wraps a fluid. + +The value of the parameter will be the same as the value of the fluid. +If the parameter is rebound in some dynamic extent, perhaps via +@code{parameterize}, the new value will be run through the optional +@var{conv} procedure, as with any parameter. Note that unlike +@code{make-parameter}, @var{conv} is not applied to the initial value. +@end deffn + As alluded to above, because each thread usually has a separate dynamic state, each thread has its own locations behind parameter objects, and changes in one thread are not visible to any other. When a new dynamic |