(Symbol Primitives): In gensym, cross reference
authorKevin Ryde <user42@zip.com.au>
Tue, 2 Sep 2003 23:57:49 +0000 (23:57 +0000)
committerKevin Ryde <user42@zip.com.au>
Tue, 2 Sep 2003 23:57:49 +0000 (23:57 +0000)
uninterned symbols, use @w{} on " g" prefix to avoid any chance of a
line break obscuring it.

doc/ref/scheme-data.texi

index 03ad950..7fa4ac6 100755 (executable)
@@ -2743,15 +2743,16 @@ code.  The @code{gensym} primitive meets this need:
 @deffnx {C Function} scm_gensym (prefix)
 Create a new symbol with a name constructed from a prefix and a counter
 value.  The string @var{prefix} can be specified as an optional
-argument.  Default prefix is @samp{ g}.  The counter is increased by 1
+argument.  Default prefix is @samp{@w{ g}}.  The counter is increased by 1
 at each call.  There is no provision for resetting the counter.
 @end deffn
 
 The symbols generated by @code{gensym} are @emph{likely} to be unique,
 since their names begin with a space and it is only otherwise possible
 to generate such symbols if a programmer goes out of their way to do
-so.  The 1.8 release of Guile will include a way of creating
-symbols that are @emph{guaranteed} to be unique.
+so.  Uniqueness can be guaranteed by instead using uninterned symbols
+(@pxref{Symbol Uninterned}), though they can't be usefully written out
+and read back in.
 
 
 @node Symbol Props