file layout: moving share/txr/stdlib to stdlib.

This affects run-time also. Txr installations where the
executable is not in directory ending in ${bindir}
will look for stdlib rather than share/txr/stdlib,
relative to the determined installation directory.

* txr.c (sysroot_init): If we detect relative to the short
name, or fall back on the program directory, use stdlib
rather than share/txr/stdlib as the stdlib_path.

* INSTALL: Update some installation notes not to refer to
share/txr/stdlib but stdlib.

* Makefile (STDLIB_SRCS): Refer to stdlib, not
share/txr/stdlib.
(clean): In unconfigured mode, remove the old share/txr/stdlib
entirely.  Remove .tlo files from stdlib.
(install): Install lib materials from stdlib.

* txr.1: Updated documentation under Deployment Directory Structure.

* share/txr/stdlib/{asm,awk,build,cadr}.tl:
Renamed to stdlib/{asm,awk,build,cadr}.tl.

* share/txr/stdlib/{compiler,conv,copy-file,debugger}.tl:
Renamed to stdlib/{compiler,conv,copy-file,debugger}.tl.

* share/txr/stdlib/{defset,doc-lookup,doc-syms,doloop}.tl:
Renamed to stdlib/{defset,doc-lookup,doc-syms,doloop}.tl.

* share/txr/stdlib/{each-prod,error,except,ffi}.tl:
Renamed to stdlib/{each-prod,error,except,ffi}.tl.

* share/txr/stdlib/{getopts,getput,hash,ifa}.tl:
Renamed to stdlib/{getopts,getput,hash,ifa}.tl.

* share/txr/stdlib/{keyparams,match,op,optimize}.tl:
Renamed to stdlib/{keyparams,match,op,optimize}.tl.

* share/txr/stdlib/{package,param,path-test,pic}.tl:
Renamed to stdlib/{package,param,path-test,pic}.tl.

* share/txr/stdlib/{place,pmac,quips,save-exe}.tl:
Renamed to stdlib/{place,pmac,quips,save-exe}.tl.

* share/txr/stdlib/{socket,stream-wrap,struct,tagbody}.tl:
Renamed to stdlib/{socket,stream-wrap,struct,tagbody}.tl.

* share/txr/stdlib/{termios,trace,txr-case,type}.tl:
Renamed to stdlib/{termios,trace,txr-case,type}.tl.

* share/txr/stdlib/{ver,vm-param,with-resources,with-stream}.tl:
Renamed to stdlib/{ver,vm-param,with-resources,with-stream}.tl.

* share/txr/stdlib/yield.tl: Renamed to stdlib/yield.tl.

* share/txr/stdlib/{txr-case,ver}.txr:
Renamed to stdlib/{txr-case,ver}.txr.

* gencadr.txr: Update to stdlib/place.tl.

* genman.txr: Update to stdlib/cadr.tl.

1 files changed, 118 insertions, 0 deletions

diff --git a/stdlib/yield.tl b/stdlib/yield.tl
new file mode 100644
index 00000000..866ab8fb
--- /dev/null
+++ b/stdlib/yield.tl
@@ -0,0 +1,118 @@
+;; Copyright 2015-2021
+;; Kaz Kylheku <kaz@kylheku.com>
+;; Vancouver, Canada
+;; All rights reserved.
+;;
+;; Redistribution and use in source and binary forms, with or without
+;; modification, are permitted provided that the following conditions are met:
+;;
+;; 1. Redistributions of source code must retain the above copyright notice, this
+;;    list of conditions and the following disclaimer.
+;;
+;; 2. Redistributions in binary form must reproduce the above copyright notice,
+;;    this list of conditions and the following disclaimer in the documentation
+;;    and/or other materials provided with the distribution.
+;;
+;; THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+;; ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+;; WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+;; DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+;; FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+;; DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+;; SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+;; CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+;; OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+;; OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+(defstruct (sys:yld-item val cont) nil val cont)
+
+(defstruct (sys:rcv-item val cont) nil val cont)
+
+(defun sys:obtain-impl (fun)
+  (finalize
+    (lambda (: resume-val)
+      (let ((yi (call fun resume-val)))
+        (while t
+          (cond
+            ((eq (typeof yi) 'sys:yld-item)
+             (call fun 'sys:cont-free)
+             (set fun yi.cont)
+             (return yi.val))
+            ((eq (typeof yi) 'sys:rcv-item)
+             (call fun 'sys:cont-free)
+             (set fun yi.cont)
+             (set yi (call fun resume-val)))
+            (t (return yi))))))
+    (lambda (cont)
+      (call cont 'sys:cont-poison))))
+
+(defmacro obtain (. body)
+  (let ((arg (gensym "arg")))
+    ^(sys:obtain-impl (lambda (,arg)
+                        (unless (eq ,arg 'sys:cont-free)
+                          ,*body)))))
+
+(defmacro obtain-block (name . body)
+  ^(obtain (block ,name ,*body)))
+
+(defmacro obtain* (. body)
+  (let ((arg (gensym "arg"))
+        (fun (gensym "fun")))
+    ^(let ((,fun (sys:obtain-impl (lambda (,arg)
+                                    (unless (eq ,arg 'sys:cont-free)
+                                      ,*body)))))
+       (call ,fun nil)
+       ,fun)))
+
+(defmacro obtain*-block (name . body)
+  ^(obtain* (block ,name ,*body)))
+
+(defmacro yield-from (:form ctx-form name : (form nil have-form-p))
+  (let ((cont-sym (gensym)))
+    ^(sys:capture-cont ',name
+                       (lambda (,cont-sym)
+                         (sys:abscond-from ,name
+                                           ,(if have-form-p
+                                              ^(new (sys:yld-item
+                                                      ,form ,cont-sym))
+                                              ^(new (sys:rcv-item
+                                                      nil ,cont-sym)))))
+                     ',ctx-form)))
+
+(defmacro yield (: (form nil have-form-p))
+  (if have-form-p
+    ^(yield-from nil ,form)
+    ^(yield-from nil)))
+
+(defmacro suspend (:form form name sym . body)
+  ^(sys:capture-cont ',name (lambda (,sym)
+                              (sys:abscond-from ,name (progn ,*body)))
+                     ',form))
+
+(defun hlet-expand (op raw-vis body)
+  (let* ((vis (mapcar [iffi atom list] raw-vis))
+         (nvars (len vis))
+         (syms [mapcar car vis])
+         (inits [mapcar cadr vis])
+         (letop (if (eq op 'hlet*) 'let* 'let))
+         (gens (mapcar (ret (gensym)) vis))
+         (vec (gensym))
+         (macs (mapcar (ret ^(,@1 (vecref ,vec ,@2)))
+                       syms (range 0)))
+         (inits (mapcar (ret ^(set (vecref ,vec ,@1) ,@2))
+                        (range 0) inits)))
+    (if (eq op 'hlet*)
+      ^(let* ((,vec (vector ,nvars)))
+         (symacrolet ,macs
+           ,*inits
+           ,*body))
+      ^(let* ((,vec (vector ,nvars)))
+         ,*inits
+         (symacrolet ,macs
+           ,*body)))))
+
+(defmacro hlet (var-inits . body)
+  (hlet-expand 'hlet var-inits body))
+
+(defmacro hlet* (var-inits . body)
+  (hlet-expand 'hlet* var-inits body))