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, 88 insertions, 0 deletions

diff --git a/stdlib/except.tl b/stdlib/except.tl
new file mode 100644
index 00000000..60f2fe51
--- /dev/null
+++ b/stdlib/except.tl
@@ -0,0 +1,88 @@
+;; 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.
+
+(defun sys:handle-bad-syntax (item)
+  (throwf 'eval-error "~s: bad clause syntax: ~s" 'handle item))
+
+(defmacro usr:catch (:form form :env e try-form . catch-clauses)
+  (let ((catch-syms [mapcar car catch-clauses])
+        (sys-catch-clauses (mapcar (do mac-param-bind @1 (type args . body) @1
+                                     (tree-bind (args-ex . body-ex)
+                                                (sys:expand-params args body
+                                                                   e nil form)
+                                       ^(,type (,(gensym) ,*args-ex) ,*body-ex)))
+                                   catch-clauses)))
+    ^(sys:catch ,catch-syms ,try-form nil ,*sys-catch-clauses)))
+
+(defmacro catch* (try-form . catch-clauses)
+  (let ((catch-syms [mapcar car catch-clauses]))
+    ^(sys:catch ,catch-syms ,try-form nil ,*catch-clauses)))
+
+(defmacro catch** (:env menv try-form . catch-clauses)
+  (let ((catch-syms [mapcar car catch-clauses])
+        sys-catch-clauses descs)
+    (each ((cl catch-clauses))
+      (mac-param-bind cl (type desc args . body) cl
+        (push ^(,type ,args ,*body) sys-catch-clauses)
+        (push desc descs)))
+    (sys:setq sys-catch-clauses (nreverse sys-catch-clauses))
+    (sys:setq descs (nreverse descs))
+    (let ((desc-expr (if [all descs (op constantp @1 menv)]
+                       ^'(,*[mapcar eval descs])
+                       ^(list ,*descs))))
+      ^(sys:catch ,catch-syms ,try-form ,desc-expr ,*sys-catch-clauses))))
+
+(defun sys:expand-handle (form try-form handle-clauses)
+  (let* ((oper (car form))
+         (exc-sym (gensym))
+         (exc-args (gensym))
+         (syms-fragments (collect-each ((hc handle-clauses))
+                          (tree-case hc
+                            ((name arglist . body)
+                             (unless (symbolp name)
+                               (sys:handle-bad-syntax hc))
+                             (list name ^(apply (lambda ,arglist ,*body)
+                                                ,*(if (or (eq oper 'handle*)
+                                                          (and (plusp sys:compat)
+                                                               (<= 161 sys:compat)))
+                                                    ^(,exc-sym))
+                                                ,exc-args)))
+                            (else (sys:handle-bad-syntax hc))))))
+    ^(handler-bind (lambda (,exc-sym . ,exc-args)
+                     (cond
+                       ,*(mapcar (aret ^((exception-subtype-p ,exc-sym ',@1) ,@2))
+                                 syms-fragments)))
+                   ,[mapcar car syms-fragments]
+                   ,try-form)))
+
+(defmacro handle (:form form try-form . handle-clauses)
+  (sys:expand-handle form try-form handle-clauses))
+
+(defmacro handle* (:form form try-form . handle-clauses)
+  (sys:expand-handle form try-form handle-clauses))
+
+(defmacro ignwarn (. forms)
+  ^(handler-bind (lambda (exc-sym . args) (throw 'continue)) (warning) ,*forms))