ae1e2b337e30

Export `invoke-...`
[view raw] [browse files]
author Steve Losh <steve@stevelosh.com>
date Fri, 03 Nov 2017 21:14:55 -0400
parents acbc94b1fbe7
children 25f05d94b336
branches/tags (none)
files docs/03-reference.markdown package.lisp

Changes

--- a/docs/03-reference.markdown	Fri Nov 03 21:12:09 2017 -0400
+++ b/docs/03-reference.markdown	Fri Nov 03 21:14:55 2017 -0400
@@ -192,6 +192,48 @@
 
   
 
+### `INVOKE-GENERATE` (function)
+
+    (INVOKE-GENERATE EXPRESSION)
+
+Generate a single Chancery expression.
+
+  THIS FUNCTION IS EXPERIMENTAL AND SUBJECT TO CHANGE IN THE FUTURE.
+
+  Because this is a function, not a macro, you'll need to do the quoting
+  yourself:
+
+    (define-rule x 1 2 3)
+
+    (generate (x x x))
+    ; => (1 3 3)
+
+    (invoke-generate '(x x x))
+    ; => (2 1 2)
+
+  
+
+### `INVOKE-GENERATE-STRING` (function)
+
+    (INVOKE-GENERATE-STRING EXPRESSION)
+
+Generate and stringify a single Chancery expression.
+
+  THIS FUNCTION IS EXPERIMENTAL AND SUBJECT TO CHANGE IN THE FUTURE.
+
+  Because this is a function, not a macro, you'll need to do the quoting
+  yourself:
+
+    (define-string x 1 2 3)
+
+    (generate-string (x x x))
+    ; => "1 3 3"
+
+    (invoke-generate-string '(x x x))
+    ; => "2 1 2"
+
+  
+
 ### `POS` (function)
 
     (POS STRING)
--- a/package.lisp	Fri Nov 03 21:12:09 2017 -0400
+++ b/package.lisp	Fri Nov 03 21:14:55 2017 -0400
@@ -10,6 +10,9 @@
     :generate
     :generate-string
 
+    :invoke-generate
+    :invoke-generate-string
+
     :quote
     :eval
     :list