1.1.13: will be tagged as "sbcl-1.1.13"
[sbcl.git] / src / compiler / ir1tran.lisp
index 6d578ad..b2bd2e7 100644 (file)
 
 (declaim (special *compiler-error-bailout*))
 
+;;; *CURRENT-FORM-NUMBER* is used in FIND-SOURCE-PATHS to compute the
+;;; form number to associate with a source path. This should be bound
+;;; to an initial value of 0 before the processing of each truly
+;;; top level form.
+(declaim (type index *current-form-number*))
+(defvar *current-form-number*)
+
 ;;; *SOURCE-PATHS* is a hashtable from source code forms to the path
 ;;; taken through the source to reach the form. This provides a way to
 ;;; keep track of the location of original source forms, even when
 ;;; macroexpansions and other arbitary permutations of the code
-;;; happen. This table is initialized by calling Find-Source-Paths on
+;;; happen. This table is initialized by calling FIND-SOURCE-PATHS on
 ;;; the original source.
+;;;
+;;; It is fairly useless to store symbols, characters, or fixnums in
+;;; this table, as 42 is EQ to 42 no matter where in the source it
+;;; appears. GET-SOURCE-PATH and NOTE-SOURCE-PATH functions should be
+;;; always used to access this table.
 (declaim (hash-table *source-paths*))
 (defvar *source-paths*)
 
-;;; *CURRENT-COMPONENT* is the Component structure which we link
+(declaim (inline source-form-has-path-p))
+(defun source-form-has-path-p (form)
+  (not (typep form '(or symbol fixnum character))))
+
+(defun get-source-path (form)
+  (when (source-form-has-path-p form)
+    (gethash form *source-paths*)))
+
+(defun ensure-source-path (form)
+  (or (get-source-path form)
+      (cons (simplify-source-path-form form)
+            *current-path*)))
+
+(defun simplify-source-path-form (form)
+  (if (consp form)
+      (let ((op (car form)))
+        ;; In the compiler functions can be directly represented
+        ;; by leaves. Having leaves in the source path is pretty
+        ;; hard on the poor user, however, so replace with the
+        ;; source-name when possible.
+        (if (and (leaf-p op) (leaf-has-source-name-p op))
+            (cons (leaf-source-name op) (cdr form))
+            form))
+      form))
+
+(defun note-source-path (form &rest arguments)
+  (when (source-form-has-path-p form)
+    (setf (gethash form *source-paths*)
+          (apply #'list* 'original-source-start *current-form-number* arguments))))
+
+;;; *CURRENT-COMPONENT* is the COMPONENT structure which we link
 ;;; blocks into as we generate them. This just serves to glue the
 ;;; emitted blocks together until local call analysis and flow graph
 ;;; canonicalization figure out what is really going on. We need to
 ;;; FIXME: It's confusing having one variable named *CURRENT-COMPONENT*
 ;;; and another named *COMPONENT-BEING-COMPILED*. (In CMU CL they
 ;;; were called *CURRENT-COMPONENT* and *COMPILE-COMPONENT* respectively,
-;;; which also confusing.)
+;;; which was also confusing.)
 (declaim (type (or component null) *current-component*))
 (defvar *current-component*)
 
 ;;; *CURRENT-PATH* is the source path of the form we are currently
 ;;; translating. See NODE-SOURCE-PATH in the NODE structure.
 (declaim (list *current-path*))
-(defvar *current-path* nil)
-
-;;; *CONVERTING-FOR-INTERPRETER* is true when we are creating IR1 to
-;;; be interpreted rather than compiled. This inhibits source
-;;; tranformations and stuff.
-(defvar *converting-for-interpreter* nil)
-;;; FIXME: Rename to *IR1-FOR-INTERPRETER-NOT-COMPILER-P*.
-
-;;; FIXME: This nastiness was one of my original motivations to start
-;;; hacking CMU CL. The non-ANSI behavior can be useful, but it should
-;;; be made not the default, and perhaps should be controlled by
-;;; DECLAIM instead of a variable like this. And whether or not this
-;;; kind of checking is on, declarations should be assertions to the
-;;; extent practical, and code which can't be compiled efficiently
-;;; while adhering to that principle should give warnings.
-(defvar *derive-function-types* t
-  #!+sb-doc
-  "(Caution: Soon, this might change its semantics somewhat, or even go away.)
-  If true, argument and result type information derived from compilation of
-  DEFUNs is used when compiling calls to that function. If false, only
-  information from FTYPE proclamations will be used.")
+(defvar *current-path*)
+
+(defvar *derive-function-types* nil
+  "Should the compiler assume that function types will never change,
+  so that it can use type information inferred from current definitions
+  to optimize code which uses those definitions? Setting this true
+  gives non-ANSI, early-CMU-CL behavior. It can be useful for improving
+  the efficiency of stable code.")
+
+(defvar *fun-names-in-this-file* nil)
+
+(defvar *post-binding-variable-lexenv* nil)
 \f
 ;;;; namespace management utilities
 
+(defun fun-lexically-notinline-p (name)
+  (let ((fun (lexenv-find name funs :test #'equal)))
+    ;; a declaration will trump a proclamation
+    (if (and fun (defined-fun-p fun))
+        (eq (defined-fun-inlinep fun) :notinline)
+        (eq (info :function :inlinep name) :notinline))))
+
+;; This will get redefined in PCL boot.
+(declaim (notinline maybe-update-info-for-gf))
+(defun maybe-update-info-for-gf (name)
+  (declare (ignore name))
+  nil)
+
+(defun maybe-defined-here (name where)
+  (if (and (eq :defined where)
+           (member name *fun-names-in-this-file* :test #'equal))
+      :defined-here
+      where))
+
 ;;; Return a GLOBAL-VAR structure usable for referencing the global
 ;;; function NAME.
-(defun find-free-really-function (name)
+(defun find-global-fun (name latep)
   (unless (info :function :kind name)
     (setf (info :function :kind name) :function)
     (setf (info :function :where-from name) :assumed))
-
   (let ((where (info :function :where-from name)))
-    (when (eq where :assumed)
+    (when (and (eq where :assumed)
+               ;; In the ordinary target Lisp, it's silly to report
+               ;; undefinedness when the function is defined in the
+               ;; running Lisp. But at cross-compile time, the current
+               ;; definedness of a function is irrelevant to the
+               ;; definedness at runtime, which is what matters.
+               #-sb-xc-host (not (fboundp name))
+               ;; LATEP is true when the user has indicated that
+               ;; late-late binding is desired by using eg. a quoted
+               ;; symbol -- in which case it makes little sense to
+               ;; complain about undefined functions.
+               (not latep))
       (note-undefined-reference name :function))
-    (make-global-var :kind :global-function
-                    :name name
-                    :type (if (or *derive-function-types*
-                                  (eq where :declared))
-                              (info :function :type name)
-                              (specifier-type 'function))
-                    :where-from where)))
-
-;;; Return a SLOT-ACCESSOR structure usable for referencing the slot
-;;; accessor NAME. CLASS is the structure class.
-(defun find-structure-slot-accessor (class name)
-  (declare (type sb!xc:class class))
-  (let* ((info (layout-info
-               (or (info :type :compiler-layout (sb!xc:class-name class))
-                   (class-layout class))))
-        (accessor (if (listp name) (cadr name) name))
-        (slot (find accessor (dd-slots info) :key #'sb!kernel:dsd-accessor))
-        (type (dd-name info))
-        (slot-type (dsd-type slot)))
-    (assert slot () "Can't find slot ~S." type)
-    (make-slot-accessor
-     :name name
-     :type (specifier-type
-           (if (listp name)
-               `(function (,slot-type ,type) ,slot-type)
-               `(function (,type) ,slot-type)))
-     :for class
-     :slot slot)))
-
-;;; If NAME is already entered in *FREE-FUNCTIONS*, then return the
-;;; value. Otherwise, make a new GLOBAL-VAR using information from the
-;;; global environment and enter it in *FREE-FUNCTIONS*. If NAME names
-;;; a macro or special form, then we error out using the supplied
-;;; context which indicates what we were trying to do that demanded a
-;;; function.
-(defun find-free-function (name context)
-  (declare (string context))
-  (declare (values global-var))
-  (or (gethash name *free-functions*)
+    (let ((ftype (info :function :type name))
+          (notinline (fun-lexically-notinline-p name)))
+      (make-global-var
+       :kind :global-function
+       :%source-name name
+       :type (if (or (eq where :declared)
+                     (and (not latep)
+                          (not notinline)
+                          *derive-function-types*))
+                 ftype
+                 (specifier-type 'function))
+       :defined-type (if (and (not latep) (not notinline))
+                         (or (maybe-update-info-for-gf name) ftype)
+                         (specifier-type 'function))
+       :where-from (if notinline
+                       where
+                       (maybe-defined-here name where))))))
+
+;;; Have some DEFINED-FUN-FUNCTIONALS of a *FREE-FUNS* entry become invalid?
+;;; Drop 'em.
+;;;
+;;; This was added to fix bug 138 in SBCL. It is possible for a *FREE-FUNS*
+;;; entry to contain a DEFINED-FUN whose DEFINED-FUN-FUNCTIONAL object
+;;; contained IR1 stuff (NODEs, BLOCKs...) referring to an already compiled
+;;; (aka "dead") component. When this IR1 stuff was reused in a new component,
+;;; under further obscure circumstances it could be used by
+;;; WITH-IR1-ENVIRONMENT-FROM-NODE to generate a binding for
+;;; *CURRENT-COMPONENT*. At that point things got all confused, since IR1
+;;; conversion was sending code to a component which had already been compiled
+;;; and would never be compiled again.
+;;;
+;;; Note: as of 1.0.24.41 this seems to happen only in XC, and the original
+;;; BUGS entry also makes it seem like this might not be an issue at all on
+;;; target.
+(defun clear-invalid-functionals (free-fun)
+  ;; There might be other reasons that *FREE-FUN* entries could
+  ;; become invalid, but the only one we've been bitten by so far
+  ;; (sbcl-0.pre7.118) is this one:
+  (when (defined-fun-p free-fun)
+    (setf (defined-fun-functionals free-fun)
+          (delete-if (lambda (functional)
+                       (or (eq (functional-kind functional) :deleted)
+                           (when (lambda-p functional)
+                             (or
+                              ;; (The main reason for this first test is to bail
+                              ;; out early in cases where the LAMBDA-COMPONENT
+                              ;; call in the second test would fail because links
+                              ;; it needs are uninitialized or invalid.)
+                              ;;
+                              ;; If the BIND node for this LAMBDA is null, then
+                              ;; according to the slot comments, the LAMBDA has
+                              ;; been deleted or its call has been deleted. In
+                              ;; that case, it seems rather questionable to reuse
+                              ;; it, and certainly it shouldn't be necessary to
+                              ;; reuse it, so we cheerfully declare it invalid.
+                              (not (lambda-bind functional))
+                              ;; If this IR1 stuff belongs to a dead component,
+                              ;; then we can't reuse it without getting into
+                              ;; bizarre confusion.
+                              (eq (component-info (lambda-component functional))
+                                  :dead)))))
+                     (defined-fun-functionals free-fun)))
+    nil))
+
+;;; If NAME already has a valid entry in *FREE-FUNS*, then return
+;;; the value. Otherwise, make a new GLOBAL-VAR using information from
+;;; the global environment and enter it in *FREE-FUNS*. If NAME
+;;; names a macro or special form, then we error out using the
+;;; supplied context which indicates what we were trying to do that
+;;; demanded a function.
+(declaim (ftype (sfunction (t string) global-var) find-free-fun))
+(defun find-free-fun (name context)
+  (or (let ((old-free-fun (gethash name *free-funs*)))
+        (when old-free-fun
+          (clear-invalid-functionals old-free-fun)
+          old-free-fun))
       (ecase (info :function :kind name)
-       ;; FIXME: The :MACRO and :SPECIAL-FORM cases could be merged.
-       (:macro
-        (compiler-error "The macro name ~S was found ~A." name context))
-       (:special-form
-        (compiler-error "The special form name ~S was found ~A."
-                        name
-                        context))
-       ((:function nil)
-        (check-function-name name)
-        (note-if-setf-function-and-macro name)
-        (let ((expansion (info :function :inline-expansion name))
-              (inlinep (info :function :inlinep name)))
-          (setf (gethash name *free-functions*)
-                (if (or expansion inlinep)
-                    (make-defined-function
-                     :name name
-                     :inline-expansion expansion
-                     :inlinep inlinep
-                     :where-from (info :function :where-from name)
-                     :type (info :function :type name))
-                    (let ((info (info :function :accessor-for name)))
-                      (etypecase info
-                        (null
-                         (find-free-really-function name))
-                        (sb!xc:structure-class
-                         (find-structure-slot-accessor info name))
-                        (sb!xc:class
-                         (if (typep (layout-info (info :type :compiler-layout
-                                                       (sb!xc:class-name
-                                                        info)))
-                                    'defstruct-description)
-                             (find-structure-slot-accessor info name)
-                             (find-free-really-function name))))))))))))
+        ;; FIXME: The :MACRO and :SPECIAL-FORM cases could be merged.
+        (:macro
+         (compiler-error "The macro name ~S was found ~A." name context))
+        (:special-form
+         (compiler-error "The special form name ~S was found ~A."
+                         name
+                         context))
+        ((:function nil)
+         (check-fun-name name)
+         (note-if-setf-fun-and-macro name)
+         (let ((expansion (fun-name-inline-expansion name))
+               (inlinep (info :function :inlinep name)))
+           (setf (gethash name *free-funs*)
+                 (if (or expansion inlinep)
+                     (let ((where (info :function :where-from name)))
+                       (make-defined-fun
+                        :%source-name name
+                        :inline-expansion expansion
+                        :inlinep inlinep
+                        :where-from (if (eq inlinep :notinline)
+                                        where
+                                        (maybe-defined-here name where))
+                        :type (if (and (eq inlinep :notinline)
+                                       (neq where :declared))
+                                  (specifier-type 'function)
+                                  (info :function :type name))))
+                     (find-global-fun name nil))))))))
 
 ;;; Return the LEAF structure for the lexically apparent function
 ;;; definition of NAME.
-(declaim (ftype (function (t string) leaf) find-lexically-apparent-function))
-(defun find-lexically-apparent-function (name context)
-  (let ((var (lexenv-find name functions :test #'equal)))
+(declaim (ftype (sfunction (t string) leaf) find-lexically-apparent-fun))
+(defun find-lexically-apparent-fun (name context)
+  (let ((var (lexenv-find name funs :test #'equal)))
     (cond (var
-          (unless (leaf-p var)
-            (assert (and (consp var) (eq (car var) 'macro)))
-            (compiler-error "found macro name ~S ~A" name context))
-          var)
-         (t
-          (find-free-function name context)))))
+           (unless (leaf-p var)
+             (aver (and (consp var) (eq (car var) 'macro)))
+             (compiler-error "found macro name ~S ~A" name context))
+           var)
+          (t
+           (find-free-fun name context)))))
+
+(defun maybe-find-free-var (name)
+  (gethash name *free-vars*))
 
 ;;; Return the LEAF node for a global variable reference to NAME. If
-;;; NAME is already entered in *FREE-VARIABLES*, then we just return
-;;; the corresponding value. Otherwise, we make a new leaf using
+;;; NAME is already entered in *FREE-VARS*, then we just return the
+;;; corresponding value. Otherwise, we make a new leaf using
 ;;; information from the global environment and enter it in
-;;; *FREE-VARIABLES*. If the variable is unknown, then we emit a
-;;; warning.
-(defun find-free-variable (name)
-  (declare (values (or leaf heap-alien-info)))
+;;; *FREE-VARS*. If the variable is unknown, then we emit a warning.
+(declaim (ftype (sfunction (t) (or leaf cons heap-alien-info)) find-free-var))
+(defun find-free-var (name)
   (unless (symbolp name)
     (compiler-error "Variable name is not a symbol: ~S." name))
-  (or (gethash name *free-variables*)
+  (or (gethash name *free-vars*)
       (let ((kind (info :variable :kind name))
-           (type (info :variable :type name))
-           (where-from (info :variable :where-from name)))
-       (when (and (eq where-from :assumed) (eq kind :global))
-         (note-undefined-reference name :variable))
-
-       (setf (gethash name *free-variables*)
-             (if (eq kind :alien)
-                 (info :variable :alien-info name)
-                 (multiple-value-bind (val valp)
-                     (info :variable :constant-value name)
-                   (if (and (eq kind :constant) valp)
-                       (make-constant :value val
-                                      :name name
-                                      :type (ctype-of val)
-                                      :where-from where-from)
-                       (make-global-var :kind kind
-                                        :name name
-                                        :type type
-                                        :where-from where-from))))))))
+            (type (info :variable :type name))
+            (where-from (info :variable :where-from name)))
+        (when (eq kind :unknown)
+          (note-undefined-reference name :variable))
+        (setf (gethash name *free-vars*)
+              (case kind
+                (:alien
+                 (info :variable :alien-info name))
+                ;; FIXME: The return value in this case should really be
+                ;; of type SB!C::LEAF.  I don't feel too badly about it,
+                ;; because the MACRO idiom is scattered throughout this
+                ;; file, but it should be cleaned up so we're not
+                ;; throwing random conses around.  --njf 2002-03-23
+                (:macro
+                 (let ((expansion (info :variable :macro-expansion name))
+                       (type (type-specifier (info :variable :type name))))
+                   `(macro . (the ,type ,expansion))))
+                (:constant
+                 (let ((value (symbol-value name)))
+                   ;; Override the values of standard symbols in XC,
+                   ;; since we can't redefine them.
+                   #+sb-xc-host
+                   (when (eql (find-symbol (symbol-name name) :cl) name)
+                     (multiple-value-bind (xc-value foundp)
+                         (info :variable :xc-constant-value name)
+                       (cond (foundp
+                              (setf value xc-value))
+                             ((not (eq value name))
+                              (compiler-warn
+                               "Using cross-compilation host's definition of ~S: ~A~%"
+                               name (symbol-value name))))))
+                   (find-constant value name)))
+                (t
+                 (make-global-var :kind kind
+                                  :%source-name name
+                                  :type type
+                                  :where-from where-from)))))))
 \f
 ;;; Grovel over CONSTANT checking for any sub-parts that need to be
 ;;; processed with MAKE-LOAD-FORM. We have to be careful, because
 ;;; CONSTANT might be circular. We also check that the constant (and
 ;;; any subparts) are dumpable at all.
-(eval-when (:compile-toplevel :load-toplevel :execute)
-  ;; The EVAL-WHEN is necessary for #.(1+ LIST-TO-HASH-TABLE-THRESHOLD) 
-  ;; below. -- AL 20010227
-  (defconstant list-to-hash-table-threshold 32))
-(defun maybe-emit-make-load-forms (constant)
-  (let ((things-processed nil)
-       (count 0))
-    ;; FIXME: Does this LIST-or-HASH-TABLE messiness give much benefit?
-    (declare (type (or list hash-table) things-processed)
-            (type (integer 0 #.(1+ list-to-hash-table-threshold)) count)
-            (inline member))
-    (labels ((grovel (value)
-              ;; Unless VALUE is an object which which obviously
-              ;; can't contain other objects
-              (unless (typep value
-                             '(or #-sb-xc-host unboxed-array
-                                  symbol
-                                  number
-                                  character
-                                  string))
-                (etypecase things-processed
-                  (list
-                   (when (member value things-processed :test #'eq)
-                     (return-from grovel nil))
-                   (push value things-processed)
-                   (incf count)
-                   (when (> count list-to-hash-table-threshold)
-                     (let ((things things-processed))
-                       (setf things-processed
-                             (make-hash-table :test 'eq))
-                       (dolist (thing things)
-                         (setf (gethash thing things-processed) t)))))
-                  (hash-table
-                   (when (gethash value things-processed)
-                     (return-from grovel nil))
-                   (setf (gethash value things-processed) t)))
-                (typecase value
-                  (cons
-                   (grovel (car value))
-                   (grovel (cdr value)))
-                  (simple-vector
-                   (dotimes (i (length value))
-                     (grovel (svref value i))))
-                  ((vector t)
-                   (dotimes (i (length value))
-                     (grovel (aref value i))))
-                  ((simple-array t)
-                   ;; Even though the (ARRAY T) branch does the exact
-                   ;; same thing as this branch we do this separately
-                   ;; so that the compiler can use faster versions of
-                   ;; array-total-size and row-major-aref.
-                   (dotimes (i (array-total-size value))
-                     (grovel (row-major-aref value i))))
-                  ((array t)
-                   (dotimes (i (array-total-size value))
-                     (grovel (row-major-aref value i))))
-                  (;; In the target SBCL, we can dump any instance,
-                   ;; but in the cross-compilation host,
-                   ;; %INSTANCE-FOO functions don't work on general
-                   ;; instances, only on STRUCTURE!OBJECTs.
-                   #+sb-xc-host structure!object
-                   #-sb-xc-host instance
-                   (when (emit-make-load-form value)
-                     (dotimes (i (%instance-length value))
-                       (grovel (%instance-ref value i)))))
-                  (t
-                   (compiler-error
-                    "Objects of type ~S can't be dumped into fasl files."
-                    (type-of value)))))))
-      (grovel constant)))
+(defun maybe-emit-make-load-forms (constant &optional (name nil namep))
+  (let ((xset (alloc-xset)))
+    (labels ((trivialp (value)
+               (typep value
+                      '(or
+                        #-sb-xc-host unboxed-array
+                        #+sb-xc-host (simple-array (unsigned-byte 8) (*))
+                        symbol
+                        number
+                        character
+                        string
+                        #!+sb-simd-pack
+                        #+sb-xc-host nil
+                        #-sb-xc-host sb!kernel:simd-pack)))
+             (grovel (value)
+               ;; Unless VALUE is an object which which obviously
+               ;; can't contain other objects
+               (unless (trivialp value)
+                 (if (xset-member-p value xset)
+                     (return-from grovel nil)
+                     (add-to-xset value xset))
+                 (typecase value
+                   (cons
+                    (grovel (car value))
+                    (grovel (cdr value)))
+                   (simple-vector
+                    (dotimes (i (length value))
+                      (grovel (svref value i))))
+                   ((vector t)
+                    (dotimes (i (length value))
+                      (grovel (aref value i))))
+                   ((simple-array t)
+                    ;; Even though the (ARRAY T) branch does the exact
+                    ;; same thing as this branch we do this separately
+                    ;; so that the compiler can use faster versions of
+                    ;; array-total-size and row-major-aref.
+                    (dotimes (i (array-total-size value))
+                      (grovel (row-major-aref value i))))
+                   ((array t)
+                    (dotimes (i (array-total-size value))
+                      (grovel (row-major-aref value i))))
+                   (#+sb-xc-host structure!object
+                    #-sb-xc-host instance
+                    ;; In the target SBCL, we can dump any instance, but
+                    ;; in the cross-compilation host, %INSTANCE-FOO
+                    ;; functions don't work on general instances, only on
+                    ;; STRUCTURE!OBJECTs.
+                    ;;
+                    ;; FIXME: What about funcallable instances with
+                    ;; user-defined MAKE-LOAD-FORM methods?
+                    (when (emit-make-load-form value)
+                      (dotimes (i (- (%instance-length value)
+                                     #+sb-xc-host 0
+                                     #-sb-xc-host (layout-n-untagged-slots
+                                                   (%instance-ref value 0))))
+                        (grovel (%instance-ref value i)))))
+                   (t
+                    (compiler-error
+                     "Objects of type ~S can't be dumped into fasl files."
+                     (type-of value)))))))
+      ;; Dump all non-trivial named constants using the name.
+      (if (and namep (not (typep constant '(or symbol character
+                                            ;; FIXME: Cold init breaks if we
+                                            ;; try to reference FP constants
+                                            ;; thru their names.
+                                            #+sb-xc-host number
+                                            #-sb-xc-host fixnum))))
+          (emit-make-load-form constant name)
+          (grovel constant))))
   (values))
 \f
 ;;;; some flow-graph hacking utilities
 
 ;;; This function sets up the back link between the node and the
-;;; continuation which continues at it.
-#!-sb-fluid (declaim (inline prev-link))
-(defun prev-link (node cont)
-  (declare (type node node) (type continuation cont))
-  (assert (not (continuation-next cont)))
-  (setf (continuation-next cont) node)
-  (setf (node-prev node) cont))
-
-;;; This function is used to set the continuation for a node, and thus
-;;; determine what receives the value and what is evaluated next. If
-;;; the continuation has no block, then we make it be in the block
-;;; that the node is in. If the continuation heads its block, we end
-;;; our block and link it to that block. If the continuation is not
-;;; currently used, then we set the derived-type for the continuation
-;;; to that of the node, so that a little type propagation gets done.
-;;;
-;;; We also deal with a bit of THE's semantics here: we weaken the
-;;; assertion on CONT to be no stronger than the assertion on CONT in
-;;; our scope. See the IR1-CONVERT method for THE.
-#!-sb-fluid (declaim (inline use-continuation))
-(defun use-continuation (node cont)
-  (declare (type node node) (type continuation cont))
-  (let ((node-block (continuation-block (node-prev node))))
-    (case (continuation-kind cont)
-      (:unused
-       (setf (continuation-block cont) node-block)
-       (setf (continuation-kind cont) :inside-block)
-       (setf (continuation-use cont) node)
-       (setf (node-cont node) cont))
-      (t
-       (%use-continuation node cont)))))
-(defun %use-continuation (node cont)
-  (declare (type node node) (type continuation cont) (inline member))
-  (let ((block (continuation-block cont))
-       (node-block (continuation-block (node-prev node))))
-    (assert (eq (continuation-kind cont) :block-start))
-    (assert (not (block-last node-block)) () "~S has already ended."
-           node-block)
+;;; ctran which continues at it.
+(defun link-node-to-previous-ctran (node ctran)
+  (declare (type node node) (type ctran ctran))
+  (aver (not (ctran-next ctran)))
+  (setf (ctran-next ctran) node)
+  (setf (node-prev node) ctran))
+
+;;; This function is used to set the ctran for a node, and thus
+;;; determine what is evaluated next. If the ctran has no block, then
+;;; we make it be in the block that the node is in. If the ctran heads
+;;; its block, we end our block and link it to that block.
+#!-sb-fluid (declaim (inline use-ctran))
+(defun use-ctran (node ctran)
+  (declare (type node node) (type ctran ctran))
+  (if (eq (ctran-kind ctran) :unused)
+      (let ((node-block (ctran-block (node-prev node))))
+        (setf (ctran-block ctran) node-block)
+        (setf (ctran-kind ctran) :inside-block)
+        (setf (ctran-use ctran) node)
+        (setf (node-next node) ctran))
+      (%use-ctran node ctran)))
+(defun %use-ctran (node ctran)
+  (declare (type node node) (type ctran ctran) (inline member))
+  (let ((block (ctran-block ctran))
+        (node-block (ctran-block (node-prev node))))
+    (aver (eq (ctran-kind ctran) :block-start))
+    (when (block-last node-block)
+      (error "~S has already ended." node-block))
     (setf (block-last node-block) node)
-    (assert (null (block-succ node-block)) () "~S already has successors."
-           node-block)
+    (when (block-succ node-block)
+      (error "~S already has successors." node-block))
     (setf (block-succ node-block) (list block))
-    (assert (not (member node-block (block-pred block) :test #'eq)) ()
-           "~S is already a predecessor of ~S." node-block block)
-    (push node-block (block-pred block))
-    (add-continuation-use node cont)
-    (unless (eq (continuation-asserted-type cont) *wild-type*)
-      (let ((new (values-type-union (continuation-asserted-type cont)
-                                   (or (lexenv-find cont type-restrictions)
-                                       *wild-type*))))
-       (when (type/= new (continuation-asserted-type cont))
-         (setf (continuation-asserted-type cont) new)
-         (reoptimize-continuation cont))))))
+    (when (memq node-block (block-pred block))
+      (error "~S is already a predecessor of ~S." node-block block))
+    (push node-block (block-pred block))))
+
+;;; Insert NEW before OLD in the flow-graph.
+(defun insert-node-before (old new)
+  (let ((prev (node-prev old))
+        (temp (make-ctran)))
+    (ensure-block-start prev)
+    (setf (ctran-next prev) nil)
+    (link-node-to-previous-ctran new prev)
+    (use-ctran new temp)
+    (link-node-to-previous-ctran old temp))
+  (values))
+
+;;; This function is used to set the ctran for a node, and thus
+;;; determine what receives the value.
+(defun use-lvar (node lvar)
+  (declare (type valued-node node) (type (or lvar null) lvar))
+  (aver (not (node-lvar node)))
+  (when lvar
+    (setf (node-lvar node) lvar)
+    (cond ((null (lvar-uses lvar))
+           (setf (lvar-uses lvar) node))
+          ((listp (lvar-uses lvar))
+           (aver (not (memq node (lvar-uses lvar))))
+           (push node (lvar-uses lvar)))
+          (t
+           (aver (neq node (lvar-uses lvar)))
+           (setf (lvar-uses lvar) (list node (lvar-uses lvar)))))
+    (reoptimize-lvar lvar)))
+
+#!-sb-fluid(declaim (inline use-continuation))
+(defun use-continuation (node ctran lvar)
+  (use-ctran node ctran)
+  (use-lvar node lvar))
 \f
 ;;;; exported functions
 
-;;; This function takes a form and the top-level form number for that
+;;; This function takes a form and the top level form number for that
 ;;; form, and returns a lambda representing the translation of that
-;;; form in the current global environment. The lambda is top-level
-;;; lambda that can be called to cause evaluation of the forms. This
-;;; lambda is in the initial component. If FOR-VALUE is T, then the
-;;; value of the form is returned from the function, otherwise NIL is
-;;; returned.
+;;; form in the current global environment. The returned lambda is a
+;;; top level lambda that can be called to cause evaluation of the
+;;; forms. This lambda is in the initial component. If FOR-VALUE is T,
+;;; then the value of the form is returned from the function,
+;;; otherwise NIL is returned.
 ;;;
 ;;; This function may have arbitrary effects on the global environment
-;;; due to processing of PROCLAIMs and EVAL-WHENs. All syntax error
-;;; checking is done, with erroneous forms being replaced by a proxy
-;;; which signals an error if it is evaluated. Warnings about possibly
-;;; inconsistent or illegal changes to the global environment will
-;;; also be given.
+;;; due to processing of EVAL-WHENs. All syntax error checking is
+;;; done, with erroneous forms being replaced by a proxy which signals
+;;; an error if it is evaluated. Warnings about possibly inconsistent
+;;; or illegal changes to the global environment will also be given.
 ;;;
 ;;; We make the initial component and convert the form in a PROGN (and
 ;;; an optional NIL tacked on the end.) We then return the lambda. We
 ;;; The hashtables used to hold global namespace info must be
 ;;; reallocated elsewhere. Note also that *LEXENV* is not bound, so
 ;;; that local macro definitions can be introduced by enclosing code.
-(defun ir1-top-level (form path for-value)
+(defun ir1-toplevel (form path for-value &optional (allow-instrumenting t))
   (declare (list path))
   (let* ((*current-path* path)
-        (component (make-empty-component))
-        (*current-component* component))
-    (setf (component-name component) "initial component")
+         (component (make-empty-component))
+         (*current-component* component)
+         (*allow-instrumenting* allow-instrumenting))
+    (setf (component-name component) 'initial-component)
     (setf (component-kind component) :initial)
     (let* ((forms (if for-value `(,form) `(,form nil)))
-          (res (ir1-convert-lambda-body forms ())))
-      (setf (leaf-name res) "top-level form")
-      (setf (functional-entry-function res) res)
-      (setf (functional-arg-documentation res) ())
-      (setf (functional-kind res) :top-level)
+           (res (ir1-convert-lambda-body
+                 forms ()
+                 :debug-name (debug-name 'top-level-form #+sb-xc-host nil #-sb-xc-host form))))
+      (setf (functional-entry-fun res) res
+            (functional-arg-documentation res) ()
+            (functional-kind res) :toplevel)
       res)))
 
-;;; *CURRENT-FORM-NUMBER* is used in FIND-SOURCE-PATHS to compute the
-;;; form number to associate with a source path. This should be bound
-;;; to 0 around the processing of each truly top-level form.
-(declaim (type index *current-form-number*))
-(defvar *current-form-number*)
-
 ;;; This function is called on freshly read forms to record the
 ;;; initial location of each form (and subform.) Form is the form to
-;;; find the paths in, and TLF-Num is the top-level form number of the
-;;; truly top-level form.
+;;; find the paths in, and TLF-NUM is the top level form number of the
+;;; truly top level form.
 ;;;
 ;;; This gets a bit interesting when the source code is circular. This
 ;;; can (reasonably?) happen in the case of circular list constants.
     (sub-find-source-paths form (list tlf-num)))
   (values))
 (defun sub-find-source-paths (form path)
-  (unless (gethash form *source-paths*)
-    (setf (gethash form *source-paths*)
-         (list* 'original-source-start *current-form-number* path))
+  (unless (get-source-path form)
+    (note-source-path form path)
     (incf *current-form-number*)
     (let ((pos 0)
-         (subform form)
-         (trail form))
+          (subform form)
+          (trail form))
       (declare (fixnum pos))
       (macrolet ((frob ()
-                  '(progn
-                     (when (atom subform) (return))
-                     (let ((fm (car subform)))
-                       (when (consp fm)
-                         (sub-find-source-paths fm (cons pos path)))
-                       (incf pos))
-                     (setq subform (cdr subform))
-                     (when (eq subform trail) (return)))))
-       (loop
-         (frob)
-         (frob)
-         (setq trail (cdr trail)))))))
+                   `(progn
+                      (when (atom subform) (return))
+                      (let ((fm (car subform)))
+                        (cond ((consp fm)
+                               ;; If it's a cons, recurse.
+                               (sub-find-source-paths fm (cons pos path)))
+                              ((eq 'quote fm)
+                               ;; Don't look into quoted constants.
+                               (return))
+                              ((not (zerop pos))
+                               ;; Otherwise store the containing form. It's not
+                               ;; perfect, but better than nothing.
+                               (note-source-path subform pos path)))
+                        (incf pos))
+                      (setq subform (cdr subform))
+                      (when (eq subform trail) (return)))))
+        (loop
+          (frob)
+          (frob)
+          (setq trail (cdr trail)))))))
 \f
 ;;;; IR1-CONVERT, macroexpansion and special form dispatching
 
+(declaim (ftype (sfunction (ctran ctran (or lvar null) t &optional t)
+                           (values))
+                ir1-convert))
 (macrolet (;; Bind *COMPILER-ERROR-BAILOUT* to a function that throws
-          ;; out of the body and converts a proxy form instead.
-          (ir1-error-bailout ((start
-                               cont
-                               form
-                               &optional
-                               (proxy ``(error "execution of a form compiled with errors:~% ~S"
-                                               ',,form)))
-                              &body body)
-                             (let ((skip (gensym "SKIP")))
-                               `(block ,skip
-                                  (catch 'ir1-error-abort
-                                    (let ((*compiler-error-bailout*
-                                           #'(lambda ()
-                                               (throw 'ir1-error-abort nil))))
-                                      ,@body
-                                      (return-from ,skip nil)))
-                                  (ir1-convert ,start ,cont ,proxy)))))
+           ;; out of the body and converts a condition signalling form
+           ;; instead. The source form is converted to a string since it
+           ;; may contain arbitrary non-externalizable objects.
+           (ir1-error-bailout ((start next result form) &body body)
+             (with-unique-names (skip condition)
+               `(block ,skip
+                 (let ((,condition (catch 'ir1-error-abort
+                                     (let ((*compiler-error-bailout*
+                                            (lambda (&optional e)
+                                              (throw 'ir1-error-abort e))))
+                                       ,@body
+                                       (return-from ,skip nil)))))
+                   (ir1-convert ,start ,next ,result
+                                (make-compiler-error-form ,condition
+                                                          ,form)))))))
 
   ;; Translate FORM into IR1. The code is inserted as the NEXT of the
-  ;; continuation START. CONT is the continuation which receives the
-  ;; value of the FORM to be translated. The translators call this
-  ;; function recursively to translate their subnodes.
+  ;; CTRAN START. RESULT is the LVAR which receives the value of the
+  ;; FORM to be translated. The translators call this function
+  ;; recursively to translate their subnodes.
   ;;
   ;; As a special hack to make life easier in the compiler, a LEAF
   ;; IR1-converts into a reference to that LEAF structure. This allows
   ;; the creation using backquote of forms that contain leaf
   ;; references, without having to introduce dummy names into the
   ;; namespace.
-  (declaim (ftype (function (continuation continuation t) (values)) ir1-convert))
-  (defun ir1-convert (start cont form)
-    (ir1-error-bailout (start cont form)
-      (let ((*current-path* (or (gethash form *source-paths*)
-                               (cons form *current-path*))))
-       (if (atom form)
-           (cond ((and (symbolp form) (not (keywordp form)))
-                  (ir1-convert-variable start cont form))
-                 ((leaf-p form)
-                  (reference-leaf start cont form))
-                 (t
-                  (reference-constant start cont form)))
-           (let ((fun (car form)))
-             (cond
-              ((symbolp fun)
-               (let ((lexical-def (lexenv-find fun functions)))
-                 (typecase lexical-def
-                   (null (ir1-convert-global-functoid start cont form))
-                   (functional
-                    (ir1-convert-local-combination start
-                                                   cont
-                                                   form
-                                                   lexical-def))
-                   (global-var
-                    (ir1-convert-srctran start cont lexical-def form))
-                   (t
-                    (assert (and (consp lexical-def)
-                                 (eq (car lexical-def) 'macro)))
-                    (ir1-convert start cont
-                                 (careful-expand-macro (cdr lexical-def)
-                                                       form))))))
-              ((or (atom fun) (not (eq (car fun) 'lambda)))
-               (compiler-error "illegal function call"))
-              (t
-               (ir1-convert-combination start
-                                        cont
-                                        form
-                                        (ir1-convert-lambda fun))))))))
+  (defun ir1-convert (start next result form &optional alias)
+    (ir1-error-bailout (start next result form)
+      (let* ((*current-path* (ensure-source-path (or alias form)))
+             (start (instrument-coverage start nil form)))
+        (cond ((atom form)
+               (cond ((and (symbolp form) (not (keywordp form)))
+                      (ir1-convert-var start next result form))
+                     ((leaf-p form)
+                      (reference-leaf start next result form))
+                     (t
+                      (reference-constant start next result form))))
+              (t
+               (ir1-convert-functoid start next result form)))))
     (values))
 
   ;; Generate a reference to a manifest constant, creating a new leaf
-  ;; if necessary. If we are producing a fasl-file, make sure that
-  ;; MAKE-LOAD-FORM gets used on any parts of the constant that it
-  ;; needs to be.
-  (defun reference-constant (start cont value)
-    (declare (type continuation start cont)
-            (inline find-constant))
-    (ir1-error-bailout
-     (start cont value
-           '(error "attempt to reference undumpable constant"))
-     (when (producing-fasl-file)
-       (maybe-emit-make-load-forms value))
-     (let* ((leaf (find-constant value))
-           (res (make-ref (leaf-type leaf) leaf)))
-       (push res (leaf-refs leaf))
-       (prev-link res start)
-       (use-continuation res cont)))
+  ;; if necessary.
+  (defun reference-constant (start next result value)
+    (declare (type ctran start next)
+             (type (or lvar null) result))
+    (ir1-error-bailout (start next result value)
+      (let* ((leaf (find-constant value))
+             (res (make-ref leaf)))
+        (push res (leaf-refs leaf))
+        (link-node-to-previous-ctran res start)
+        (use-continuation res next result)))
     (values)))
 
-;;; Add Fun to the COMPONENT-REANALYZE-FUNCTIONS. Fun is returned.
- (defun maybe-reanalyze-function (fun)
-  (declare (type functional fun))
-  (when (typep fun '(or optional-dispatch clambda))
-    (pushnew fun (component-reanalyze-functions *current-component*)))
-  fun)
+;;; Add FUNCTIONAL to the COMPONENT-REANALYZE-FUNCTIONALS, unless it's
+;;; some trivial type for which reanalysis is a trivial no-op, or
+;;; unless it doesn't belong in this component at all.
+;;;
+;;; FUNCTIONAL is returned.
+(defun maybe-reanalyze-functional (functional)
+
+  (aver (not (eql (functional-kind functional) :deleted))) ; bug 148
+  (aver-live-component *current-component*)
+
+  ;; When FUNCTIONAL is of a type for which reanalysis isn't a trivial
+  ;; no-op
+  (when (typep functional '(or optional-dispatch clambda))
+
+    ;; When FUNCTIONAL knows its component
+    (when (lambda-p functional)
+      (aver (eql (lambda-component functional) *current-component*)))
 
-;;; Generate a Ref node for LEAF, frobbing the LEAF structure as
+    (pushnew functional
+             (component-reanalyze-functionals *current-component*)))
+
+  functional)
+
+;;; Generate a REF node for LEAF, frobbing the LEAF structure as
 ;;; needed. If LEAF represents a defined function which has already
 ;;; been converted, and is not :NOTINLINE, then reference the
 ;;; functional instead.
-(defun reference-leaf (start cont leaf)
-  (declare (type continuation start cont) (type leaf leaf))
-  (let* ((leaf (or (and (defined-function-p leaf)
-                       (not (eq (defined-function-inlinep leaf)
-                                :notinline))
-                       (let ((fun (defined-function-functional leaf)))
-                         (when (and fun (not (functional-kind fun)))
-                           (maybe-reanalyze-function fun))))
-                  leaf))
-        (res (make-ref (or (lexenv-find leaf type-restrictions)
-                           (leaf-type leaf))
-                       leaf)))
-    (push res (leaf-refs leaf))
+(defun reference-leaf (start next result leaf &optional (name '.anonymous.))
+  (declare (type ctran start next) (type (or lvar null) result) (type leaf leaf))
+  (assure-leaf-live-p leaf)
+  (let* ((type (lexenv-find leaf type-restrictions))
+         (leaf (or (and (defined-fun-p leaf)
+                        (not (eq (defined-fun-inlinep leaf)
+                                 :notinline))
+                        (let ((functional (defined-fun-functional leaf)))
+                          (when (and functional (not (functional-kind functional)))
+                            (maybe-reanalyze-functional functional))))
+                   (when (and (lambda-p leaf)
+                              (memq (functional-kind leaf)
+                                    '(nil :optional)))
+                     (maybe-reanalyze-functional leaf))
+                   leaf))
+         (ref (make-ref leaf name)))
+    (push ref (leaf-refs leaf))
     (setf (leaf-ever-used leaf) t)
-    (prev-link res start)
-    (use-continuation res cont)))
+    (link-node-to-previous-ctran ref start)
+    (cond (type (let* ((ref-ctran (make-ctran))
+                       (ref-lvar (make-lvar))
+                       (cast (make-cast ref-lvar
+                                        (make-single-value-type type)
+                                        (lexenv-policy *lexenv*))))
+                  (setf (lvar-dest ref-lvar) cast)
+                  (use-continuation ref ref-ctran ref-lvar)
+                  (link-node-to-previous-ctran cast ref-ctran)
+                  (use-continuation cast next result)))
+          (t (use-continuation ref next result)))))
 
 ;;; Convert a reference to a symbolic constant or variable. If the
-;;; symbol is entered in the LEXENV-VARIABLES we use that definition,
+;;; symbol is entered in the LEXENV-VARS we use that definition,
 ;;; otherwise we find the current global definition. This is also
-;;; where we pick off symbol macro and Alien variable references.
-(defun ir1-convert-variable (start cont name)
-  (declare (type continuation start cont) (symbol name))
-  (let ((var (or (lexenv-find name variables) (find-free-variable name))))
-    (etypecase var
-      (leaf
-       (when (and (lambda-var-p var) (lambda-var-ignorep var))
-        ;; (ANSI's specification for the IGNORE declaration requires
-        ;; that this be a STYLE-WARNING, not a full WARNING.)
-        (compiler-style-warning "reading an ignored variable: ~S" name))
-       (reference-leaf start cont var))
-      (cons
-       (assert (eq (car var) 'MACRO))
-       (ir1-convert start cont (cdr var)))
-      (heap-alien-info
-       (ir1-convert start cont `(%heap-alien ',var)))))
+;;; where we pick off symbol macro and alien variable references.
+(defun ir1-convert-var (start next result name)
+  (declare (type ctran start next) (type (or lvar null) result) (symbol name))
+  (let ((var (or (lexenv-find name vars) (find-free-var name))))
+    (if (and (global-var-p var) (not (info :variable :always-bound name)))
+        ;; KLUDGE: If the variable may be unbound, convert using SYMBOL-VALUE
+        ;; which is not flushable, so that unbound dead variables signal an
+        ;; error (bug 412, lp#722734): checking for null RESULT is not enough,
+        ;; since variables can become dead due to later optimizations.
+        (ir1-convert start next result
+                     (if (eq (global-var-kind var) :global)
+                         `(symbol-global-value ',name)
+                         `(symbol-value ',name)))
+        (etypecase var
+          (leaf
+           (when (lambda-var-p var)
+             (let ((home (ctran-home-lambda-or-null start)))
+               (when home
+                 (sset-adjoin var (lambda-calls-or-closes home))))
+             (when (lambda-var-ignorep var)
+               ;; (ANSI's specification for the IGNORE declaration requires
+               ;; that this be a STYLE-WARNING, not a full WARNING.)
+               #-sb-xc-host
+               (compiler-style-warn "reading an ignored variable: ~S" name)
+               ;; there's no need for us to accept ANSI's lameness when
+               ;; processing our own code, though.
+               #+sb-xc-host
+               (warn "reading an ignored variable: ~S" name)))
+           (when (global-var-p var)
+             (check-deprecated-variable name))
+           (reference-leaf start next result var name))
+          (cons
+           (aver (eq (car var) 'macro))
+           ;; FIXME: [Free] type declarations. -- APD, 2002-01-26
+           (ir1-convert start next result (cdr var)))
+          (heap-alien-info
+           (ir1-convert start next result `(%heap-alien ',var))))))
   (values))
 
-;;; Convert anything that looks like a special form, global function
-;;; or macro call.
-(defun ir1-convert-global-functoid (start cont form)
-  (declare (type continuation start cont) (list form))
-  (let* ((fun (first form))
-        (translator (info :function :ir1-convert fun))
-        (cmacro (info :function :compiler-macro-function fun)))
-    (cond (translator (funcall translator start cont form))
-         ((and cmacro (not *converting-for-interpreter*)
-               (not (eq (info :function :inlinep fun) :notinline)))
-          (let ((res (careful-expand-macro cmacro form)))
-            (if (eq res form)
-                (ir1-convert-global-functoid-no-cmacro start cont form fun)
-                (ir1-convert start cont res))))
-         (t
-          (ir1-convert-global-functoid-no-cmacro start cont form fun)))))
-
-;;; Handle the case of where the call was not a compiler macro, or was a
-;;; compiler macro and passed.
-(defun ir1-convert-global-functoid-no-cmacro (start cont form fun)
-  (declare (type continuation start cont) (list form))
+;;; Find a compiler-macro for a form, taking FUNCALL into account.
+(defun find-compiler-macro (opname form)
+  (if (eq opname 'funcall)
+      (let ((fun-form (cadr form)))
+        (cond ((and (consp fun-form) (eq 'function (car fun-form))
+                    (not (cddr fun-form)))
+               (let ((real-fun (cadr fun-form)))
+                 (if (legal-fun-name-p real-fun)
+                     (values (sb!xc:compiler-macro-function real-fun *lexenv*)
+                             real-fun)
+                     (values nil nil))))
+              ((sb!xc:constantp fun-form *lexenv*)
+               (let ((fun (constant-form-value fun-form *lexenv*)))
+                 (if (legal-fun-name-p fun)
+                     ;; CLHS tells us that local functions must shadow
+                     ;; compiler-macro-functions, but since the call is
+                     ;; through a name, we are obviously interested
+                     ;; in the global function.
+                     (values (sb!xc:compiler-macro-function fun nil) fun)
+                     (values nil nil))))
+              (t
+               (values nil nil))))
+      (if (legal-fun-name-p opname)
+          (values (sb!xc:compiler-macro-function opname *lexenv*) opname)
+          (values nil nil))))
+
+;;; Picks of special forms and compiler-macro expansions, and hands
+;;; the rest to IR1-CONVERT-COMMON-FUNCTOID
+(defun ir1-convert-functoid (start next result form)
+  (let* ((op (car form))
+         (translator (and (symbolp op) (info :function :ir1-convert op))))
+    (cond (translator
+           (when (sb!xc:compiler-macro-function op *lexenv*)
+             (compiler-warn "ignoring compiler macro for special form"))
+           (funcall translator start next result form))
+          (t
+           (multiple-value-bind (cmacro-fun cmacro-fun-name)
+               (find-compiler-macro op form)
+             (if (and cmacro-fun
+                      ;; CLHS 3.2.2.1.3 specifies that NOTINLINE
+                      ;; suppresses compiler-macros.
+                      (not (fun-lexically-notinline-p cmacro-fun-name)))
+                 (let ((res (handler-case
+                                (careful-expand-macro cmacro-fun form t)
+                              (compiler-macro-keyword-problem (c)
+                                (print-compiler-message *error-output* "note: ~A" (list c))
+                                form))))
+                   (cond ((eq res form)
+                          (ir1-convert-common-functoid start next result form op))
+                         (t
+                          (unless (policy *lexenv* (zerop store-xref-data))
+                            (record-call cmacro-fun-name (ctran-block start) *current-path*))
+                          (ir1-convert start next result res))))
+                 (ir1-convert-common-functoid start next result form op)))))))
+
+;;; Handles the "common" cases: any other forms except special forms
+;;; and compiler-macros.
+(defun ir1-convert-common-functoid (start next result form op)
+  (cond ((or (symbolp op) (leaf-p op))
+         (let ((lexical-def (if (leaf-p op) op (lexenv-find op funs))))
+           (typecase lexical-def
+             (null
+              (ir1-convert-global-functoid start next result form op))
+             (functional
+              (ir1-convert-local-combination start next result form
+                                             lexical-def))
+             (global-var
+              (ir1-convert-srctran start next result lexical-def form))
+             (t
+              (aver (and (consp lexical-def) (eq (car lexical-def) 'macro)))
+              (ir1-convert start next result
+                           (careful-expand-macro (cdr lexical-def) form))))))
+        ((or (atom op) (not (eq (car op) 'lambda)))
+         (compiler-error "illegal function call"))
+        (t
+         ;; implicitly (LAMBDA ..) because the LAMBDA expression is
+         ;; the CAR of an executed form.
+         (ir1-convert start next result `(%funcall ,@form)))))
+
+;;; Convert anything that looks like a global function call.
+(defun ir1-convert-global-functoid (start next result form fun)
+  (declare (type ctran start next) (type (or lvar null) result)
+           (list form))
   ;; FIXME: Couldn't all the INFO calls here be converted into
-  ;; standard CL functions, like MACRO-FUNCTION or something?
-  ;; And what happens with lexically-defined (MACROLET) macros
-  ;; here, anyway?
+  ;; standard CL functions, like MACRO-FUNCTION or something? And what
+  ;; happens with lexically-defined (MACROLET) macros here, anyway?
   (ecase (info :function :kind fun)
     (:macro
-     (ir1-convert start
-                 cont
-                 (careful-expand-macro (info :function :macro-function fun)
-                                       form)))
+     (ir1-convert start next result
+                  (careful-expand-macro (info :function :macro-function fun)
+                                        form))
+     (unless (policy *lexenv* (zerop store-xref-data))
+       (record-macroexpansion fun (ctran-block start) *current-path*)))
     ((nil :function)
-     (ir1-convert-srctran start cont (find-free-function fun "Eh?") form))))
+     (ir1-convert-srctran start next result
+                          (find-free-fun fun "shouldn't happen! (no-cmacro)")
+                          form))))
 
 (defun muffle-warning-or-die ()
   (muffle-warning)
-  (error "internal error -- no MUFFLE-WARNING restart"))
-
-;;; Trap errors during the macroexpansion.
-(defun careful-expand-macro (fun form)
-  (handler-bind (;; When cross-compiling, we can get style warnings
-                ;; about e.g. undefined functions. An unhandled
-                ;; CL:STYLE-WARNING (as opposed to a
-                ;; SB!C::COMPILER-NOTE) would cause FAILURE-P to be
-                ;; set on the return from #'SB!XC:COMPILE-FILE, which
-                ;; would falsely indicate an error sufficiently
-                ;; serious that we should stop the build process. To
-                ;; avoid this, we translate CL:STYLE-WARNING
-                ;; conditions from the host Common Lisp into
-                ;; cross-compiler SB!C::COMPILER-NOTE calls. (It
-                ;; might be cleaner to just make Python use
-                ;; CL:STYLE-WARNING internally, so that the
-                ;; significance of any host Common Lisp
-                ;; CL:STYLE-WARNINGs is understood automatically. But
-                ;; for now I'm not motivated to do this. -- WHN
-                ;; 19990412)
-                (style-warning (lambda (c)
-                                 (compiler-note "(during macroexpansion)~%~A"
-                                                c)
-                                 (muffle-warning-or-die)))
-                ;; KLUDGE: CMU CL in its wisdom (version 2.4.6 for
-                ;; Debian Linux, anyway) raises a CL:WARNING
-                ;; condition (not a CL:STYLE-WARNING) for undefined
-                ;; symbols when converting interpreted functions,
-                ;; causing COMPILE-FILE to think the file has a real
-                ;; problem, causing COMPILE-FILE to return FAILURE-P
-                ;; set (not just WARNINGS-P set). Since undefined
-                ;; symbol warnings are often harmless forward
-                ;; references, and since it'd be inordinately painful
-                ;; to try to eliminate all such forward references,
-                ;; these warnings are basically unavoidable. Thus, we
-                ;; need to coerce the system to work through them,
-                ;; and this code does so, by crudely suppressing all
-                ;; warnings in cross-compilation macroexpansion. --
-                ;; WHN 19990412
-                #+cmu
-                (warning (lambda (c)
-                           (compiler-note
-                            "(during macroexpansion)~%~
-                             ~A~%~
-                             (KLUDGE: That was a non-STYLE WARNING.~%~
-                             Ordinarily that would cause compilation to~%~
-                             fail. However, since we're running under~%~
-                             CMU CL, and since CMU CL emits non-STYLE~%~
-                             warnings for safe, hard-to-fix things (e.g.~%~
-                             references to not-yet-defined functions)~%~
-                             we're going to have to ignore it and proceed~%~
-                             anyway. Hopefully we're not ignoring anything~%~
-                             horrible here..)~%"
-                            c)
-                           (muffle-warning-or-die)))
-                (error (lambda (c)
-                         (compiler-error "(during macroexpansion)~%~A" c))))
-    (funcall sb!xc:*macroexpand-hook*
-            fun
-            form
-            *lexenv*)))
+  (bug "no MUFFLE-WARNING restart"))
+
+;;; Expand FORM using the macro whose MACRO-FUNCTION is FUN, trapping
+;;; errors which occur during the macroexpansion.
+(defun careful-expand-macro (fun form &optional cmacro)
+  (flet (;; Return a string to use as a prefix in error reporting,
+         ;; telling something about which form caused the problem.
+         (wherestring ()
+           (let (;; We rely on the printer to abbreviate FORM.
+                 (*print-length* 3)
+                 (*print-level* 3))
+             (format nil
+                     "~@<~A of ~S. Use ~S to intercept.~%~:@>"
+                     (cond (cmacro
+                            #-sb-xc-host "Error during compiler-macroexpansion"
+                            #+sb-xc-host "Error during XC compiler-macroexpansion")
+                           (t
+                            #-sb-xc-host "during macroexpansion"
+                            #+sb-xc-host "during XC macroexpansion"))
+                     form
+                     '*break-on-signals*))))
+    (handler-bind (;; KLUDGE: CMU CL in its wisdom (version 2.4.6 for Debian
+                   ;; Linux, anyway) raises a CL:WARNING condition (not a
+                   ;; CL:STYLE-WARNING) for undefined symbols when converting
+                   ;; interpreted functions, causing COMPILE-FILE to think the
+                   ;; file has a real problem, causing COMPILE-FILE to return
+                   ;; FAILURE-P set (not just WARNINGS-P set). Since undefined
+                   ;; symbol warnings are often harmless forward references,
+                   ;; and since it'd be inordinately painful to try to
+                   ;; eliminate all such forward references, these warnings
+                   ;; are basically unavoidable. Thus, we need to coerce the
+                   ;; system to work through them, and this code does so, by
+                   ;; crudely suppressing all warnings in cross-compilation
+                   ;; macroexpansion. -- WHN 19990412
+                   #+(and cmu sb-xc-host)
+                   (warning (lambda (c)
+                              (compiler-notify
+                               "~@<~A~:@_~
+                                ~A~:@_~
+                                ~@<(KLUDGE: That was a non-STYLE WARNING. ~
+                                   Ordinarily that would cause compilation to ~
+                                   fail. However, since we're running under ~
+                                   CMU CL, and since CMU CL emits non-STYLE ~
+                                   warnings for safe, hard-to-fix things (e.g. ~
+                                   references to not-yet-defined functions) ~
+                                   we're going to have to ignore it and ~
+                                   proceed anyway. Hopefully we're not ~
+                                   ignoring anything  horrible here..)~:@>~:>"
+                               (wherestring)
+                               c)
+                              (muffle-warning-or-die)))
+                   (error
+                     (lambda (c)
+                       (cond
+                         (cmacro
+                          ;; The spec is silent on what we should do. Signaling
+                          ;; a full warning but declining to expand seems like
+                          ;; a conservative and sane thing to do.
+                          (compiler-warn "~@<~A~@:_ ~A~:>" (wherestring) c)
+                          (return-from careful-expand-macro form))
+                         (t
+                          (compiler-error "~@<~A~@:_ ~A~:>"
+                                          (wherestring) c))))))
+      (funcall sb!xc:*macroexpand-hook* fun form *lexenv*))))
 \f
 ;;;; conversion utilities
 
 ;;; Convert a bunch of forms, discarding all the values except the
 ;;; last. If there aren't any forms, then translate a NIL.
-(declaim (ftype (function (continuation continuation list) (values))
-               ir1-convert-progn-body))
-(defun ir1-convert-progn-body (start cont body)
+(declaim (ftype (sfunction (ctran ctran (or lvar null) list) (values))
+                ir1-convert-progn-body))
+(defun ir1-convert-progn-body (start next result body)
   (if (endp body)
-      (reference-constant start cont nil)
+      (reference-constant start next result nil)
       (let ((this-start start)
-           (forms body))
-       (loop
-         (let ((form (car forms)))
-           (when (endp (cdr forms))
-             (ir1-convert this-start cont form)
-             (return))
-           (let ((this-cont (make-continuation)))
-             (ir1-convert this-start this-cont form)
-             (setq this-start this-cont  forms (cdr forms)))))))
+            (forms body))
+        (loop
+          (let ((form (car forms)))
+            (setf this-start
+                  (maybe-instrument-progn-like this-start forms form))
+            (when (endp (cdr forms))
+              (ir1-convert this-start next result form)
+              (return))
+            (let ((this-ctran (make-ctran)))
+              (ir1-convert this-start this-ctran nil form)
+              (setq this-start this-ctran
+                    forms (cdr forms)))))))
   (values))
+
+\f
+;;;; code coverage
+
+;;; Check the policy for whether we should generate code coverage
+;;; instrumentation. If not, just return the original START
+;;; ctran. Otherwise insert code coverage instrumentation after
+;;; START, and return the new ctran.
+(defun instrument-coverage (start mode form)
+  ;; We don't actually use FORM for anything, it's just convenient to
+  ;; have around when debugging the instrumentation.
+  (declare (ignore form))
+  (if (and (policy *lexenv* (> store-coverage-data 0))
+           *code-coverage-records*
+           *allow-instrumenting*)
+      (let ((path (source-path-original-source *current-path*)))
+        (when mode
+          (push mode path))
+        (if (member (ctran-block start)
+                    (gethash path *code-coverage-blocks*))
+            ;; If this source path has already been instrumented in
+            ;; this block, don't instrument it again.
+            start
+            (let ((store
+                   ;; Get an interned record cons for the path. A cons
+                   ;; with the same object identity must be used for
+                   ;; each instrument for the same block.
+                   (or (gethash path *code-coverage-records*)
+                       (setf (gethash path *code-coverage-records*)
+                             (cons path +code-coverage-unmarked+))))
+                  (next (make-ctran))
+                  (*allow-instrumenting* nil))
+              (push (ctran-block start)
+                    (gethash path *code-coverage-blocks*))
+              (let ((*allow-instrumenting* nil))
+                (ir1-convert start next nil
+                             `(locally
+                                  (declare (optimize speed
+                                                     (safety 0)
+                                                     (debug 0)
+                                                     (check-constant-modification 0)))
+                                ;; We're being naughty here, and
+                                ;; modifying constant data. That's ok,
+                                ;; we know what we're doing.
+                                (%rplacd ',store t))))
+              next)))
+      start))
+
+;;; In contexts where we don't have a source location for FORM
+;;; e.g. due to it not being a cons, but where we have a source
+;;; location for the enclosing cons, use the latter source location if
+;;; available. This works pretty well in practice, since many PROGNish
+;;; macroexpansions will just directly splice a block of forms into
+;;; some enclosing form with `(progn ,@body), thus retaining the
+;;; EQness of the conses.
+(defun maybe-instrument-progn-like (start forms form)
+  (or (when (and *allow-instrumenting*
+                 (not (get-source-path form)))
+        (let ((*current-path* (get-source-path forms)))
+          (when *current-path*
+            (instrument-coverage start nil form))))
+      start))
+
+(defun record-code-coverage (info cc)
+  (setf (gethash info *code-coverage-info*) cc))
+
+(defun clear-code-coverage ()
+  (clrhash *code-coverage-info*))
+
+(defun reset-code-coverage ()
+  (maphash (lambda (info cc)
+             (declare (ignore info))
+             (dolist (cc-entry cc)
+               (setf (cdr cc-entry) +code-coverage-unmarked+)))
+           *code-coverage-info*))
+
+(defun code-coverage-record-marked (record)
+  (aver (consp record))
+  (ecase (cdr record)
+    ((#.+code-coverage-unmarked+) nil)
+    ((t) t)))
+
 \f
 ;;;; converting combinations
 
-;;; Convert a function call where the function (Fun) is a Leaf. We
-;;; return the Combination node so that we can poke at it if we want to.
-(declaim (ftype (function (continuation continuation list leaf) combination)
-               ir1-convert-combination))
-(defun ir1-convert-combination (start cont form fun)
-  (let ((fun-cont (make-continuation)))
-    (reference-leaf start fun-cont fun)
-    (ir1-convert-combination-args fun-cont cont (cdr form))))
-
-;;; Convert the arguments to a call and make the Combination node. Fun-Cont
-;;; is the continuation which yields the function to call. Form is the source
-;;; for the call. Args is the list of arguments for the call, which defaults
-;;; to the cdr of source. We return the Combination node.
-(defun ir1-convert-combination-args (fun-cont cont args)
-  (declare (type continuation fun-cont cont) (list args))
-  (let ((node (make-combination fun-cont)))
-    (setf (continuation-dest fun-cont) node)
-    (assert-continuation-type fun-cont
-                             (specifier-type '(or function symbol)))
-    (collect ((arg-conts))
-      (let ((this-start fun-cont))
-       (dolist (arg args)
-         (let ((this-cont (make-continuation node)))
-           (ir1-convert this-start this-cont arg)
-           (setq this-start this-cont)
-           (arg-conts this-cont)))
-       (prev-link node this-start)
-       (use-continuation node cont)
-       (setf (combination-args node) (arg-conts))))
+;;; Does this form look like something that we should add single-stepping
+;;; instrumentation for?
+(defun step-form-p (form)
+  (flet ((step-symbol-p (symbol)
+           (and (not (member (symbol-package symbol)
+                             (load-time-value
+                              ;; KLUDGE: packages we're not interested in
+                              ;; stepping.
+                              (mapcar #'find-package '(sb!c sb!int sb!impl
+                                                       sb!kernel sb!pcl)))))
+                ;; Consistent treatment of *FOO* vs (SYMBOL-VALUE '*FOO*):
+                ;; we insert calls to SYMBOL-VALUE for most non-lexical
+                ;; variable references in order to avoid them being elided
+                ;; if the value is unused.
+                (or (not (member symbol '(symbol-value symbol-global-value)))
+                    (not (constantp (second form)))))))
+    (and *allow-instrumenting*
+         (policy *lexenv* (= insert-step-conditions 3))
+         (listp form)
+         (symbolp (car form))
+         (step-symbol-p (car form)))))
+
+;;; Convert a function call where the function FUN is a LEAF. FORM is
+;;; the source for the call. We return the COMBINATION node so that
+;;; the caller can poke at it if it wants to.
+(declaim (ftype (sfunction (ctran ctran (or lvar null) list leaf) combination)
+                ir1-convert-combination))
+(defun ir1-convert-combination (start next result form fun)
+  (let ((ctran (make-ctran))
+        (fun-lvar (make-lvar)))
+    (ir1-convert start ctran fun-lvar `(the (or function symbol) ,fun))
+    (let ((combination
+           (ir1-convert-combination-args fun-lvar ctran next result
+                                         (cdr form))))
+      (when (step-form-p form)
+        ;; Store a string representation of the form in the
+        ;; combination node. This will let the IR2 translator know
+        ;; that we want stepper instrumentation for this node. The
+        ;; string will be stored in the debug-info by DUMP-1-LOCATION.
+        (setf (combination-step-info combination)
+              (let ((*print-pretty* t)
+                    (*print-circle* t)
+                    (*print-readably* nil))
+                (prin1-to-string form))))
+      combination)))
+
+;;; Convert the arguments to a call and make the COMBINATION
+;;; node. FUN-LVAR yields the function to call. ARGS is the list of
+;;; arguments for the call, which defaults to the cdr of source. We
+;;; return the COMBINATION node.
+(defun ir1-convert-combination-args (fun-lvar start next result args)
+  (declare (type ctran start next)
+           (type lvar fun-lvar)
+           (type (or lvar null) result)
+           (list args))
+  (let ((node (make-combination fun-lvar)))
+    (setf (lvar-dest fun-lvar) node)
+    (collect ((arg-lvars))
+      (let ((this-start start)
+            (forms args))
+        (dolist (arg args)
+          (setf this-start
+                (maybe-instrument-progn-like this-start forms arg))
+          (setf forms (cdr forms))
+          (let ((this-ctran (make-ctran))
+                (this-lvar (make-lvar node)))
+            (ir1-convert this-start this-ctran this-lvar arg)
+            (setq this-start this-ctran)
+            (arg-lvars this-lvar)))
+        (link-node-to-previous-ctran node this-start)
+        (use-continuation node next result)
+        (setf (combination-args node) (arg-lvars))))
     node))
 
 ;;; Convert a call to a global function. If not :NOTINLINE, then we do
 ;;; source transforms and try out any inline expansion. If there is no
-;;; expansion, but is :INLINE, then give an efficiency note (unless a known
-;;; function which will quite possibly be open-coded.)   Next, we go to
-;;; ok-combination conversion.
-(defun ir1-convert-srctran (start cont var form)
-  (declare (type continuation start cont) (type global-var var))
-  (let ((inlinep (when (defined-function-p var)
-                  (defined-function-inlinep var))))
-    (cond
-     ((eq inlinep :notinline)
-      (ir1-convert-combination start cont form var))
-     (*converting-for-interpreter*
-      (ir1-convert-combination-checking-type start cont form var))
-     (t
-      (let ((transform (info :function :source-transform (leaf-name var))))
-       (cond
-        (transform
-         (multiple-value-bind (result pass) (funcall transform form)
-           (if pass
-               (ir1-convert-maybe-predicate start cont form var)
-               (ir1-convert start cont result))))
-        (t
-         (ir1-convert-maybe-predicate start cont form var))))))))
-
-;;; If the function has the Predicate attribute, and the CONT's DEST isn't
-;;; an IF, then we convert (IF <form> T NIL), ensuring that a predicate always
-;;; appears in a conditional context.
+;;; expansion, but is :INLINE, then give an efficiency note (unless a
+;;; known function which will quite possibly be open-coded.) Next, we
+;;; go to ok-combination conversion.
+(defun ir1-convert-srctran (start next result var form)
+  (declare (type ctran start next) (type (or lvar null) result)
+           (type global-var var))
+  (let ((inlinep (when (defined-fun-p var)
+                   (defined-fun-inlinep var))))
+    (if (eq inlinep :notinline)
+        (ir1-convert-combination start next result form var)
+        (let* ((name (leaf-source-name var))
+               (transform (info :function :source-transform name)))
+          (if transform
+              (multiple-value-bind (transformed pass) (funcall transform form)
+                (cond (pass
+                       (ir1-convert-maybe-predicate start next result form var))
+                      (t
+                       (unless (policy *lexenv* (zerop store-xref-data))
+                         (record-call name (ctran-block start) *current-path*))
+                       (ir1-convert start next result transformed))))
+              (ir1-convert-maybe-predicate start next result form var))))))
+
+;;; KLUDGE: If we insert a synthetic IF for a function with the PREDICATE
+;;; attribute, don't generate any branch coverage instrumentation for it.
+(defvar *instrument-if-for-code-coverage* t)
+
+;;; If the function has the PREDICATE attribute, and the RESULT's DEST
+;;; isn't an IF, then we convert (IF <form> T NIL), ensuring that a
+;;; predicate always appears in a conditional context.
 ;;;
 ;;; If the function isn't a predicate, then we call
 ;;; IR1-CONVERT-COMBINATION-CHECKING-TYPE.
-(defun ir1-convert-maybe-predicate (start cont form var)
-  (declare (type continuation start cont) (list form) (type global-var var))
-  (let ((info (info :function :info (leaf-name var))))
+(defun ir1-convert-maybe-predicate (start next result form var)
+  (declare (type ctran start next)
+           (type (or lvar null) result)
+           (list form)
+           (type global-var var))
+  (let ((info (info :function :info (leaf-source-name var))))
     (if (and info
-            (ir1-attributep (function-info-attributes info) predicate)
-            (not (if-p (continuation-dest cont))))
-       (ir1-convert start cont `(if ,form t nil))
-       (ir1-convert-combination-checking-type start cont form var))))
+             (ir1-attributep (fun-info-attributes info) predicate)
+             (not (if-p (and result (lvar-dest result)))))
+        (let ((*instrument-if-for-code-coverage* nil))
+          (ir1-convert start next result `(if ,form t nil)))
+        (ir1-convert-combination-checking-type start next result form var))))
 
 ;;; Actually really convert a global function call that we are allowed
 ;;; to early-bind.
 ;;; call is legal.
 ;;;
 ;;; If the call is legal, we also propagate type assertions from the
-;;; function type to the arg and result continuations. We do this now
-;;; so that IR1 optimize doesn't have to redundantly do the check
-;;; later so that it can do the type propagation.
-(defun ir1-convert-combination-checking-type (start cont form var)
-  (declare (type continuation start cont) (list form) (type leaf var))
-  (let* ((node (ir1-convert-combination start cont form var))
-        (fun-cont (basic-combination-fun node))
-        (type (leaf-type var)))
-    (when (validate-call-type node type t)
-      (setf (continuation-%derived-type fun-cont) type)
-      (setf (continuation-reoptimize fun-cont) nil)
-      (setf (continuation-%type-check fun-cont) nil)))
-
+;;; function type to the arg and result lvars. We do this now so that
+;;; IR1 optimize doesn't have to redundantly do the check later so
+;;; that it can do the type propagation.
+(defun ir1-convert-combination-checking-type (start next result form var)
+  (declare (type ctran start next) (type (or lvar null) result)
+           (list form)
+           (type leaf var))
+  (let* ((node (ir1-convert-combination start next result form var))
+         (fun-lvar (basic-combination-fun node))
+         (type (leaf-type var)))
+    (when (validate-call-type node type var t)
+      (setf (lvar-%derived-type fun-lvar)
+            (make-single-value-type type))
+      (setf (lvar-reoptimize fun-lvar) nil)))
   (values))
 
-;;; Convert a call to a local function. If the function has already
-;;; been let converted, then throw FUN to LOCAL-CALL-LOSSAGE. This
-;;; should only happen when we are converting inline expansions for
-;;; local functions during optimization.
-(defun ir1-convert-local-combination (start cont form fun)
-  (if (functional-kind fun)
-      (throw 'local-call-lossage fun)
-      (ir1-convert-combination start cont form
-                              (maybe-reanalyze-function fun))))
+;;; Convert a call to a local function, or if the function has already
+;;; been LET converted, then throw FUNCTIONAL to
+;;; LOCALL-ALREADY-LET-CONVERTED. The THROW should only happen when we
+;;; are converting inline expansions for local functions during
+;;; optimization.
+(defun ir1-convert-local-combination (start next result form functional)
+  (assure-functional-live-p functional)
+  (ir1-convert-combination start next result
+                           form
+                           (maybe-reanalyze-functional functional)))
 \f
 ;;;; PROCESS-DECLS
 
-;;; Given a list of Lambda-Var structures and a variable name, return
-;;; the structure for that name, or NIL if it isn't found. We return
-;;; the *last* variable with that name, since LET* bindings may be
+;;; Given a list of LAMBDA-VARs and a variable name, return the
+;;; LAMBDA-VAR for that name, or NIL if it isn't found. We return the
+;;; *last* variable with that name, since LET* bindings may be
 ;;; duplicated, and declarations always apply to the last.
-(declaim (ftype (function (list symbol) (or lambda-var list))
-               find-in-bindings))
+(declaim (ftype (sfunction (list symbol) (or lambda-var list))
+                find-in-bindings))
 (defun find-in-bindings (vars name)
   (let ((found nil))
     (dolist (var vars)
       (cond ((leaf-p var)
-            (when (eq (leaf-name var) name)
-              (setq found var))
-            (let ((info (lambda-var-arg-info var)))
-              (when info
-                (let ((supplied-p (arg-info-supplied-p info)))
-                  (when (and supplied-p
-                             (eq (leaf-name supplied-p) name))
-                    (setq found supplied-p))))))
-           ((and (consp var) (eq (car var) name))
-            (setf found (cdr var)))))
+             (when (eq (leaf-source-name var) name)
+               (setq found var))
+             (let ((info (lambda-var-arg-info var)))
+               (when info
+                 (let ((supplied-p (arg-info-supplied-p info)))
+                   (when (and supplied-p
+                              (eq (leaf-source-name supplied-p) name))
+                     (setq found supplied-p))))))
+            ((and (consp var) (eq (car var) name))
+             (setf found (cdr var)))))
     found))
 
-;;; Called by Process-Decls to deal with a variable type declaration.
-;;; If a lambda-var being bound, we intersect the type with the vars
-;;; type, otherwise we add a type-restriction on the var. If a symbol
+;;; Called by PROCESS-DECLS to deal with a variable type declaration.
+;;; If a LAMBDA-VAR being bound, we intersect the type with the var's
+;;; type, otherwise we add a type restriction on the var. If a symbol
 ;;; macro, we just wrap a THE around the expansion.
-(defun process-type-decl (decl res vars)
+(defun process-type-decl (decl res vars context)
   (declare (list decl vars) (type lexenv res))
-  (let ((type (specifier-type (first decl))))
+  (let ((type (compiler-specifier-type (first decl))))
     (collect ((restr nil cons)
-             (new-vars nil cons))
+             (new-vars nil cons))
       (dolist (var-name (rest decl))
-       (let* ((bound-var (find-in-bindings vars var-name))
-              (var (or bound-var
-                       (lexenv-find var-name variables)
-                       (find-free-variable var-name))))
-         (etypecase var
-           (leaf
-            (let* ((old-type (or (lexenv-find var type-restrictions)
-                                 (leaf-type var)))
-                   (int (if (or (function-type-p type)
-                                (function-type-p old-type))
-                            type
-                            (type-approx-intersection2 old-type type))))
-              (cond ((eq int *empty-type*)
-                     (unless (policy nil (= inhibit-warnings 3))
-                       (compiler-warning
-                        "The type declarations ~S and ~S for ~S conflict."
-                        (type-specifier old-type) (type-specifier type)
-                        var-name)))
-                    (bound-var (setf (leaf-type bound-var) int))
-                    (t
-                     (restr (cons var int))))))
-           (cons
-            ;; FIXME: non-ANSI weirdness
-            (assert (eq (car var) 'MACRO))
-            (new-vars `(,var-name . (MACRO . (the ,(first decl)
-                                                  ,(cdr var))))))
-           (heap-alien-info
-            (compiler-error
-             "~S is an alien variable, so its type can't be declared."
-             var-name)))))
+        (when (boundp var-name)
+          (program-assert-symbol-home-package-unlocked
+           context var-name "declaring the type of ~A"))
+        (let* ((bound-var (find-in-bindings vars var-name))
+               (var (or bound-var
+                        (lexenv-find var-name vars)
+                        (find-free-var var-name))))
+          (etypecase var
+            (leaf
+             (flet
+                 ((process-var (var bound-var)
+                    (let* ((old-type (or (lexenv-find var type-restrictions)
+                                         (leaf-type var)))
+                           (int (if (or (fun-type-p type)
+                                        (fun-type-p old-type))
+                                    type
+                                    (type-approx-intersection2
+                                     old-type type))))
+                      (cond ((eq int *empty-type*)
+                             (unless (policy *lexenv* (= inhibit-warnings 3))
+                               (warn
+                                'type-warning
+                                :format-control
+                                "The type declarations ~S and ~S for ~S conflict."
+                                :format-arguments
+                                (list
+                                 (type-specifier old-type)
+                                 (type-specifier type)
+                                 var-name))))
+                            (bound-var
+                             (setf (leaf-type bound-var) int
+                                   (leaf-where-from bound-var) :declared))
+                            (t
+                             (restr (cons var int)))))))
+               (process-var var bound-var)
+               (awhen (and (lambda-var-p var)
+                           (lambda-var-specvar var))
+                      (process-var it nil))))
+            (cons
+             ;; FIXME: non-ANSI weirdness
+             (aver (eq (car var) 'macro))
+             (new-vars `(,var-name . (macro . (the ,(first decl)
+                                                ,(cdr var))))))
+            (heap-alien-info
+             (compiler-error
+              "~S is an alien variable, so its type can't be declared."
+              var-name)))))
 
       (if (or (restr) (new-vars))
-         (make-lexenv :default res
-                      :type-restrictions (restr)
-                      :variables (new-vars))
-         res))))
+          (make-lexenv :default res
+                       :type-restrictions (restr)
+                       :vars (new-vars))
+          res))))
 
 ;;; This is somewhat similar to PROCESS-TYPE-DECL, but handles
 ;;; declarations for function variables. In addition to allowing
 ;;; declarations for functions being bound, we must also deal with
 ;;; declarations that constrain the type of lexically apparent
 ;;; functions.
-(defun process-ftype-decl (spec res names fvars)
-  (declare (list spec names fvars) (type lexenv res))
-  (let ((type (specifier-type spec)))
+(defun process-ftype-decl (spec res names fvars context)
+  (declare (type list names fvars)
+           (type lexenv res))
+  (let ((type (compiler-specifier-type spec)))
+    (unless (csubtypep type (specifier-type 'function))
+      (compiler-style-warn "ignoring declared FTYPE: ~S (not a function type)" spec)
+      (return-from process-ftype-decl res))
     (collect ((res nil cons))
       (dolist (name names)
-       (let ((found (find name fvars :key #'leaf-name :test #'equal)))
-         (cond
-          (found
-           (setf (leaf-type found) type)
-           (assert-definition-type found type
-                                   :warning-function #'compiler-note
-                                   :where "FTYPE declaration"))
-          (t
-           (res (cons (find-lexically-apparent-function
-                       name "in a function type declaration")
-                      type))))))
+        (when (fboundp name)
+          (program-assert-symbol-home-package-unlocked
+           context name "declaring the ftype of ~A"))
+        (let ((found (find name fvars :key #'leaf-source-name :test #'equal)))
+          (cond
+           (found
+            (setf (leaf-type found) type)
+            (assert-definition-type found type
+                                    :unwinnage-fun #'compiler-notify
+                                    :where "FTYPE declaration"))
+           (t
+            (res (cons (find-lexically-apparent-fun
+                        name "in a function type declaration")
+                       type))))))
       (if (res)
-         (make-lexenv :default res :type-restrictions (res))
-         res))))
+          (make-lexenv :default res :type-restrictions (res))
+          res))))
 
 ;;; Process a special declaration, returning a new LEXENV. A non-bound
 ;;; special declaration is instantiated by throwing a special variable
-;;; into the variables.
-(defun process-special-decl (spec res vars)
+;;; into the variables if BINDING-FORM-P is NIL, or otherwise into
+;;; *POST-BINDING-VARIABLE-LEXENV*.
+(defun process-special-decl (spec res vars binding-form-p context)
   (declare (list spec vars) (type lexenv res))
   (collect ((new-venv nil cons))
     (dolist (name (cdr spec))
+      ;; While CLHS seems to allow local SPECIAL declarations for constants,
+      ;; whatever the semantics are supposed to be is not at all clear to me
+      ;; -- since constants aren't allowed to be bound it should be a no-op as
+      ;; no-one can observe the difference portably, but specials are allowed
+      ;; to be bound... yet nowhere does it say that the special declaration
+      ;; removes the constantness. Call it a spec bug and prohibit it. Same
+      ;; for GLOBAL variables.
+      (let ((kind (info :variable :kind name)))
+        (unless (member kind '(:special :unknown))
+          (error "Can't declare ~(~A~) variable locally special: ~S" kind name)))
+      (program-assert-symbol-home-package-unlocked
+       context name "declaring ~A special")
       (let ((var (find-in-bindings vars name)))
-       (etypecase var
-         (cons
-          (assert (eq (car var) 'MACRO))
-          (compiler-error
-           "~S is a symbol-macro and thus can't be declared special."
-           name))
-         (lambda-var
-          (when (lambda-var-ignorep var)
-            ;; ANSI's definition for "Declaration IGNORE, IGNORABLE"
-            ;; requires that this be a STYLE-WARNING, not a full WARNING.
-            (compiler-style-warning
-             "The ignored variable ~S is being declared special."
-             name))
-          (setf (lambda-var-specvar var)
-                (specvar-for-binding name)))
-         (null
-          (unless (assoc name (new-venv) :test #'eq)
-            (new-venv (cons name (specvar-for-binding name))))))))
-    (if (new-venv)
-       (make-lexenv :default res :variables (new-venv))
-       res)))
-
-;;; Return a DEFINED-FUNCTION which copies a global-var but for its inlinep.
-(defun make-new-inlinep (var inlinep)
+        (etypecase var
+          (cons
+           (aver (eq (car var) 'macro))
+           (compiler-error
+            "~S is a symbol-macro and thus can't be declared special."
+            name))
+          (lambda-var
+           (when (lambda-var-ignorep var)
+             ;; ANSI's definition for "Declaration IGNORE, IGNORABLE"
+             ;; requires that this be a STYLE-WARNING, not a full WARNING.
+             (compiler-style-warn
+              "The ignored variable ~S is being declared special."
+              name))
+           (setf (lambda-var-specvar var)
+                 (specvar-for-binding name)))
+          (null
+           (unless (or (assoc name (new-venv) :test #'eq))
+             (new-venv (cons name (specvar-for-binding name))))))))
+    (cond (binding-form-p
+           (setf *post-binding-variable-lexenv*
+                 (append (new-venv) *post-binding-variable-lexenv*))
+           res)
+          ((new-venv)
+           (make-lexenv :default res :vars (new-venv)))
+          (t
+           res))))
+
+;;; Return a DEFINED-FUN which copies a GLOBAL-VAR but for its INLINEP
+;;; (and TYPE if notinline), plus type-restrictions from the lexenv.
+(defun make-new-inlinep (var inlinep local-type)
   (declare (type global-var var) (type inlinep inlinep))
-  (let ((res (make-defined-function
-             :name (leaf-name var)
-             :where-from (leaf-where-from var)
-             :type (leaf-type var)
-             :inlinep inlinep)))
-    (when (defined-function-p var)
-      (setf (defined-function-inline-expansion res)
-           (defined-function-inline-expansion var))
-      (setf (defined-function-functional res)
-           (defined-function-functional var)))
+  (let* ((type (if (and (eq inlinep :notinline)
+                        (not (eq (leaf-where-from var) :declared)))
+                   (specifier-type 'function)
+                   (leaf-type var)))
+         (res (make-defined-fun
+               :%source-name (leaf-source-name var)
+               :where-from (leaf-where-from var)
+               :type (if local-type
+                         (type-intersection local-type type)
+                         type)
+               :inlinep inlinep)))
+    (when (defined-fun-p var)
+      (setf (defined-fun-inline-expansion res)
+            (defined-fun-inline-expansion var))
+      (setf (defined-fun-functionals res)
+            (defined-fun-functionals var)))
+    ;; FIXME: Is this really right? Needs we not set the FUNCTIONAL
+    ;; to the original global-var?
     res))
 
 ;;; Parse an inline/notinline declaration. If it's a local function we're
 ;;; defining, set its INLINEP. If a global function, add a new FENV entry.
 (defun process-inline-decl (spec res fvars)
   (let ((sense (cdr (assoc (first spec) *inlinep-translations* :test #'eq)))
-       (new-fenv ()))
+        (new-fenv ()))
     (dolist (name (rest spec))
-      (let ((fvar (find name fvars :key #'leaf-name :test #'equal)))
-       (if fvar
-           (setf (functional-inlinep fvar) sense)
-           (let ((found
-                  (find-lexically-apparent-function
-                   name "in an inline or notinline declaration")))
-             (etypecase found
-               (functional
-                (when (policy nil (>= speed inhibit-warnings))
-                  (compiler-note "ignoring ~A declaration not at ~
-                                  definition of local function:~%  ~S"
-                                 sense name)))
-               (global-var
-                (push (cons name (make-new-inlinep found sense))
-                      new-fenv)))))))
-
+      (let ((fvar (find name fvars :key #'leaf-source-name :test #'equal)))
+        (if fvar
+            (setf (functional-inlinep fvar) sense)
+            (let ((found (find-lexically-apparent-fun
+                          name "in an inline or notinline declaration")))
+              (etypecase found
+                (functional
+                 (when (policy *lexenv* (>= speed inhibit-warnings))
+                   (compiler-notify "ignoring ~A declaration not at ~
+                                     definition of local function:~%  ~S"
+                                    sense name)))
+                (global-var
+                 (let ((type
+                        (cdr (assoc found (lexenv-type-restrictions res)))))
+                   (push (cons name (make-new-inlinep found sense type))
+                         new-fenv))))))))
     (if new-fenv
-       (make-lexenv :default res :functions new-fenv)
-       res)))
+        (make-lexenv :default res :funs new-fenv)
+        res)))
 
-;;; Like FIND-IN-BINDINGS, but looks for #'foo in the fvars.
+;;; like FIND-IN-BINDINGS, but looks for #'FOO in the FVARS
 (defun find-in-bindings-or-fbindings (name vars fvars)
   (declare (list vars fvars))
-  (if (consp name)
-      (destructuring-bind (wot fn-name) name
-       (unless (eq wot 'function)
-         (compiler-error "The function or variable name ~S is unrecognizable."
-                         name))
-       (find fn-name fvars :key #'leaf-name :test #'equal))
-      (find-in-bindings vars name)))
+  (typecase name
+    (atom
+     (find-in-bindings vars name))
+    ((cons (eql function) (cons * null))
+     (find (cadr name) fvars :key #'leaf-source-name :test #'equal))
+    (t
+     (compiler-error "Malformed function or variable name ~S." name))))
 
 ;;; Process an ignore/ignorable declaration, checking for various losing
 ;;; conditions.
   (dolist (name (rest spec))
     (let ((var (find-in-bindings-or-fbindings name vars fvars)))
       (cond
-       ((not var)
-       ;; ANSI's definition for "Declaration IGNORE, IGNORABLE"
-       ;; requires that this be a STYLE-WARNING, not a full WARNING.
-       (compiler-style-warning "declaring unknown variable ~S to be ignored"
-                               name))
-       ;; FIXME: This special case looks like non-ANSI weirdness.
-       ((and (consp var) (consp (cdr var)) (eq (cadr var) 'macro))
-       ;; Just ignore the IGNORE decl.
-       )
-       ((functional-p var)
-       (setf (leaf-ever-used var) t))
-       ((lambda-var-specvar var)
-       ;; ANSI's definition for "Declaration IGNORE, IGNORABLE"
-       ;; requires that this be a STYLE-WARNING, not a full WARNING.
-       (compiler-style-warning "declaring special variable ~S to be ignored"
-                               name))
-       ((eq (first spec) 'ignorable)
-       (setf (leaf-ever-used var) t))
-       (t
-       (setf (lambda-var-ignorep var) t)))))
+        ((not var)
+         ;; ANSI's definition for "Declaration IGNORE, IGNORABLE"
+         ;; requires that this be a STYLE-WARNING, not a full WARNING.
+         (multiple-value-call #'compiler-style-warn
+           "~A declaration for ~A: ~A"
+           (first spec)
+           (if (symbolp name)
+               (values
+                (case (info :variable :kind name)
+                  (:special "a special variable")
+                  (:global "a global lexical variable")
+                  (:alien "a global alien variable")
+                  (t "an unknown variable"))
+                name)
+               (values
+                (if (info :function :kind (second name))
+                    "a global function"
+                    "an unknown function")
+                (second name)))))
+        ((and (consp var) (eq (car var) 'macro))
+         ;; Just ignore the IGNORE decl: we don't currently signal style-warnings
+         ;; for unused symbol-macros, so there's no need to do anything.
+         )
+        ((functional-p var)
+         (setf (leaf-ever-used var) t))
+        ((and (lambda-var-specvar var) (eq (first spec) 'ignore))
+         ;; ANSI's definition for "Declaration IGNORE, IGNORABLE"
+         ;; requires that this be a STYLE-WARNING, not a full WARNING.
+         (compiler-style-warn "Declaring special variable ~S to be ~A"
+                              name
+                              (first spec)))
+        ((eq (first spec) 'ignorable)
+         (setf (leaf-ever-used var) t))
+        (t
+         (setf (lambda-var-ignorep var) t)))))
   (values))
 
+(defun process-extent-decl (names vars fvars kind)
+  (let ((extent
+          (ecase kind
+            (truly-dynamic-extent
+             :always-dynamic)
+            (dynamic-extent
+             (when *stack-allocate-dynamic-extent*
+               :maybe-dynamic))
+            (indefinite-extent
+             :indefinite))))
+    (if extent
+        (dolist (name names)
+          (cond
+            ((symbolp name)
+             (let* ((bound-var (find-in-bindings vars name))
+                    (var (or bound-var
+                             (lexenv-find name vars)
+                             (maybe-find-free-var name))))
+               (etypecase var
+                 (leaf
+                  (if bound-var
+                      (if (and (leaf-extent var) (neq extent (leaf-extent var)))
+                          (warn "Multiple incompatible extent declarations for ~S?" name)
+                          (setf (leaf-extent var) extent))
+                      (compiler-notify
+                       "Ignoring free ~S declaration: ~S" kind name)))
+                 (cons
+                  (compiler-error "~S on symbol-macro: ~S" kind name))
+                 (heap-alien-info
+                  (compiler-error "~S on alien-variable: ~S" kind name))
+                 (null
+                  (compiler-style-warn
+                   "Unbound variable declared ~S: ~S" kind name)))))
+            ((and (consp name)
+                  (eq (car name) 'function)
+                  (null (cddr name))
+                  (valid-function-name-p (cadr name))
+                  (neq :indefinite extent))
+             (let* ((fname (cadr name))
+                    (bound-fun (find fname fvars
+                                     :key #'leaf-source-name
+                                     :test #'equal))
+                    (fun (or bound-fun (lexenv-find fname funs))))
+               (etypecase fun
+                 (leaf
+                  (if bound-fun
+                      #!+stack-allocatable-closures
+                      (setf (leaf-extent bound-fun) extent)
+                      #!-stack-allocatable-closures
+                      (compiler-notify
+                       "Ignoring DYNAMIC-EXTENT declaration on function ~S ~
+                        (not supported on this platform)." fname)
+                      (compiler-notify
+                       "Ignoring free DYNAMIC-EXTENT declaration: ~S" name)))
+                 (cons
+                  (compiler-error "DYNAMIC-EXTENT on macro: ~S" name))
+                 (null
+                  (compiler-style-warn
+                   "Unbound function declared DYNAMIC-EXTENT: ~S" name)))))
+            (t
+             (compiler-error "~S on a weird thing: ~S" kind name))))
+        (when (policy *lexenv* (= speed 3))
+          (compiler-notify "Ignoring DYNAMIC-EXTENT declarations: ~S" names)))))
+
 ;;; FIXME: This is non-ANSI, so the default should be T, or it should
 ;;; go away, I think.
 (defvar *suppress-values-declaration* nil
   "If true, processing of the VALUES declaration is inhibited.")
 
 ;;; Process a single declaration spec, augmenting the specified LEXENV
-;;; RES and returning it as a result. VARS and FVARS are as described in
+;;; RES. Return RES and result type. VARS and FVARS are as described
 ;;; PROCESS-DECLS.
-(defun process-1-decl (raw-spec res vars fvars cont)
+(defun process-1-decl (raw-spec res vars fvars binding-form-p context)
   (declare (type list raw-spec vars fvars))
   (declare (type lexenv res))
-  (declare (type continuation cont))
-  (let ((spec (canonized-decl-spec raw-spec)))
-    (case (first spec)
-      (special (process-special-decl spec res vars))
-      (ftype
-       (unless (cdr spec)
-        (compiler-error "No type specified in FTYPE declaration: ~S" spec))
-       (process-ftype-decl (second spec) res (cddr spec) fvars))
-      ((inline notinline maybe-inline)
-       (process-inline-decl spec res fvars))
-      ((ignore ignorable)
-       (process-ignore-decl spec vars fvars)
-       res)
-      (optimize
-       (make-lexenv
-       :default res
-       :policy (process-optimize-decl spec (lexenv-policy res))))
-      (optimize-interface
-       (make-lexenv
-       :default res
-       :interface-policy (process-optimize-decl
-                          spec
-                          (lexenv-interface-policy res))))
-      (type
-       (process-type-decl (cdr spec) res vars))
-      (values
-       (if *suppress-values-declaration*
-          res
-          (let ((types (cdr spec)))
-            (do-the-stuff (if (eql (length types) 1)
-                              (car types)
-                              `(values ,@types))
-                          cont res 'values))))
-      (dynamic-extent
-       (when (policy nil (> speed inhibit-warnings))
-        (compiler-note
-         "compiler limitation:~
-           ~%  There's no special support for DYNAMIC-EXTENT (so it's ignored)."))
-       res)
-      (t
-       (unless (info :declaration :recognized (first spec))
-        (compiler-warning "unrecognized declaration ~S" raw-spec))
-       res))))
+  (let ((spec (canonized-decl-spec raw-spec))
+        (result-type *wild-type*))
+    (values
+     (case (first spec)
+       (special (process-special-decl spec res vars binding-form-p context))
+       (ftype
+        (unless (cdr spec)
+          (compiler-error "no type specified in FTYPE declaration: ~S" spec))
+        (process-ftype-decl (second spec) res (cddr spec) fvars context))
+       ((inline notinline maybe-inline)
+        (process-inline-decl spec res fvars))
+       ((ignore ignorable)
+        (process-ignore-decl spec vars fvars)
+        res)
+       (optimize
+        (make-lexenv
+         :default res
+         :policy (process-optimize-decl spec (lexenv-policy res))))
+       (muffle-conditions
+        (make-lexenv
+         :default res
+         :handled-conditions (process-muffle-conditions-decl
+                              spec (lexenv-handled-conditions res))))
+       (unmuffle-conditions
+        (make-lexenv
+         :default res
+         :handled-conditions (process-unmuffle-conditions-decl
+                              spec (lexenv-handled-conditions res))))
+       (type
+        (process-type-decl (cdr spec) res vars context))
+       (values
+        (unless *suppress-values-declaration*
+          (let ((types (cdr spec)))
+            (setq result-type
+                  (compiler-values-specifier-type
+                   (if (singleton-p types)
+                       (car types)
+                       `(values ,@types)))))
+          res))
+       ((dynamic-extent truly-dynamic-extent indefinite-extent)
+        (process-extent-decl (cdr spec) vars fvars (first spec))
+        res)
+       ((disable-package-locks enable-package-locks)
+        (make-lexenv
+         :default res
+         :disabled-package-locks (process-package-lock-decl
+                                  spec (lexenv-disabled-package-locks res))))
+       (t
+        (unless (info :declaration :recognized (first spec))
+          (compiler-warn "unrecognized declaration ~S" raw-spec))
+        (let ((fn (info :declaration :handler (first spec))))
+          (if fn
+              (funcall fn res spec vars fvars)
+              res))))
+     result-type)))
 
 ;;; Use a list of DECLARE forms to annotate the lists of LAMBDA-VAR
 ;;; and FUNCTIONAL structures which are being bound. In addition to
-;;; filling in slots in the leaf structures, we return a new LEXENV
+;;; filling in slots in the leaf structures, we return a new LEXENV,
 ;;; which reflects pervasive special and function type declarations,
-;;; (NOT)INLINE declarations and OPTIMIZE declarations. CONT is the
-;;; continuation affected by VALUES declarations.
+;;; (NOT)INLINE declarations and OPTIMIZE declarations, and type of
+;;; VALUES declarations. If BINDING-FORM-P is true, the third return
+;;; value is a list of VARs that should not apply to the lexenv of the
+;;; initialization forms for the bindings, but should apply to the body.
 ;;;
 ;;; This is also called in main.lisp when PROCESS-FORM handles a use
 ;;; of LOCALLY.
-(defun process-decls (decls vars fvars cont &optional (env *lexenv*))
-  (declare (list decls vars fvars) (type continuation cont))
-  (dolist (decl decls)
-    (dolist (spec (rest decl))
-      (unless (consp spec)
-       (compiler-error "malformed declaration specifier ~S in ~S"
-                       spec
-                       decl))
-      (setq env (process-1-decl spec env vars fvars cont))))
-  env)
+(defun process-decls (decls vars fvars &key
+                      (lexenv *lexenv*) (binding-form-p nil) (context :compile))
+  (declare (list decls vars fvars))
+  (let ((result-type *wild-type*)
+        (*post-binding-variable-lexenv* nil))
+    (dolist (decl decls)
+      (dolist (spec (rest decl))
+        (progv
+            ;; Kludge: EVAL calls this function to deal with LOCALLY.
+            (when (eq context :compile) (list '*current-path*))
+            (when (eq context :compile) (list (or (get-source-path spec)
+                                                  (get-source-path decl)
+                                                  *current-path*)))
+          (unless (consp spec)
+            (compiler-error "malformed declaration specifier ~S in ~S" spec decl))
+          (multiple-value-bind (new-env new-result-type)
+              (process-1-decl spec lexenv vars fvars binding-form-p context)
+            (setq lexenv new-env)
+            (unless (eq new-result-type *wild-type*)
+              (setq result-type
+                    (values-type-intersection result-type new-result-type)))))))
+    (values lexenv result-type *post-binding-variable-lexenv*)))
+
+(defun %processing-decls (decls vars fvars ctran lvar binding-form-p fun)
+  (multiple-value-bind (*lexenv* result-type post-binding-lexenv)
+      (process-decls decls vars fvars :binding-form-p binding-form-p)
+    (cond ((eq result-type *wild-type*)
+           (funcall fun ctran lvar post-binding-lexenv))
+          (t
+           (let ((value-ctran (make-ctran))
+                 (value-lvar (make-lvar)))
+             (multiple-value-prog1
+                 (funcall fun value-ctran value-lvar post-binding-lexenv)
+               (let ((cast (make-cast value-lvar result-type
+                                      (lexenv-policy *lexenv*))))
+                 (link-node-to-previous-ctran cast value-ctran)
+                 (setf (lvar-dest value-lvar) cast)
+                 (use-continuation cast ctran lvar))))))))
+(defmacro processing-decls ((decls vars fvars ctran lvar
+                                   &optional post-binding-lexenv)
+                            &body forms)
+  (check-type ctran symbol)
+  (check-type lvar symbol)
+  (let ((post-binding-lexenv-p (not (null post-binding-lexenv)))
+        (post-binding-lexenv (or post-binding-lexenv (sb!xc:gensym "LEXENV"))))
+    `(%processing-decls ,decls ,vars ,fvars ,ctran ,lvar
+                        ,post-binding-lexenv-p
+                        (lambda (,ctran ,lvar ,post-binding-lexenv)
+                          (declare (ignorable ,post-binding-lexenv))
+                          ,@forms))))
 
 ;;; Return the SPECVAR for NAME to use when we see a local SPECIAL
 ;;; declaration. If there is a global variable of that name, then
 ;;; anonymous GLOBAL-VAR.
 (defun specvar-for-binding (name)
   (cond ((not (eq (info :variable :where-from name) :assumed))
-        (let ((found (find-free-variable name)))
-          (when (heap-alien-info-p found)
-            (compiler-error
-             "~S is an alien variable and so can't be declared special."
-             name))
-          (when (or (not (global-var-p found))
-                    (eq (global-var-kind found) :constant))
-            (compiler-error
-             "~S is a constant and so can't be declared special."
-             name))
-          found))
-       (t
-        (make-global-var :kind :special
-                         :name name
-                         :where-from :declared))))
-\f
-;;;; LAMBDA hackery
-
-;;;; Note: Take a look at the compiler-overview.tex section on "Hairy
-;;;; function representation" before you seriously mess with this
-;;;; stuff.
-
-;;; Verify that a thing is a legal name for a variable and return a
-;;; Var structure for it, filling in info if it is globally special.
-;;; If it is losing, we punt with a Compiler-Error. Names-So-Far is an
-;;; alist of names which have previously been bound. If the name is in
-;;; this list, then we error out.
-(declaim (ftype (function (t list) lambda-var) varify-lambda-arg))
-(defun varify-lambda-arg (name names-so-far)
-  (declare (inline member))
-  (unless (symbolp name)
-    (compiler-error "The lambda-variable ~S is not a symbol." name))
-  (when (member name names-so-far :test #'eq)
-    (compiler-error "The variable ~S occurs more than once in the lambda-list."
-                   name))
-  (let ((kind (info :variable :kind name)))
-    (when (or (keywordp name) (eq kind :constant))
-      (compiler-error "The name of the lambda-variable ~S is a constant."
-                     name))
-    (cond ((eq kind :special)
-          (let ((specvar (find-free-variable name)))
-            (make-lambda-var :name name
-                             :type (leaf-type specvar)
-                             :where-from (leaf-where-from specvar)
-                             :specvar specvar)))
-         (t
-          (note-lexical-binding name)
-          (make-lambda-var :name name)))))
-
-;;; Make the default keyword for a &KEY arg, checking that the keyword
-;;; isn't already used by one of the VARS. We also check that the
-;;; keyword isn't the magical :ALLOW-OTHER-KEYS.
-(declaim (ftype (function (symbol list t) keyword) make-keyword-for-arg))
-(defun make-keyword-for-arg (symbol vars keywordify)
-  (let ((key (if (and keywordify (not (keywordp symbol)))
-                (intern (symbol-name symbol) "KEYWORD")
-                symbol)))
-    (when (eq key :allow-other-keys)
-      (compiler-error "No &KEY arg can be called :ALLOW-OTHER-KEYS."))
-    (dolist (var vars)
-      (let ((info (lambda-var-arg-info var)))
-       (when (and info
-                  (eq (arg-info-kind info) :keyword)
-                  (eq (arg-info-key info) key))
-         (compiler-error
-          "The keyword ~S appears more than once in the lambda-list."
-          key))))
-    key))
-
-;;; Parse a lambda-list into a list of VAR structures, stripping off
-;;; any aux bindings. Each arg name is checked for legality, and
-;;; duplicate names are checked for. If an arg is globally special,
-;;; the var is marked as :SPECIAL instead of :LEXICAL. &KEY,
-;;; &OPTIONAL and &REST args are annotated with an ARG-INFO structure
-;;; which contains the extra information. If we hit something losing,
-;;; we bug out with COMPILER-ERROR. These values are returned:
-;;;  1. a list of the var structures for each top-level argument;
-;;;  2. a flag indicating whether &KEY was specified;
-;;;  3. a flag indicating whether other &KEY args are allowed;
-;;;  4. a list of the &AUX variables; and
-;;;  5. a list of the &AUX values.
-(declaim (ftype (function (list) (values list boolean boolean list list))
-               find-lambda-vars))
-(defun find-lambda-vars (list)
-  (multiple-value-bind (required optional restp rest keyp keys allowp aux
-                       morep more-context more-count)
-      (parse-lambda-list list)
-    (collect ((vars)
-             (names-so-far)
-             (aux-vars)
-             (aux-vals))
-      (flet (;; PARSE-DEFAULT deals with defaults and supplied-p args
-            ;; for optionals and keywords args.
-            (parse-default (spec info)
-              (when (consp (cdr spec))
-                (setf (arg-info-default info) (second spec))
-                (when (consp (cddr spec))
-                  (let* ((supplied-p (third spec))
-                         (supplied-var (varify-lambda-arg supplied-p
-                                                          (names-so-far))))
-                    (setf (arg-info-supplied-p info) supplied-var)
-                    (names-so-far supplied-p)
-                    (when (> (length (the list spec)) 3)
-                      (compiler-error
-                       "The list ~S is too long to be an arg specifier."
-                       spec)))))))
-       
-       (dolist (name required)
-         (let ((var (varify-lambda-arg name (names-so-far))))
-           (vars var)
-           (names-so-far name)))
-       
-       (dolist (spec optional)
-         (if (atom spec)
-             (let ((var (varify-lambda-arg spec (names-so-far))))
-               (setf (lambda-var-arg-info var) (make-arg-info :kind :optional))
-               (vars var)
-               (names-so-far spec))
-             (let* ((name (first spec))
-                    (var (varify-lambda-arg name (names-so-far)))
-                    (info (make-arg-info :kind :optional)))
-               (setf (lambda-var-arg-info var) info)
-               (vars var)
-               (names-so-far name)
-               (parse-default spec info))))
-       
-       (when restp
-         (let ((var (varify-lambda-arg rest (names-so-far))))
-           (setf (lambda-var-arg-info var) (make-arg-info :kind :rest))
-           (vars var)
-           (names-so-far rest)))
-
-       (when morep
-         (let ((var (varify-lambda-arg more-context (names-so-far))))
-           (setf (lambda-var-arg-info var)
-                 (make-arg-info :kind :more-context))
-           (vars var)
-           (names-so-far more-context))
-         (let ((var (varify-lambda-arg more-count (names-so-far))))
-           (setf (lambda-var-arg-info var)
-                 (make-arg-info :kind :more-count))
-           (vars var)
-           (names-so-far more-count)))
-       
-       (dolist (spec keys)
-         (cond
-          ((atom spec)
-           (let ((var (varify-lambda-arg spec (names-so-far))))
-             (setf (lambda-var-arg-info var)
-                   (make-arg-info :kind :keyword
-                                  :key (make-keyword-for-arg spec
-                                                             (vars)
-                                                             t)))
-             (vars var)
-             (names-so-far spec)))
-          ((atom (first spec))
-           (let* ((name (first spec))
-                  (var (varify-lambda-arg name (names-so-far)))
-                  (info (make-arg-info
-                         :kind :keyword
-                         :key (make-keyword-for-arg name (vars) t))))
-             (setf (lambda-var-arg-info var) info)
-             (vars var)
-             (names-so-far name)
-             (parse-default spec info)))
-          (t
-           (let ((head (first spec)))
-             (unless (proper-list-of-length-p head 2)
-               (error "malformed &KEY argument specifier: ~S" spec))
-             (let* ((name (second head))
-                    (var (varify-lambda-arg name (names-so-far)))
-                    (info (make-arg-info
-                           :kind :keyword
-                           :key (make-keyword-for-arg (first head)
-                                                      (vars)
-                                                      nil))))
-               (setf (lambda-var-arg-info var) info)
-               (vars var)
-               (names-so-far name)
-               (parse-default spec info))))))
-       
-       (dolist (spec aux)
-         (cond ((atom spec)
-                (let ((var (varify-lambda-arg spec nil)))
-                  (aux-vars var)
-                  (aux-vals nil)
-                  (names-so-far spec)))
-               (t
-                (unless (proper-list-of-length-p spec 1 2)
-                  (compiler-error "malformed &AUX binding specifier: ~S"
-                                  spec))
-                (let* ((name (first spec))
-                       (var (varify-lambda-arg name nil)))
-                  (aux-vars var)
-                  (aux-vals (second spec))
-                  (names-so-far name)))))
-
-       (values (vars) keyp allowp (aux-vars) (aux-vals))))))
-
-;;; This is similar to IR1-CONVERT-PROGN-BODY except that we
-;;; sequentially bind each AUX-VAR to the corresponding AUX-VAL before
-;;; converting the body. If there are no bindings, just convert the
-;;; body, otherwise do one binding and recurse on the rest.
-;;;
-;;; If INTERFACE is true, then we convert bindings with the interface
-;;; policy. For real &AUX bindings, and for implicit aux bindings
-;;; introduced by keyword bindings, this is always true. It is only
-;;; false when LET* directly calls this function.
-(defun ir1-convert-aux-bindings (start cont body aux-vars aux-vals interface)
-  (declare (type continuation start cont) (list body aux-vars aux-vals))
-  (if (null aux-vars)
-      (ir1-convert-progn-body start cont body)
-      (let ((fun-cont (make-continuation))
-           (fun (ir1-convert-lambda-body body (list (first aux-vars))
-                                         (rest aux-vars) (rest aux-vals)
-                                         interface)))
-       (reference-leaf start fun-cont fun)
-       (let ((*lexenv* (if interface
-                           (make-lexenv
-                            :policy (make-interface-policy *lexenv*))
-                           *lexenv*)))
-         (ir1-convert-combination-args fun-cont cont
-                                       (list (first aux-vals))))))
-  (values))
-
-;;; This is similar to IR1-CONVERT-PROGN-BODY except that code to bind
-;;; the SPECVAR for each SVAR to the value of the variable is wrapped
-;;; around the body. If there are no special bindings, we just convert
-;;; the body, otherwise we do one special binding and recurse on the
-;;; rest.
-;;;
-;;; We make a cleanup and introduce it into the lexical environment.
-;;; If there are multiple special bindings, the cleanup for the blocks
-;;; will end up being the innermost one. We force CONT to start a
-;;; block outside of this cleanup, causing cleanup code to be emitted
-;;; when the scope is exited.
-(defun ir1-convert-special-bindings (start cont body aux-vars aux-vals
-                                          interface svars)
-  (declare (type continuation start cont)
-          (list body aux-vars aux-vals svars))
-  (cond
-   ((null svars)
-    (ir1-convert-aux-bindings start cont body aux-vars aux-vals interface))
-   (t
-    (continuation-starts-block cont)
-    (let ((cleanup (make-cleanup :kind :special-bind))
-         (var (first svars))
-         (next-cont (make-continuation))
-         (nnext-cont (make-continuation)))
-      (ir1-convert start next-cont
-                  `(%special-bind ',(lambda-var-specvar var) ,var))
-      (setf (cleanup-mess-up cleanup) (continuation-use next-cont))
-      (let ((*lexenv* (make-lexenv :cleanup cleanup)))
-       (ir1-convert next-cont nnext-cont '(%cleanup-point))
-       (ir1-convert-special-bindings nnext-cont cont body aux-vars aux-vals
-                                     interface (rest svars))))))
-  (values))
-
-;;; Create a lambda node out of some code, returning the result. The
-;;; bindings are specified by the list of VAR structures VARS. We deal
-;;; with adding the names to the LEXENV-VARIABLES for the conversion.
-;;; The result is added to the NEW-FUNCTIONS in the
-;;; *CURRENT-COMPONENT* and linked to the component head and tail.
-;;;
-;;; We detect special bindings here, replacing the original VAR in the
-;;; lambda list with a temporary variable. We then pass a list of the
-;;; special vars to IR1-CONVERT-SPECIAL-BINDINGS, which actually emits
-;;; the special binding code.
-;;;
-;;; We ignore any ARG-INFO in the VARS, trusting that someone else is
-;;; dealing with &nonsense.
-;;;
-;;; AUX-VARS is a list of VAR structures for variables that are to be
-;;; sequentially bound. Each AUX-VAL is a form that is to be evaluated
-;;; to get the initial value for the corresponding AUX-VAR. Interface
-;;; is a flag as T when there are real aux values (see LET* and
-;;; IR1-CONVERT-AUX-BINDINGS.)
-(defun ir1-convert-lambda-body (body vars &optional aux-vars aux-vals
-                                    interface result)
-  (declare (list body vars aux-vars aux-vals)
-          (type (or continuation null) result))
-  (let* ((bind (make-bind))
-        (lambda (make-lambda :vars vars :bind bind))
-        (result (or result (make-continuation))))
-    (setf (lambda-home lambda) lambda)
-    (collect ((svars)
-             (new-venv nil cons))
-
-      (dolist (var vars)
-       (setf (lambda-var-home var) lambda)
-       (let ((specvar (lambda-var-specvar var)))
-         (cond (specvar
-                (svars var)
-                (new-venv (cons (leaf-name specvar) specvar)))
-               (t
-                (note-lexical-binding (leaf-name var))
-                (new-venv (cons (leaf-name var) var))))))
-
-      (let ((*lexenv* (make-lexenv :variables (new-venv)
-                                  :lambda lambda
-                                  :cleanup nil)))
-       (setf (bind-lambda bind) lambda)
-       (setf (node-lexenv bind) *lexenv*)
-       
-       (let ((cont1 (make-continuation))
-             (cont2 (make-continuation)))
-         (continuation-starts-block cont1)
-         (prev-link bind cont1)
-         (use-continuation bind cont2)
-         (ir1-convert-special-bindings cont2 result body aux-vars aux-vals
-                                       interface (svars)))
-
-       (let ((block (continuation-block result)))
-         (when block
-           (let ((return (make-return :result result :lambda lambda))
-                 (tail-set (make-tail-set :functions (list lambda)))
-                 (dummy (make-continuation)))
-             (setf (lambda-tail-set lambda) tail-set)
-             (setf (lambda-return lambda) return)
-             (setf (continuation-dest result) return)
-             (setf (block-last block) return)
-             (prev-link return result)
-             (use-continuation return dummy))
-           (link-blocks block (component-tail *current-component*))))))
-
-    (link-blocks (component-head *current-component*) (node-block bind))
-    (push lambda (component-new-functions *current-component*))
-    lambda))
-
-;;; Create the actual entry-point function for an optional entry
-;;; point. The lambda binds copies of each of the VARS, then calls FUN
-;;; with the argument VALS and the DEFAULTS. Presumably the VALS refer
-;;; to the VARS by name. The VALS are passed in in reverse order.
-;;;
-;;; If any of the copies of the vars are referenced more than once,
-;;; then we mark the corresponding var as EVER-USED to inhibit
-;;; "defined but not read" warnings for arguments that are only used
-;;; by default forms.
-;;;
-;;; We bind *LEXENV* to change the policy to the interface policy.
-(defun convert-optional-entry (fun vars vals defaults)
-  (declare (type clambda fun) (list vars vals defaults))
-  (let* ((fvars (reverse vars))
-        (arg-vars (mapcar (lambda (var)
-                            (unless (lambda-var-specvar var)
-                              (note-lexical-binding (leaf-name var)))
-                            (make-lambda-var
-                             :name (leaf-name var)
-                             :type (leaf-type var)
-                             :where-from (leaf-where-from var)
-                             :specvar (lambda-var-specvar var)))
-                          fvars))
-        (*lexenv* (make-lexenv :policy (make-interface-policy *lexenv*)))
-        (fun
-         (ir1-convert-lambda-body
-          `((%funcall ,fun ,@(reverse vals) ,@defaults))
-          arg-vars)))
-    (mapc #'(lambda (var arg-var)
-             (when (cdr (leaf-refs arg-var))
-               (setf (leaf-ever-used var) t)))
-         fvars arg-vars)
-    fun))
-
-;;; This function deals with supplied-p vars in optional arguments. If
-;;; the there is no supplied-p arg, then we just call
-;;; IR1-CONVERT-HAIRY-ARGS on the remaining arguments, and generate a
-;;; optional entry that calls the result. If there is a supplied-p
-;;; var, then we add it into the default vars and throw a T into the
-;;; entry values. The resulting entry point function is returned.
-(defun generate-optional-default-entry (res default-vars default-vals
-                                           entry-vars entry-vals
-                                           vars supplied-p-p body
-                                           aux-vars aux-vals cont)
-  (declare (type optional-dispatch res)
-          (list default-vars default-vals entry-vars entry-vals vars body
-                aux-vars aux-vals)
-          (type (or continuation null) cont))
-  (let* ((arg (first vars))
-        (arg-name (leaf-name arg))
-        (info (lambda-var-arg-info arg))
-        (supplied-p (arg-info-supplied-p info))
-        (ep (if supplied-p
-                (ir1-convert-hairy-args
-                 res
-                 (list* supplied-p arg default-vars)
-                 (list* (leaf-name supplied-p) arg-name default-vals)
-                 (cons arg entry-vars)
-                 (list* t arg-name entry-vals)
-                 (rest vars) t body aux-vars aux-vals cont)
-                (ir1-convert-hairy-args
-                 res
-                 (cons arg default-vars)
-                 (cons arg-name default-vals)
-                 (cons arg entry-vars)
-                 (cons arg-name entry-vals)
-                 (rest vars) supplied-p-p body aux-vars aux-vals cont))))
-
-    (convert-optional-entry ep default-vars default-vals
-                           (if supplied-p
-                               (list (arg-info-default info) nil)
-                               (list (arg-info-default info))))))
-
-;;; Create the MORE-ENTRY function for the OPTIONAL-DISPATCH RES.
-;;; ENTRY-VARS and ENTRY-VALS describe the fixed arguments. REST is
-;;; the var for any &REST arg. KEYS is a list of the &KEY arg vars.
-;;;
-;;; The most interesting thing that we do is parse keywords. We create
-;;; a bunch of temporary variables to hold the result of the parse,
-;;; and then loop over the supplied arguments, setting the appropriate
-;;; temps for the supplied keyword. Note that it is significant that
-;;; we iterate over the keywords in reverse order --- this implements
-;;; the CL requirement that (when a keyword appears more than once)
-;;; the first value is used.
-;;;
-;;; If there is no supplied-p var, then we initialize the temp to the
-;;; default and just pass the temp into the main entry. Since
-;;; non-constant &KEY args are forcibly given a supplied-p var, we
-;;; know that the default is constant, and thus safe to evaluate out
-;;; of order.
-;;;
-;;; If there is a supplied-p var, then we create temps for both the
-;;; value and the supplied-p, and pass them into the main entry,
-;;; letting it worry about defaulting.
-;;;
-;;; We deal with :ALLOW-OTHER-KEYS by delaying unknown keyword errors
-;;; until we have scanned all the keywords.
-;;;
-;;; When converting the function, we bind *LEXENV* to change the
-;;; compilation policy over to the interface policy, so that keyword
-;;; args will be checked even when type checking isn't on in general.
-(defun convert-more-entry (res entry-vars entry-vals rest morep keys)
-  (declare (type optional-dispatch res) (list entry-vars entry-vals keys))
-  (collect ((arg-vars)
-           (arg-vals (reverse entry-vals))
-           (temps)
-           (body))
-
-    (dolist (var (reverse entry-vars))
-      (arg-vars (make-lambda-var :name (leaf-name var)
-                                :type (leaf-type var)
-                                :where-from (leaf-where-from var))))
-
-    (let* ((n-context (gensym "N-CONTEXT-"))
-          (context-temp (make-lambda-var :name n-context))
-          (n-count (gensym "N-COUNT-"))
-          (count-temp (make-lambda-var :name n-count
-                                       :type (specifier-type 'index)))
-          (*lexenv* (make-lexenv :policy (make-interface-policy *lexenv*))))
-
-      (arg-vars context-temp count-temp)
-
-      (when rest
-       (arg-vals `(%listify-rest-args ,n-context ,n-count)))
-      (when morep
-       (arg-vals n-context)
-       (arg-vals n-count))
-
-      (when (optional-dispatch-keyp res)
-       (let ((n-index (gensym "N-INDEX-"))
-             (n-key (gensym "N-KEY-"))
-             (n-value-temp (gensym "N-VALUE-TEMP-"))
-             (n-allowp (gensym "N-ALLOWP-"))
-             (n-losep (gensym "N-LOSEP-"))
-             (allowp (or (optional-dispatch-allowp res)
-                         (policy nil (zerop safety)))))
-
-         (temps `(,n-index (1- ,n-count)) n-key n-value-temp)
-         (body `(declare (fixnum ,n-index) (ignorable ,n-key ,n-value-temp)))
-
-         (collect ((tests))
-           (dolist (key keys)
-             (let* ((info (lambda-var-arg-info key))
-                    (default (arg-info-default info))
-                    (keyword (arg-info-key info))
-                    (supplied-p (arg-info-supplied-p info))
-                    (n-value (gensym "N-VALUE-")))
-               (temps `(,n-value ,default))
-               (cond (supplied-p
-                      (let ((n-supplied (gensym "N-SUPPLIED-")))
-                        (temps n-supplied)
-                        (arg-vals n-value n-supplied)
-                        (tests `((eq ,n-key ',keyword)
-                                 (setq ,n-supplied t)
-                                 (setq ,n-value ,n-value-temp)))))
-                     (t
-                      (arg-vals n-value)
-                      (tests `((eq ,n-key ',keyword)
-                               (setq ,n-value ,n-value-temp)))))))
-
-           (unless allowp
-             (temps n-allowp n-losep)
-             (tests `((eq ,n-key :allow-other-keys)
-                      (setq ,n-allowp ,n-value-temp)))
-             (tests `(t
-                      (setq ,n-losep ,n-key))))
-
-           (body
-            `(when (oddp ,n-count)
-               (%odd-key-arguments-error)))
-
-           (body
-            `(locally
-               (declare (optimize (safety 0)))
-               (loop
-                 (when (minusp ,n-index) (return))
-                 (setf ,n-value-temp (%more-arg ,n-context ,n-index))
-                 (decf ,n-index)
-                 (setq ,n-key (%more-arg ,n-context ,n-index))
-                 (decf ,n-index)
-                 (cond ,@(tests)))))
-
-           (unless allowp
-             (body `(when (and ,n-losep (not ,n-allowp))
-                      (%unknown-key-argument-error ,n-losep)))))))
-
-      (let ((ep (ir1-convert-lambda-body
-                `((let ,(temps)
-                    ,@(body)
-                    (%funcall ,(optional-dispatch-main-entry res)
-                              . ,(arg-vals)))) ; FIXME: What is the '.'? ,@?
-                (arg-vars))))
-       (setf (optional-dispatch-more-entry res) ep))))
-
-  (values))
-
-;;; This is called by IR1-Convert-Hairy-Args when we run into a &REST
-;;; or &KEY arg. The arguments are similar to that function, but we
-;;; split off any &REST arg and pass it in separately. REST is the
-;;; &REST arg var, or NIL if there is no &REST arg. KEYS is a list of
-;;; the &KEY argument vars.
-;;;
-;;; When there are &KEY arguments, we introduce temporary gensym
-;;; variables to hold the values while keyword defaulting is in
-;;; progress to get the required sequential binding semantics.
-;;;
-;;; This gets interesting mainly when there are &KEY arguments with
-;;; supplied-p vars or non-constant defaults. In either case, pass in
-;;; a supplied-p var. If the default is non-constant, we introduce an
-;;; IF in the main entry that tests the supplied-p var and decides
-;;; whether to evaluate the default or not. In this case, the real
-;;; incoming value is NIL, so we must union NULL with the declared
-;;; type when computing the type for the main entry's argument.
-(defun ir1-convert-more (res default-vars default-vals entry-vars entry-vals
-                            rest more-context more-count keys supplied-p-p
-                            body aux-vars aux-vals cont)
-  (declare (type optional-dispatch res)
-          (list default-vars default-vals entry-vars entry-vals keys body
-                aux-vars aux-vals)
-          (type (or continuation null) cont))
-  (collect ((main-vars (reverse default-vars))
-           (main-vals default-vals cons)
-           (bind-vars)
-           (bind-vals))
-    (when rest
-      (main-vars rest)
-      (main-vals '()))
-    (when more-context
-      (main-vars more-context)
-      (main-vals nil)
-      (main-vars more-count)
-      (main-vals 0))
-
-    (dolist (key keys)
-      (let* ((info (lambda-var-arg-info key))
-            (default (arg-info-default info))
-            (hairy-default (not (sb!xc:constantp default)))
-            (supplied-p (arg-info-supplied-p info))
-            (n-val (make-symbol (format nil
-                                        "~A-DEFAULTING-TEMP"
-                                        (leaf-name key))))
-            (key-type (leaf-type key))
-            (val-temp (make-lambda-var
-                       :name n-val
-                       :type (if hairy-default
-                                 (type-union key-type (specifier-type 'null))
-                                 key-type))))
-       (main-vars val-temp)
-       (bind-vars key)
-       (cond ((or hairy-default supplied-p)
-              (let* ((n-supplied (gensym "N-SUPPLIED-"))
-                     (supplied-temp (make-lambda-var :name n-supplied)))
-                (unless supplied-p
-                  (setf (arg-info-supplied-p info) supplied-temp))
-                (when hairy-default
-                  (setf (arg-info-default info) nil))
-                (main-vars supplied-temp)
-                (cond (hairy-default
-                       (main-vals nil nil)
-                       (bind-vals `(if ,n-supplied ,n-val ,default)))
-                      (t
-                       (main-vals default nil)
-                       (bind-vals n-val)))
-                (when supplied-p
-                  (bind-vars supplied-p)
-                  (bind-vals n-supplied))))
-             (t
-              (main-vals (arg-info-default info))
-              (bind-vals n-val)))))
-
-    (let* ((main-entry (ir1-convert-lambda-body body (main-vars)
-                                               (append (bind-vars) aux-vars)
-                                               (append (bind-vals) aux-vals)
-                                               t
-                                               cont))
-          (last-entry (convert-optional-entry main-entry default-vars
-                                              (main-vals) ())))
-      (setf (optional-dispatch-main-entry res) main-entry)
-      (convert-more-entry res entry-vars entry-vals rest more-context keys)
-
-      (push (if supplied-p-p
-               (convert-optional-entry last-entry entry-vars entry-vals ())
-               last-entry)
-           (optional-dispatch-entry-points res))
-      last-entry)))
-
-;;; This function generates the entry point functions for the
-;;; optional-dispatch Res. We accomplish this by recursion on the list of
-;;; arguments, analyzing the arglist on the way down and generating entry
-;;; points on the way up.
-;;;
-;;; Default-Vars is a reversed list of all the argument vars processed so
-;;; far, including supplied-p vars. Default-Vals is a list of the names of the
-;;; Default-Vars.
-;;;
-;;; Entry-Vars is a reversed list of processed argument vars, excluding
-;;; supplied-p vars. Entry-Vals is a list things that can be evaluated to get
-;;; the values for all the vars from the Entry-Vars. It has the var name for
-;;; each required or optional arg, and has T for each supplied-p arg.
-;;;
-;;; Vars is a list of the Lambda-Var structures for arguments that haven't
-;;; been processed yet. Supplied-p-p is true if a supplied-p argument has
-;;; already been processed; only in this case are the Default-XXX and Entry-XXX
-;;; different.
-;;;
-;;; The result at each point is a lambda which should be called by the above
-;;; level to default the remaining arguments and evaluate the body. We cause
-;;; the body to be evaluated by converting it and returning it as the result
-;;; when the recursion bottoms out.
-;;;
-;;; Each level in the recursion also adds its entry point function to the
-;;; result Optional-Dispatch. For most arguments, the defaulting function and
-;;; the entry point function will be the same, but when supplied-p args are
-;;; present they may be different.
-;;;
-;;; When we run into a &REST or &KEY arg, we punt out to
-;;; IR1-CONVERT-MORE, which finishes for us in this case.
-(defun ir1-convert-hairy-args (res default-vars default-vals
-                                  entry-vars entry-vals
-                                  vars supplied-p-p body aux-vars
-                                  aux-vals cont)
-  (declare (type optional-dispatch res)
-          (list default-vars default-vals entry-vars entry-vals vars body
-                aux-vars aux-vals)
-          (type (or continuation null) cont))
-  (cond ((not vars)
-        (if (optional-dispatch-keyp res)
-            ;; Handle &KEY with no keys...
-            (ir1-convert-more res default-vars default-vals
-                              entry-vars entry-vals
-                              nil nil nil vars supplied-p-p body aux-vars
-                              aux-vals cont)
-            (let ((fun (ir1-convert-lambda-body body (reverse default-vars)
-                                                aux-vars aux-vals t cont)))
-              (setf (optional-dispatch-main-entry res) fun)
-              (push (if supplied-p-p
-                        (convert-optional-entry fun entry-vars entry-vals ())
-                        fun)
-                    (optional-dispatch-entry-points res))
-              fun)))
-       ((not (lambda-var-arg-info (first vars)))
-        (let* ((arg (first vars))
-               (nvars (cons arg default-vars))
-               (nvals (cons (leaf-name arg) default-vals)))
-          (ir1-convert-hairy-args res nvars nvals nvars nvals
-                                  (rest vars) nil body aux-vars aux-vals
-                                  cont)))
-       (t
-        (let* ((arg (first vars))
-               (info (lambda-var-arg-info arg))
-               (kind (arg-info-kind info)))
-          (ecase kind
-            (:optional
-             (let ((ep (generate-optional-default-entry
-                        res default-vars default-vals
-                        entry-vars entry-vals vars supplied-p-p body
-                        aux-vars aux-vals cont)))
-               (push (if supplied-p-p
-                         (convert-optional-entry ep entry-vars entry-vals ())
-                         ep)
-                     (optional-dispatch-entry-points res))
-               ep))
-            (:rest
-             (ir1-convert-more res default-vars default-vals
-                               entry-vars entry-vals
-                               arg nil nil (rest vars) supplied-p-p body
-                               aux-vars aux-vals cont))
-            (:more-context
-             (ir1-convert-more res default-vars default-vals
-                               entry-vars entry-vals
-                               nil arg (second vars) (cddr vars) supplied-p-p
-                               body aux-vars aux-vals cont))
-            (:keyword
-             (ir1-convert-more res default-vars default-vals
-                               entry-vars entry-vals
-                               nil nil nil vars supplied-p-p body aux-vars
-                               aux-vals cont)))))))
-
-;;; This function deals with the case where we have to make an
-;;; Optional-Dispatch to represent a lambda. We cons up the result and call
-;;; IR1-Convert-Hairy-Args to do the work. When it is done, we figure out the
-;;; min-args and max-args.
-(defun ir1-convert-hairy-lambda (body vars keyp allowp aux-vars aux-vals cont)
-  (declare (list body vars aux-vars aux-vals) (type continuation cont))
-  (let ((res (make-optional-dispatch :arglist vars
-                                    :allowp allowp
-                                    :keyp keyp))
-       (min (or (position-if #'lambda-var-arg-info vars) (length vars))))
-    (push res (component-new-functions *current-component*))
-    (ir1-convert-hairy-args res () () () () vars nil body aux-vars aux-vals
-                           cont)
-    (setf (optional-dispatch-min-args res) min)
-    (setf (optional-dispatch-max-args res)
-         (+ (1- (length (optional-dispatch-entry-points res))) min))
-
-    (flet ((frob (ep)
-            (when ep
-              (setf (functional-kind ep) :optional)
-              (setf (leaf-ever-used ep) t)
-              (setf (lambda-optional-dispatch ep) res))))
-      (dolist (ep (optional-dispatch-entry-points res)) (frob ep))
-      (frob (optional-dispatch-more-entry res))
-      (frob (optional-dispatch-main-entry res)))
-
-    res))
-
-;;; Convert a Lambda into a Lambda or Optional-Dispatch leaf.
-(defun ir1-convert-lambda (form &optional name)
-  (unless (consp form)
-    (compiler-error "A ~S was found when expecting a lambda expression:~%  ~S"
-                   (type-of form)
-                   form))
-  (unless (eq (car form) 'lambda)
-    (compiler-error "~S was expected but ~S was found:~%  ~S"
-                   'lambda
-                   (car form)
-                   form))
-  (unless (and (consp (cdr form)) (listp (cadr form)))
-    (compiler-error
-     "The lambda expression has a missing or non-list lambda-list:~%  ~S"
-     form))
-
-  (multiple-value-bind (vars keyp allow-other-keys aux-vars aux-vals)
-      (find-lambda-vars (cadr form))
-    (multiple-value-bind (forms decls) (sb!sys:parse-body (cddr form))
-      (let* ((cont (make-continuation))
-            (*lexenv* (process-decls decls
-                                     (append aux-vars vars)
-                                     nil cont))
-            (res (if (or (find-if #'lambda-var-arg-info vars) keyp)
-                     (ir1-convert-hairy-lambda forms vars keyp
-                                               allow-other-keys
-                                               aux-vars aux-vals cont)
-                     (ir1-convert-lambda-body forms vars aux-vars aux-vals
-                                              t cont))))
-       (setf (functional-inline-expansion res) form)
-       (setf (functional-arg-documentation res) (cadr form))
-       (setf (leaf-name res) name)
-       res))))
-\f
-;;; FIXME: This file is rather long, and contains two distinct sections,
-;;; transform machinery above this point and transforms themselves below this
-;;; point. Why not split it in two? (ir1translate.lisp and
-;;; ir1translators.lisp?) Then consider byte-compiling the translators, too.
-\f
-;;;; control special forms
-
-(def-ir1-translator progn ((&rest forms) start cont)
-  #!+sb-doc
-  "Progn Form*
-  Evaluates each Form in order, returning the values of the last form. With no
-  forms, returns NIL."
-  (ir1-convert-progn-body start cont forms))
-
-(def-ir1-translator if ((test then &optional else) start cont)
-  #!+sb-doc
-  "If Predicate Then [Else]
-  If Predicate evaluates to non-null, evaluate Then and returns its values,
-  otherwise evaluate Else and return its values. Else defaults to NIL."
-  (let* ((pred (make-continuation))
-        (then-cont (make-continuation))
-        (then-block (continuation-starts-block then-cont))
-        (else-cont (make-continuation))
-        (else-block (continuation-starts-block else-cont))
-        (dummy-cont (make-continuation))
-        (node (make-if :test pred
-                       :consequent then-block
-                       :alternative else-block)))
-    (setf (continuation-dest pred) node)
-    (ir1-convert start pred test)
-    (prev-link node pred)
-    (use-continuation node dummy-cont)
-
-    (let ((start-block (continuation-block pred)))
-      (setf (block-last start-block) node)
-      (continuation-starts-block cont)
-
-      (link-blocks start-block then-block)
-      (link-blocks start-block else-block)
-
-      (ir1-convert then-cont cont then)
-      (ir1-convert else-cont cont else))))
-\f
-;;;; BLOCK and TAGBODY
-
-;;;; We make an Entry node to mark the start and a :Entry cleanup to
-;;;; mark its extent. When doing GO or RETURN-FROM, we emit an Exit
-;;;; node.
-
-;;; Make a :entry cleanup and emit an Entry node, then convert the
-;;; body in the modified environment. We make Cont start a block now,
-;;; since if it was done later, the block would be in the wrong
-;;; environment.
-(def-ir1-translator block ((name &rest forms) start cont)
-  #!+sb-doc
-  "Block Name Form*
-  Evaluate the Forms as a PROGN. Within the lexical scope of the body,
-  (RETURN-FROM Name Value-Form) can be used to exit the form, returning the
-  result of Value-Form."
-  (unless (symbolp name)
-    (compiler-error "The block name ~S is not a symbol." name))
-  (continuation-starts-block cont)
-  (let* ((dummy (make-continuation))
-        (entry (make-entry))
-        (cleanup (make-cleanup :kind :block
-                               :mess-up entry)))
-    (push entry (lambda-entries (lexenv-lambda *lexenv*)))
-    (setf (entry-cleanup entry) cleanup)
-    (prev-link entry start)
-    (use-continuation entry dummy)
-    
-    (let* ((env-entry (list entry cont))
-           (*lexenv* (make-lexenv :blocks (list (cons name env-entry))
-                                 :cleanup cleanup)))
-      (push env-entry (continuation-lexenv-uses cont))
-      (ir1-convert-progn-body dummy cont forms))))
-
-
-;;; We make Cont start a block just so that it will have a block
-;;; assigned. People assume that when they pass a continuation into
-;;; IR1-Convert as Cont, it will have a block when it is done.
-(def-ir1-translator return-from ((name &optional value)
-                                start cont)
-  #!+sb-doc
-  "Return-From Block-Name Value-Form
-  Evaluate the Value-Form, returning its values from the lexically enclosing
-  BLOCK Block-Name. This is constrained to be used only within the dynamic
-  extent of the BLOCK."
-  (continuation-starts-block cont)
-  (let* ((found (or (lexenv-find name blocks)
-                   (compiler-error "return for unknown block: ~S" name)))
-        (value-cont (make-continuation))
-        (entry (first found))
-        (exit (make-exit :entry entry
-                         :value value-cont)))
-    (push exit (entry-exits entry))
-    (setf (continuation-dest value-cont) exit)
-    (ir1-convert start value-cont value)
-    (prev-link exit value-cont)
-    (use-continuation exit (second found))))
-
-;;; Return a list of the segments of a TAGBODY. Each segment looks
-;;; like (<tag> <form>* (go <next tag>)). That is, we break up the
-;;; tagbody into segments of non-tag statements, and explicitly
-;;; represent the drop-through with a GO. The first segment has a
-;;; dummy NIL tag, since it represents code before the first tag. The
-;;; last segment (which may also be the first segment) ends in NIL
-;;; rather than a GO.
-(defun parse-tagbody (body)
-  (declare (list body))
-  (collect ((segments))
-    (let ((current (cons nil body)))
-      (loop
-       (let ((tag-pos (position-if (complement #'listp) current :start 1)))
-         (unless tag-pos
-           (segments `(,@current nil))
-           (return))
-         (let ((tag (elt current tag-pos)))
-           (when (assoc tag (segments))
-             (compiler-error
-              "The tag ~S appears more than once in the tagbody."
-              tag))
-           (unless (or (symbolp tag) (integerp tag))
-             (compiler-error "~S is not a legal tagbody statement." tag))
-           (segments `(,@(subseq current 0 tag-pos) (go ,tag))))
-         (setq current (nthcdr tag-pos current)))))
-    (segments)))
-
-;;; Set up the cleanup, emitting the entry node. Then make a block for
-;;; each tag, building up the tag list for LEXENV-TAGS as we go.
-;;; Finally, convert each segment with the precomputed Start and Cont
-;;; values.
-(def-ir1-translator tagbody ((&rest statements) start cont)
-  #!+sb-doc
-  "Tagbody {Tag | Statement}*
-  Define tags for used with GO. The Statements are evaluated in order
-  (skipping Tags) and NIL is returned. If a statement contains a GO to a
-  defined Tag within the lexical scope of the form, then control is transferred
-  to the next statement following that tag. A Tag must an integer or a
-  symbol. A statement must be a list. Other objects are illegal within the
-  body."
-  (continuation-starts-block cont)
-  (let* ((dummy (make-continuation))
-        (entry (make-entry))
-        (segments (parse-tagbody statements))
-        (cleanup (make-cleanup :kind :tagbody
-                               :mess-up entry)))
-    (push entry (lambda-entries (lexenv-lambda *lexenv*)))
-    (setf (entry-cleanup entry) cleanup)
-    (prev-link entry start)
-    (use-continuation entry dummy)
-
-    (collect ((tags)
-             (starts)
-             (conts))
-      (starts dummy)
-      (dolist (segment (rest segments))
-       (let* ((tag-cont (make-continuation))
-               (tag (list (car segment) entry tag-cont)))          
-         (conts tag-cont)
-         (starts tag-cont)
-         (continuation-starts-block tag-cont)
-          (tags tag)
-          (push (cdr tag) (continuation-lexenv-uses tag-cont))))
-      (conts cont)
-
-      (let ((*lexenv* (make-lexenv :cleanup cleanup :tags (tags))))
-       (mapc #'(lambda (segment start cont)
-                 (ir1-convert-progn-body start cont (rest segment)))
-             segments (starts) (conts))))))
-
-;;; Emit an Exit node without any value.
-(def-ir1-translator go ((tag) start cont)
-  #!+sb-doc
-  "Go Tag
-  Transfer control to the named Tag in the lexically enclosing TAGBODY. This
-  is constrained to be used only within the dynamic extent of the TAGBODY."
-  (continuation-starts-block cont)
-  (let* ((found (or (lexenv-find tag tags :test #'eql)
-                   (compiler-error "Go to nonexistent tag: ~S." tag)))
-        (entry (first found))
-        (exit (make-exit :entry entry)))
-    (push exit (entry-exits entry))
-    (prev-link exit start)
-    (use-continuation exit (second found))))
-\f
-;;;; translators for compiler-magic special forms
-
-;;; Do stuff to do an EVAL-WHEN. This is split off from the IR1
-;;; convert method so that it can be shared by the special-case
-;;; top-level form processing code. We play with the dynamic
-;;; environment and eval stuff, then call Fun with a list of forms to
-;;; be processed at load time.
-;;;
-;;; Note: the EVAL situation is always ignored: this is conceptually a
-;;; compile-only implementation.
-;;;
-;;; We have to interact with the interpreter to ensure that the forms
-;;; get EVAL'ed exactly once. We bind *ALREADY-EVALED-THIS* to true to
-;;; inhibit evaluation of any enclosed EVAL-WHENs, either by IR1
-;;; conversion done by EVAL, or by conversion of the body for
-;;; load-time processing. If *ALREADY-EVALED-THIS* is true then we *do
-;;; not* EVAL since some enclosing EVAL-WHEN already did.
-;;;
-;;; We know we are EVAL'ing for LOAD since we wouldn't get called
-;;; otherwise. If LOAD is a situation we call FUN on body. If we
-;;; aren't evaluating for LOAD, then we call FUN on NIL for the result
-;;; of the EVAL-WHEN.
-(defun do-eval-when-stuff (situations body fun)
-
-  (when (or (not (listp situations))
-           (set-difference situations
-                           '(compile load eval
-                             :compile-toplevel :load-toplevel :execute)))
-    (compiler-error "bad EVAL-WHEN situation list: ~S" situations))
-
-  (let ((deprecated-names (intersection situations '(compile load eval))))
-    (when deprecated-names
-      (style-warn "using deprecated EVAL-WHEN situation names ~S"
-                 deprecated-names)))
-
-  (let* ((do-eval (and (intersection '(compile :compile-toplevel) situations)
-                      (not sb!eval::*already-evaled-this*)))
-        (sb!eval::*already-evaled-this* t))
-    (when do-eval
-
-      ;; This is the natural way to do it.
-      #-(and sb-xc-host (or sbcl cmu))
-      (eval `(progn ,@body))
-
-      ;; This is a disgusting hack to work around bug IR1-3 when using
-      ;; SBCL (or CMU CL, for that matter) as a cross-compilation
-      ;; host. When we go from the cross-compiler (where we bound
-      ;; SB!EVAL::*ALREADY-EVALED-THIS*) to the host compiler (which
-      ;; has a separate SB-EVAL::*ALREADY-EVALED-THIS* variable), EVAL
-      ;; would go and execute nested EVAL-WHENs even when they're not
-      ;; toplevel forms. Using EVAL-WHEN instead of bare EVAL causes
-      ;; the cross-compilation host to bind its own
-      ;; *ALREADY-EVALED-THIS* variable, so that the problem is
-      ;; suppressed.
-      ;;
-      ;; FIXME: Once bug IR1-3 is fixed, this hack can go away. (Or if
-      ;; CMU CL doesn't fix the bug, then this hack can be made
-      ;; conditional on #+CMU.)
-      #+(and sb-xc-host (or sbcl cmu))
-      (let (#+sbcl (sb-eval::*already-evaled-this* t)
-           #+cmu (common-lisp::*already-evaled-this* t))
-       (eval `(eval-when (:compile-toplevel :load-toplevel :execute)
-                ,@body))))
-
-    (if (or (intersection '(:load-toplevel load) situations)
-           (and *converting-for-interpreter*
-                (intersection '(:execute eval) situations)))
-       (funcall fun body)
-       (funcall fun '(nil)))))
-
-(def-ir1-translator eval-when ((situations &rest body) start cont)
-  #!+sb-doc
-  "EVAL-WHEN (Situation*) Form*
-  Evaluate the Forms in the specified Situations, any of COMPILE, LOAD, EVAL.
-  This is conceptually a compile-only implementation, so EVAL is a no-op."
-
-  ;; It's difficult to handle EVAL-WHENs completely correctly in the
-  ;; cross-compiler. (Common Lisp is not a cross-compiler-friendly
-  ;; language..) Since we, the system implementors, control not only
-  ;; the cross-compiler but also the code that it processes, we can
-  ;; handle this either by making the cross-compiler smarter about
-  ;; handling EVAL-WHENs (hard) or by avoiding the use of difficult
-  ;; EVAL-WHEN constructs (relatively easy). However, since EVAL-WHENs
-  ;; can be generated by many macro expansions, it's not always easy
-  ;; to detect problems by skimming the source code, so we'll try to
-  ;; add some code here to help out.
-  ;;
-  ;; Nested EVAL-WHENs are tricky.
-  #+sb-xc-host
-  (labels ((contains-toplevel-eval-when-p (body-part)
-            (and (consp body-part)
-                 (or (eq (first body-part) 'eval-when)
-                     (and (member (first body-part)
-                                  '(locally macrolet progn symbol-macrolet))
-                          (some #'contains-toplevel-eval-when-p
-                                (rest body-part)))))))
-    (/show "testing for nested EVAL-WHENs" body)
-    (when (some #'contains-toplevel-eval-when-p body)
-      (compiler-style-warning "nested EVAL-WHENs in cross-compilation")))
-
-  (do-eval-when-stuff situations
-                     body
-                     (lambda (forms)
-                       (ir1-convert-progn-body start cont forms))))
-
-;;; Like DO-EVAL-WHEN-STUFF, only do a MACROLET. FUN is not passed any
-;;; arguments.
-(defun do-macrolet-stuff (definitions fun)
-  (declare (list definitions) (type function fun))
-  (let ((whole (gensym "WHOLE"))
-       (environment (gensym "ENVIRONMENT")))
-    (collect ((new-fenv))
-      (dolist (def definitions)
-       (let ((name (first def))
-             (arglist (second def))
-             (body (cddr def)))
-         (unless (symbolp name)
-           (compiler-error "The local macro name ~S is not a symbol." name))
-         (when (< (length def) 2)
-           (compiler-error
-            "The list ~S is too short to be a legal local macro definition."
-            name))
-         (multiple-value-bind (body local-decs)
-             (parse-defmacro arglist whole body name 'macrolet
-                             :environment environment)
-           (new-fenv `(,(first def) macro .
-                       ,(coerce `(lambda (,whole ,environment)
-                                   ,@local-decs (block ,name ,body))
-                                'function))))))
-
-      (let ((*lexenv* (make-lexenv :functions (new-fenv))))
-       (funcall fun))))
-
-  (values))
-
-(def-ir1-translator macrolet ((definitions &rest body) start cont)
-  #!+sb-doc
-  "MACROLET ({(Name Lambda-List Form*)}*) Body-Form*
-  Evaluate the Body-Forms in an environment with the specified local macros
-  defined. Name is the local macro name, Lambda-List is the DEFMACRO style
-  destructuring lambda list, and the Forms evaluate to the expansion. The
-  Forms are evaluated in the null environment."
-  (do-macrolet-stuff definitions
-                    #'(lambda ()
-                        (ir1-convert-progn-body start cont body))))
-
-;;; not really a special form, but..
-(def-ir1-translator declare ((&rest stuff) start cont)
-  (declare (ignore stuff))
-  ;; We ignore START and CONT too, but we can't use DECLARE IGNORE to
-  ;; tell the compiler about it here, because the DEF-IR1-TRANSLATOR
-  ;; macro would put the DECLARE in the wrong place, so..
-  start cont
-  (compiler-error "misplaced declaration"))
-\f
-;;;; %PRIMITIVE
-;;;;
-;;;; Uses of %PRIMITIVE are either expanded into Lisp code or turned
-;;;; into a funny function.
-
-;;; Carefully evaluate a list of forms, returning a list of the results.
-(defun eval-info-args (args)
-  (declare (list args))
-  (handler-case (mapcar #'eval args)
-    (error (condition)
-      (compiler-error "Lisp error during evaluation of info args:~%~A"
-                     condition))))
-
-;;; a hashtable that translates from primitive names to translation functions
-(defvar *primitive-translators* (make-hash-table :test 'eq))
-
-;;; If there is a primitive translator, then we expand the call.
-;;; Otherwise, we convert to the %%PRIMITIVE funny function. The first
-;;; argument is the template, the second is a list of the results of
-;;; any codegen-info args, and the remaining arguments are the runtime
-;;; arguments.
-;;;
-;;; We do a bunch of error checking now so that we don't bomb out with
-;;; a fatal error during IR2 conversion.
-;;;
-;;; KLUDGE: It's confusing having multiple names floating around for
-;;; nearly the same concept: PRIMITIVE, TEMPLATE, VOP. Might it be
-;;; possible to reimplement BYTE-BLT (the only use of
-;;; *PRIMITIVE-TRANSLATORS*) some other way, then get rid of primitive
-;;; translators altogether, so that there would be no distinction
-;;; between primitives and vops? Then we could call primitives vops,
-;;; rename TEMPLATE to VOP-TEMPLATE, rename BACKEND-TEMPLATE-NAMES to
-;;; BACKEND-VOPS, and rename %PRIMITIVE to VOP.. -- WHN 19990906
-;;; FIXME: Look at doing this ^, it doesn't look too hard actually. I
-;;; think BYTE-BLT could probably just become an inline function.
-(def-ir1-translator %primitive ((&whole form name &rest args) start cont)
-
-  (unless (symbolp name)
-    (compiler-error "The primitive name ~S is not a symbol." name))
-
-  (let* ((translator (gethash name *primitive-translators*)))
-    (if translator
-       (ir1-convert start cont (funcall translator (cdr form)))
-       (let* ((template (or (gethash name *backend-template-names*)
-                            (compiler-error
-                             "The primitive name ~A is not defined."
-                             name)))
-              (required (length (template-arg-types template)))
-              (info (template-info-arg-count template))
-              (min (+ required info))
-              (nargs (length args)))
-         (if (template-more-args-type template)
-             (when (< nargs min)
-               (compiler-error "Primitive ~A was called with ~R argument~:P, ~
-                                but wants at least ~R."
-                               name
-                               nargs
-                               min))
-             (unless (= nargs min)
-               (compiler-error "Primitive ~A was called with ~R argument~:P, ~
-                                but wants exactly ~R."
-                               name
-                               nargs
-                               min)))
-
-         (when (eq (template-result-types template) :conditional)
-           (compiler-error
-            "%PRIMITIVE was used with a conditional template."))
-
-         (when (template-more-results-type template)
-           (compiler-error
-            "%PRIMITIVE was used with an unknown values template."))
-
-         (ir1-convert start
-                      cont
-                     `(%%primitive ',template
-                                   ',(eval-info-args
-                                      (subseq args required min))
-                                   ,@(subseq args 0 required)
-                                   ,@(subseq args min)))))))
-\f
-;;;; QUOTE and FUNCTION
-
-(def-ir1-translator quote ((thing) start cont)
-  #!+sb-doc
-  "QUOTE Value
-  Return Value without evaluating it."
-  (reference-constant start cont thing))
-
-(def-ir1-translator function ((thing) start cont)
-  #!+sb-doc
-  "FUNCTION Name
-  Return the lexically apparent definition of the function Name. Name may also
-  be a lambda."
-  (if (consp thing)
-      (case (car thing)
-       ((lambda)
-        (reference-leaf start cont (ir1-convert-lambda thing)))
-       ((setf)
-        (let ((var (find-lexically-apparent-function
-                    thing "as the argument to FUNCTION")))
-          (reference-leaf start cont var)))
-       ((instance-lambda)
-        (let ((res (ir1-convert-lambda `(lambda ,@(cdr thing)))))
-          (setf (getf (functional-plist res) :fin-function) t)
-          (reference-leaf start cont res)))
-       (t
-        (compiler-error "~S is not a legal function name." thing)))
-      (let ((var (find-lexically-apparent-function
-                 thing "as the argument to FUNCTION")))
-       (reference-leaf start cont var))))
-\f
-;;;; FUNCALL
-
-;;; FUNCALL is implemented on %FUNCALL, which can only call functions
-;;; (not symbols). %FUNCALL is used directly in some places where the
-;;; call should always be open-coded even if FUNCALL is :NOTINLINE.
-(deftransform funcall ((function &rest args) * * :when :both)
-  (let ((arg-names (make-gensym-list (length args))))
-    `(lambda (function ,@arg-names)
-       (%funcall ,(if (csubtypep (continuation-type function)
-                                (specifier-type 'function))
-                     'function
-                     '(%coerce-callable-to-function function))
-                ,@arg-names))))
-
-(def-ir1-translator %funcall ((function &rest args) start cont)
-  (let ((fun-cont (make-continuation)))
-    (ir1-convert start fun-cont function)
-    (assert-continuation-type fun-cont (specifier-type 'function))
-    (ir1-convert-combination-args fun-cont cont args)))
-
-;;; This source transform exists to reduce the amount of work for the
-;;; compiler. If the called function is a FUNCTION form, then convert
-;;; directly to %FUNCALL, instead of waiting around for type
-;;; inference.
-(def-source-transform funcall (function &rest args)
-  (if (and (consp function) (eq (car function) 'function))
-      `(%funcall ,function ,@args)
-      (values nil t)))
-
-(deftransform %coerce-callable-to-function ((thing) (function) *
-                                           :when :both
-                                           :important t)
-  "optimize away possible call to FDEFINITION at runtime"
-  'thing)
-\f
-;;;; symbol macros
-
-(def-ir1-translator symbol-macrolet ((specs &body body) start cont)
-  #!+sb-doc
-  "SYMBOL-MACROLET ({(Name Expansion)}*) Decl* Form*
-  Define the Names as symbol macros with the given Expansions. Within the
-  body, references to a Name will effectively be replaced with the Expansion."
-  (multiple-value-bind (forms decls) (sb!sys:parse-body body nil)
-    (collect ((res))
-      (dolist (spec specs)
-       (unless (proper-list-of-length-p spec 2)
-         (compiler-error "The symbol macro binding ~S is malformed." spec))
-       (let ((name (first spec))
-             (def (second spec)))
-         (unless (symbolp name)
-           (compiler-error "The symbol macro name ~S is not a symbol." name))
-         (when (assoc name (res) :test #'eq)
-           (compiler-style-warning
-            "The name ~S occurs more than once in SYMBOL-MACROLET."
-            name))
-         (res `(,name . (MACRO . ,def)))))
-
-      (let* ((*lexenv* (make-lexenv :variables (res)))
-            (*lexenv* (process-decls decls (res) nil cont)))
-       (ir1-convert-progn-body start cont forms)))))
-\f
-;;; This is a frob that DEFSTRUCT expands into to establish the compiler
-;;; semantics. The other code in the expansion and %%COMPILER-DEFSTRUCT do
-;;; most of the work, we just clear all of the functions out of
-;;; *FREE-FUNCTIONS* to keep things in synch. %%COMPILER-DEFSTRUCT is also
-;;; called at load-time.
-(def-ir1-translator %compiler-defstruct ((info) start cont :kind :function)
-  (let* ((info (eval info)))
-    (%%compiler-defstruct info)
-    (dolist (slot (dd-slots info))
-      (let ((fun (dsd-accessor slot)))
-       (remhash fun *free-functions*)
-       (unless (dsd-read-only slot)
-         (remhash `(setf ,fun) *free-functions*))))
-    (remhash (dd-predicate info) *free-functions*)
-    (remhash (dd-copier info) *free-functions*)
-    (ir1-convert start cont `(%%compiler-defstruct ',info))))
-
-;;; Return the contents of a quoted form.
-(defun unquote (x)
-  (if (and (consp x)
-          (= 2 (length x))
-          (eq 'quote (first x)))
-    (second x)
-    (error "not a quoted form")))
-
-;;; Don't actually compile anything, instead call the function now.
-(def-ir1-translator %compiler-only-defstruct
-                   ((info inherits) start cont :kind :function)
-  (function-%compiler-only-defstruct (unquote info) (unquote inherits))
-  (reference-constant start cont nil))
-\f
-;;;; LET and LET*
-;;;;
-;;;; (LET and LET* can't be implemented as macros due to the fact that
-;;;; any pervasive declarations also affect the evaluation of the
-;;;; arguments.)
-
-;;; Given a list of binding specifiers in the style of Let, return:
-;;;  1. The list of var structures for the variables bound.
-;;;  2. The initial value form for each variable.
-;;;
-;;; The variable names are checked for legality and globally special
-;;; variables are marked as such. Context is the name of the form, for
-;;; error reporting purposes.
-(declaim (ftype (function (list symbol) (values list list list))
-               extract-let-variables))
-(defun extract-let-variables (bindings context)
-  (collect ((vars)
-           (vals)
-           (names))
-    (flet ((get-var (name)
-            (varify-lambda-arg name
-                               (if (eq context 'let*)
-                                   nil
-                                   (names)))))
-      (dolist (spec bindings)
-       (cond ((atom spec)
-              (let ((var (get-var spec)))
-                (vars var)
-                (names (cons spec var))
-                (vals nil)))
-             (t
-              (unless (proper-list-of-length-p spec 1 2)
-                (compiler-error "The ~S binding spec ~S is malformed."
-                                context
-                                spec))
-              (let* ((name (first spec))
-                     (var (get-var name)))
-                (vars var)
-                (names name)
-                (vals (second spec)))))))
-
-    (values (vars) (vals) (names))))
-
-(def-ir1-translator let ((bindings &body body)
-                        start cont)
-  #!+sb-doc
-  "LET ({(Var [Value]) | Var}*) Declaration* Form*
-  During evaluation of the Forms, bind the Vars to the result of evaluating the
-  Value forms. The variables are bound in parallel after all of the Values are
-  evaluated."
-  (multiple-value-bind (forms decls) (sb!sys:parse-body body nil)
-    (multiple-value-bind (vars values) (extract-let-variables bindings 'let)
-      (let* ((*lexenv* (process-decls decls vars nil cont))
-            (fun-cont (make-continuation))
-            (fun (ir1-convert-lambda-body forms vars)))
-       (reference-leaf start fun-cont fun)
-       (ir1-convert-combination-args fun-cont cont values)))))
-
-(def-ir1-translator let* ((bindings &body body)
-                         start cont)
-  #!+sb-doc
-  "LET* ({(Var [Value]) | Var}*) Declaration* Form*
-  Similar to LET, but the variables are bound sequentially, allowing each Value
-  form to reference any of the previous Vars."
-  (multiple-value-bind (forms decls) (sb!sys:parse-body body nil)
-    (multiple-value-bind (vars values) (extract-let-variables bindings 'let*)
-      (let ((*lexenv* (process-decls decls vars nil cont)))
-       (ir1-convert-aux-bindings start cont forms vars values nil)))))
-
-;;; This is a lot like a LET* with no bindings. Unlike LET*, LOCALLY
-;;; has to preserves top-level-formness, but we don't need to worry
-;;; about that here, because special logic in the compiler main loop
-;;; grabs top-level LOCALLYs and takes care of them before this
-;;; transform ever sees them.
-(def-ir1-translator locally ((&body body)
-                            start cont)
-  #!+sb-doc
-  "LOCALLY Declaration* Form*
-  Sequentially evaluate the Forms in a lexical environment where the
-  the Declarations have effect. If LOCALLY is a top-level form, then
-  the Forms are also processed as top-level forms."
-  (multiple-value-bind (forms decls) (sb!sys:parse-body body nil)
-    (let ((*lexenv* (process-decls decls nil nil cont)))
-      (ir1-convert-aux-bindings start cont forms nil nil nil))))
-\f
-;;;; FLET and LABELS
-
-;;; Given a list of local function specifications in the style of
-;;; Flet, return lists of the function names and of the lambdas which
-;;; are their definitions.
-;;;
-;;; The function names are checked for legality. Context is the name
-;;; of the form, for error reporting.
-(declaim (ftype (function (list symbol) (values list list))
-               extract-flet-variables))
-(defun extract-flet-variables (definitions context)
-  (collect ((names)
-           (defs))
-    (dolist (def definitions)
-      (when (or (atom def) (< (length def) 2))
-       (compiler-error "The ~S definition spec ~S is malformed." context def))
-
-      (let ((name (check-function-name (first def))))
-       (names name)
-       (multiple-value-bind (forms decls) (sb!sys:parse-body (cddr def))
-         (defs `(lambda ,(second def)
-                  ,@decls
-                  (block ,(function-name-block-name name)
-                    . ,forms))))))
-    (values (names) (defs))))
-
-(def-ir1-translator flet ((definitions &body body)
-                         start cont)
-  #!+sb-doc
-  "FLET ({(Name Lambda-List Declaration* Form*)}*) Declaration* Body-Form*
-  Evaluate the Body-Forms with some local function definitions. The bindings
-  do not enclose the definitions; any use of Name in the Forms will refer to
-  the lexically apparent function definition in the enclosing environment."
-  (multiple-value-bind (forms decls) (sb!sys:parse-body body nil)
-    (multiple-value-bind (names defs)
-       (extract-flet-variables definitions 'flet)
-      (let* ((fvars (mapcar (lambda (n d)
-                             (ir1-convert-lambda d n))
-                           names defs))
-            (*lexenv* (make-lexenv
-                       :default (process-decls decls nil fvars cont)
-                       :functions (pairlis names fvars))))
-       (ir1-convert-progn-body start cont forms)))))
-
-;;; For LABELS, we have to create dummy function vars and add them to
-;;; the function namespace while converting the functions. We then
-;;; modify all the references to these leaves so that they point to
-;;; the real functional leaves. We also backpatch the FENV so that if
-;;; the lexical environment is used for inline expansion we will get
-;;; the right functions.
-(def-ir1-translator labels ((definitions &body body) start cont)
-  #!+sb-doc
-  "LABELS ({(Name Lambda-List Declaration* Form*)}*) Declaration* Body-Form*
-  Evaluate the Body-Forms with some local function definitions. The bindings
-  enclose the new definitions, so the defined functions can call themselves or
-  each other."
-  (multiple-value-bind (forms decls) (sb!sys:parse-body body nil)
-    (multiple-value-bind (names defs)
-       (extract-flet-variables definitions 'labels)
-      (let* ((new-fenv (loop for name in names
-                            collect (cons name (make-functional :name name))))
-            (real-funs
-             (let ((*lexenv* (make-lexenv :functions new-fenv)))
-               (mapcar (lambda (n d)
-                         (ir1-convert-lambda d n))
-                       names defs))))
-
-       (loop for real in real-funs and env in new-fenv do
-             (let ((dum (cdr env)))
-               (substitute-leaf real dum)
-               (setf (cdr env) real)))
-
-       (let ((*lexenv* (make-lexenv
-                        :default (process-decls decls nil real-funs cont)
-                        :functions (pairlis names real-funs))))
-         (ir1-convert-progn-body start cont forms))))))
-\f
-;;;; THE
-
-;;; Do stuff to recognize a THE or VALUES declaration. CONT is the
-;;; continuation that the assertion applies to, TYPE is the type
-;;; specifier and Lexenv is the current lexical environment. NAME is
-;;; the name of the declaration we are doing, for use in error
-;;; messages.
-;;;
-;;; This is somewhat involved, since a type assertion may only be made
-;;; on a continuation, not on a node. We can't just set the
-;;; continuation asserted type and let it go at that, since there may
-;;; be parallel THE's for the same continuation, i.e.:
-;;;     (if ...
-;;;     (the foo ...)
-;;;     (the bar ...))
-;;;
-;;; In this case, our representation can do no better than the union
-;;; of these assertions. And if there is a branch with no assertion,
-;;; we have nothing at all. We really need to recognize scoping, since
-;;; we need to be able to discern between parallel assertions (which
-;;; we union) and nested ones (which we intersect).
-;;;
-;;; We represent the scoping by throwing our innermost (intersected)
-;;; assertion on CONT into the TYPE-RESTRICTIONS. As we go down, we
-;;; intersect our assertions together. If CONT has no uses yet, we
-;;; have not yet bottomed out on the first COND branch; in this case
-;;; we optimistically assume that this type will be the one we end up
-;;; with, and set the ASSERTED-TYPE to it. We can never get better
-;;; than the type that we have the first time we bottom out. Later
-;;; THE's (or the absence thereof) can only weaken this result.
-;;;
-;;; We make this work by getting USE-CONTINUATION to do the unioning
-;;; across COND branches. We can't do it here, since we don't know how
-;;; many branches there are going to be.
-(defun do-the-stuff (type cont lexenv name)
-  (declare (type continuation cont) (type lexenv lexenv))
-  (let* ((ctype (values-specifier-type type))
-        (old-type (or (lexenv-find cont type-restrictions)
-                      *wild-type*))
-        (intersects (values-types-intersect old-type ctype))
-        (int (values-type-intersection old-type ctype))
-        (new (if intersects int old-type)))
-    (when (null (find-uses cont))
-      (setf (continuation-asserted-type cont) new))
-    (when (and (not intersects)
-              (not (policy nil (= inhibit-warnings 3)))) ;FIXME: really OK to suppress?
-      (compiler-warning
-       "The type ~S in ~S declaration conflicts with an enclosing assertion:~%   ~S"
-       (type-specifier ctype)
-       name
-       (type-specifier old-type)))
-    (make-lexenv :type-restrictions `((,cont . ,new))
-                :default lexenv)))
-
-;;; Assert that FORM evaluates to the specified type (which may be a
-;;; VALUES type).
-;;;
-;;; FIXME: In a version of CMU CL that I used at Cadabra ca. 20000101,
-;;; this didn't seem to expand into an assertion, at least for ALIEN
-;;; values. Check that SBCL doesn't have this problem.
-(def-ir1-translator the ((type value) start cont)
-  (let ((*lexenv* (do-the-stuff type cont *lexenv* 'the)))
-    (ir1-convert start cont value)))
-
-;;; This is like the THE special form, except that it believes
-;;; whatever you tell it. It will never generate a type check, but
-;;; will cause a warning if the compiler can prove the assertion is
-;;; wrong.
-;;;
-;;; Since the CONTINUATION-DERIVED-TYPE is computed as the union of
-;;; its uses's types, setting it won't work. Instead we must intersect
-;;; the type with the uses's DERIVED-TYPE.
-(def-ir1-translator truly-the ((type value) start cont)
-  #!+sb-doc
-  (declare (inline member))
-  (let ((type (values-specifier-type type))
-       (old (find-uses cont)))
-    (ir1-convert start cont value)
-    (do-uses (use cont)
-      (unless (member use old :test #'eq)
-       (derive-node-type use type)))))
-\f
-;;;; SETQ
-
-;;; If there is a definition in LEXENV-VARIABLES, just set that,
-;;; otherwise look at the global information. If the name is for a
-;;; constant, then error out.
-(def-ir1-translator setq ((&whole source &rest things) start cont)
-  (let ((len (length things)))
-    (when (oddp len)
-      (compiler-error "odd number of args to SETQ: ~S" source))
-    (if (= len 2)
-       (let* ((name (first things))
-              (leaf (or (lexenv-find name variables)
-                        (find-free-variable name))))
-         (etypecase leaf
-           (leaf
-            (when (or (constant-p leaf)
-                      (and (global-var-p leaf)
-                           (eq (global-var-kind leaf) :constant)))
-              (compiler-error "~S is a constant and thus can't be set." name))
-            (when (and (lambda-var-p leaf)
-                       (lambda-var-ignorep leaf))
-              ;; ANSI's definition of "Declaration IGNORE, IGNORABLE"
-              ;; requires that this be a STYLE-WARNING, not a full warning.
-              (compiler-style-warning
-               "~S is being set even though it was declared to be ignored."
-               name))
-            (set-variable start cont leaf (second things)))
-           (cons
-            (assert (eq (car leaf) 'MACRO))
-            (ir1-convert start cont `(setf ,(cdr leaf) ,(second things))))
-           (heap-alien-info
-            (ir1-convert start cont
-                         `(%set-heap-alien ',leaf ,(second things))))))
-       (collect ((sets))
-         (do ((thing things (cddr thing)))
-             ((endp thing)
-              (ir1-convert-progn-body start cont (sets)))
-           (sets `(setq ,(first thing) ,(second thing))))))))
-
-;;; This is kind of like REFERENCE-LEAF, but we generate a SET node.
-;;; This should only need to be called in SETQ.
-(defun set-variable (start cont var value)
-  (declare (type continuation start cont) (type basic-var var))
-  (let ((dest (make-continuation)))
-    (setf (continuation-asserted-type dest) (leaf-type var))
-    (ir1-convert start dest value)
-    (let ((res (make-set :var var :value dest)))
-      (setf (continuation-dest dest) res)
-      (setf (leaf-ever-used var) t)
-      (push res (basic-var-sets var))
-      (prev-link res dest)
-      (use-continuation res cont))))
-\f
-;;;; CATCH, THROW and UNWIND-PROTECT
-
-;;; We turn THROW into a multiple-value-call of a magical function,
-;;; since as as far as IR1 is concerned, it has no interesting
-;;; properties other than receiving multiple-values.
-(def-ir1-translator throw ((tag result) start cont)
-  #!+sb-doc
-  "Throw Tag Form
-  Do a non-local exit, return the values of Form from the CATCH whose tag
-  evaluates to the same thing as Tag."
-  (ir1-convert start cont
-              `(multiple-value-call #'%throw ,tag ,result)))
-
-;;; This is a special special form used to instantiate a cleanup as
-;;; the current cleanup within the body. KIND is a the kind of cleanup
-;;; to make, and MESS-UP is a form that does the mess-up action. We
-;;; make the MESS-UP be the USE of the MESS-UP form's continuation,
-;;; and introduce the cleanup into the lexical environment. We
-;;; back-patch the ENTRY-CLEANUP for the current cleanup to be the new
-;;; cleanup, since this inner cleanup is the interesting one.
-(def-ir1-translator %within-cleanup ((kind mess-up &body body) start cont)
-  (let ((dummy (make-continuation))
-       (dummy2 (make-continuation)))
-    (ir1-convert start dummy mess-up)
-    (let* ((mess-node (continuation-use dummy))
-          (cleanup (make-cleanup :kind kind
-                                 :mess-up mess-node))
-          (old-cup (lexenv-cleanup *lexenv*))
-          (*lexenv* (make-lexenv :cleanup cleanup)))
-      (setf (entry-cleanup (cleanup-mess-up old-cup)) cleanup)
-      (ir1-convert dummy dummy2 '(%cleanup-point))
-      (ir1-convert-progn-body dummy2 cont body))))
-
-;;; This is a special special form that makes an "escape function"
-;;; which returns unknown values from named block. We convert the
-;;; function, set its kind to :ESCAPE, and then reference it. The
-;;; :Escape kind indicates that this function's purpose is to
-;;; represent a non-local control transfer, and that it might not
-;;; actually have to be compiled.
-;;;
-;;; Note that environment analysis replaces references to escape
-;;; functions with references to the corresponding NLX-INFO structure.
-(def-ir1-translator %escape-function ((tag) start cont)
-  (let ((fun (ir1-convert-lambda
-             `(lambda ()
-                (return-from ,tag (%unknown-values))))))
-    (setf (functional-kind fun) :escape)
-    (reference-leaf start cont fun)))
-
-;;; Yet another special special form. This one looks up a local
-;;; function and smashes it to a :CLEANUP function, as well as
-;;; referencing it.
-(def-ir1-translator %cleanup-function ((name) start cont)
-  (let ((fun (lexenv-find name functions)))
-    (assert (lambda-p fun))
-    (setf (functional-kind fun) :cleanup)
-    (reference-leaf start cont fun)))
-
-;;; We represent the possibility of the control transfer by making an
-;;; "escape function" that does a lexical exit, and instantiate the
-;;; cleanup using %WITHIN-CLEANUP.
-(def-ir1-translator catch ((tag &body body) start cont)
-  #!+sb-doc
-  "Catch Tag Form*
-  Evaluates Tag and instantiates it as a catcher while the body forms are
-  evaluated in an implicit PROGN. If a THROW is done to Tag within the dynamic
-  scope of the body, then control will be transferred to the end of the body
-  and the thrown values will be returned."
-  (ir1-convert
-   start cont
-   (let ((exit-block (gensym "EXIT-BLOCK-")))
-     `(block ,exit-block
-       (%within-cleanup
-           :catch
-           (%catch (%escape-function ,exit-block) ,tag)
-         ,@body)))))
-
-;;; UNWIND-PROTECT is similar to CATCH, but more hairy. We make the
-;;; cleanup forms into a local function so that they can be referenced
-;;; both in the case where we are unwound and in any local exits. We
-;;; use %CLEANUP-FUNCTION on this to indicate that reference by
-;;; %UNWIND-PROTECT ISN'T "real", and thus doesn't cause creation of
-;;; an XEP.
-(def-ir1-translator unwind-protect ((protected &body cleanup) start cont)
-  #!+sb-doc
-  "Unwind-Protect Protected Cleanup*
-  Evaluate the form Protected, returning its values. The cleanup forms are
-  evaluated whenever the dynamic scope of the Protected form is exited (either
-  due to normal completion or a non-local exit such as THROW)."
-  (ir1-convert
-   start cont
-   (let ((cleanup-fun (gensym "CLEANUP-FUN-"))
-        (drop-thru-tag (gensym "DROP-THRU-TAG-"))
-        (exit-tag (gensym "EXIT-TAG-"))
-        (next (gensym "NEXT"))
-        (start (gensym "START"))
-        (count (gensym "COUNT")))
-     `(flet ((,cleanup-fun () ,@cleanup nil))
-       ;; FIXME: If we ever get DYNAMIC-EXTENT working, then
-       ;; ,CLEANUP-FUN should probably be declared DYNAMIC-EXTENT,
-       ;; and something can be done to make %ESCAPE-FUNCTION have
-       ;; dynamic extent too.
-       (block ,drop-thru-tag
-         (multiple-value-bind (,next ,start ,count)
-             (block ,exit-tag
-               (%within-cleanup
-                   :unwind-protect
-                   (%unwind-protect (%escape-function ,exit-tag)
-                                    (%cleanup-function ,cleanup-fun))
-                 (return-from ,drop-thru-tag ,protected)))
-           (,cleanup-fun)
-           (%continue-unwind ,next ,start ,count)))))))
-\f
-;;;; multiple-value stuff
-
-;;; If there are arguments, MULTIPLE-VALUE-CALL turns into an
-;;; MV-COMBINATION.
-;;;
-;;; If there are no arguments, then we convert to a normal
-;;; combination, ensuring that a MV-COMBINATION always has at least
-;;; one argument. This can be regarded as an optimization, but it is
-;;; more important for simplifying compilation of MV-COMBINATIONS.
-(def-ir1-translator multiple-value-call ((fun &rest args) start cont)
-  #!+sb-doc
-  "MULTIPLE-VALUE-CALL Function Values-Form*
-  Call Function, passing all the values of each Values-Form as arguments,
-  values from the first Values-Form making up the first argument, etc."
-  (let* ((fun-cont (make-continuation))
-        (node (if args
-                  (make-mv-combination fun-cont)
-                  (make-combination fun-cont))))
-    (ir1-convert start fun-cont
-                (if (and (consp fun) (eq (car fun) 'function))
-                    fun
-                    `(%coerce-callable-to-function ,fun)))
-    (setf (continuation-dest fun-cont) node)
-    (assert-continuation-type fun-cont
-                             (specifier-type '(or function symbol)))
-    (collect ((arg-conts))
-      (let ((this-start fun-cont))
-       (dolist (arg args)
-         (let ((this-cont (make-continuation node)))
-           (ir1-convert this-start this-cont arg)
-           (setq this-start this-cont)
-           (arg-conts this-cont)))
-       (prev-link node this-start)
-       (use-continuation node cont)
-       (setf (basic-combination-args node) (arg-conts))))))
-
-;;; MULTIPLE-VALUE-PROG1 is represented implicitly in IR1 by having a
-;;; the result code use result continuation (CONT), but transfer
-;;; control to the evaluation of the body. In other words, the result
-;;; continuation isn't IMMEDIATELY-USED-P by the nodes that compute
-;;; the result.
-;;;
-;;; In order to get the control flow right, we convert the result with
-;;; a dummy result continuation, then convert all the uses of the
-;;; dummy to be uses of CONT. If a use is an EXIT, then we also
-;;; substitute CONT for the dummy in the corresponding ENTRY node so
-;;; that they are consistent. Note that this doesn't amount to
-;;; changing the exit target, since the control destination of an exit
-;;; is determined by the block successor; we are just indicating the
-;;; continuation that the result is delivered to.
-;;;
-;;; We then convert the body, using another dummy continuation in its
-;;; own block as the result. After we are done converting the body, we
-;;; move all predecessors of the dummy end block to CONT's block.
-;;;
-;;; Note that we both exploit and maintain the invariant that the CONT
-;;; to an IR1 convert method either has no block or starts the block
-;;; that control should transfer to after completion for the form.
-;;; Nested MV-PROG1's work because during conversion of the result
-;;; form, we use dummy continuation whose block is the true control
-;;; destination.
-(def-ir1-translator multiple-value-prog1 ((result &rest forms) start cont)
-  #!+sb-doc
-  "MULTIPLE-VALUE-PROG1 Values-Form Form*
-  Evaluate Values-Form and then the Forms, but return all the values of
-  Values-Form."
-  (continuation-starts-block cont)
-  (let* ((dummy-result (make-continuation))
-        (dummy-start (make-continuation))
-        (cont-block (continuation-block cont)))
-    (continuation-starts-block dummy-start)
-    (ir1-convert start dummy-start result)
-
-    (substitute-continuation-uses cont dummy-start)
-
-    (continuation-starts-block dummy-result)
-    (ir1-convert-progn-body dummy-start dummy-result forms)
-    (let ((end-block (continuation-block dummy-result)))
-      (dolist (pred (block-pred end-block))
-       (unlink-blocks pred end-block)
-       (link-blocks pred cont-block))
-      (assert (not (continuation-dest dummy-result)))
-      (delete-continuation dummy-result)
-      (remove-from-dfo end-block))))
-\f
-;;;; interface to defining macros
-
-;;;; FIXME:
-;;;;   classic CMU CL comment:
-;;;;     DEFMACRO and DEFUN expand into calls to %DEFxxx functions
-;;;;     so that we get a chance to see what is going on. We define
-;;;;     IR1 translators for these functions which look at the
-;;;;     definition and then generate a call to the %%DEFxxx function.
-;;;; Alas, this implementation doesn't do the right thing for
-;;;; non-toplevel uses of these forms, so this should probably
-;;;; be changed to use EVAL-WHEN instead.
-
-;;; Return a new source path with any stuff intervening between the
-;;; current path and the first form beginning with NAME stripped off.
-;;; This is used to hide the guts of DEFmumble macros to prevent
-;;; annoying error messages.
-(defun revert-source-path (name)
-  (do ((path *current-path* (cdr path)))
-      ((null path) *current-path*)
-    (let ((first (first path)))
-      (when (or (eq first name)
-               (eq first 'original-source-start))
-       (return path)))))
-
-;;; Warn about incompatible or illegal definitions and add the macro
-;;; to the compiler environment.
-;;;
-;;; Someday we could check for macro arguments being incompatibly
-;;; redefined. Doing this right will involve finding the old macro
-;;; lambda-list and comparing it with the new one.
-(def-ir1-translator %defmacro ((qname qdef lambda-list doc) start cont
-                              :kind :function)
-  (let (;; QNAME is typically a quoted name. I think the idea is to let
-       ;; %DEFMACRO work as an ordinary function when interpreting. Whatever
-       ;; the reason it's there, we don't want it any more. -- WHN 19990603
-       (name (eval qname))
-       ;; QDEF should be a sharp-quoted definition. We don't want to make a
-       ;; function of it just yet, so we just drop the sharp-quote.
-       (def (progn
-              (assert (eq 'function (first qdef)))
-              (assert (proper-list-of-length-p qdef 2))
-              (second qdef))))
-
-    (unless (symbolp name)
-      (compiler-error "The macro name ~S is not a symbol." name))
-
-    (ecase (info :function :kind name)
-      ((nil))
-      (:function
-       (remhash name *free-functions*)
-       (undefine-function-name name)
-       (compiler-warning
-       "~S is being redefined as a macro when it was previously ~(~A~) to be a function."
-       name
-       (info :function :where-from name)))
-      (:macro)
-      (:special-form
-       (compiler-error "The special form ~S can't be redefined as a macro."
-                      name)))
-
-    (setf (info :function :kind name) :macro
-         (info :function :where-from name) :defined
-         (info :function :macro-function name) (coerce def 'function))
-
-    (let* ((*current-path* (revert-source-path 'defmacro))
-          (fun (ir1-convert-lambda def name)))
-      (setf (leaf-name fun)
-           (concatenate 'string "DEFMACRO " (symbol-name name)))
-      (setf (functional-arg-documentation fun) (eval lambda-list))
-
-      (ir1-convert start cont `(%%defmacro ',name ,fun ,doc)))
-
-    (when sb!xc:*compile-print*
-      ;; FIXME: It would be nice to convert this, and the other places
-      ;; which create compiler diagnostic output prefixed by
-      ;; semicolons, to use some common utility which automatically
-      ;; prefixes all its output with semicolons. (The addition of
-      ;; semicolon prefixes was introduced ca. sbcl-0.6.8.10 as the
-      ;; "MNA compiler message patch", and implemented by modifying a
-      ;; bunch of output statements on a case-by-case basis, which
-      ;; seems unnecessarily error-prone and unclear, scattering
-      ;; implicit information about output style throughout the
-      ;; system.) Starting by rewriting COMPILER-MUMBLE to add
-      ;; semicolon prefixes would be a good start, and perhaps also:
-      ;;   * Add semicolon prefixes for "FOO assembled" messages emitted 
-      ;;     when e.g. src/assembly/x86/assem-rtns.lisp is processed.
-      ;;   * At least some debugger output messages deserve semicolon
-      ;;     prefixes too:
-      ;;     ** restarts table
-      ;;     ** "Within the debugger, you can type HELP for help."
-      (compiler-mumble "~&; converted ~S~%" name))))
-
-(def-ir1-translator %define-compiler-macro ((name def lambda-list doc)
-                                           start cont
-                                           :kind :function)
-  (let ((name (eval name))
-       (def (second def))) ; We don't want to make a function just yet...
-
-    (when (eq (info :function :kind name) :special-form)
-      (compiler-error "attempt to define a compiler-macro for special form ~S"
-                     name))
-
-    (setf (info :function :compiler-macro-function name)
-         (coerce def 'function))
-
-    (let* ((*current-path* (revert-source-path 'define-compiler-macro))
-          (fun (ir1-convert-lambda def name)))
-      (setf (leaf-name fun)
-           (let ((*print-case* :upcase))
-             (format nil "DEFINE-COMPILER-MACRO ~S" name)))
-      (setf (functional-arg-documentation fun) (eval lambda-list))
-
-      (ir1-convert start cont `(%%define-compiler-macro ',name ,fun ,doc)))
-
-    (when sb!xc:*compile-print*
-      (compiler-mumble "~&; converted ~S~%" name))))
-\f
-;;;; defining global functions
-
-;;; Convert FUN as a lambda in the null environment, but use the
-;;; current compilation policy. Note that FUN may be a
-;;; LAMBDA-WITH-ENVIRONMENT, so we may have to augment the environment
-;;; to reflect the state at the definition site.
-(defun ir1-convert-inline-lambda (fun &optional name)
-  (destructuring-bind (decls macros symbol-macros &rest body)
-                     (if (eq (car fun) 'lambda-with-environment)
-                         (cdr fun)
-                         `(() () () . ,(cdr fun)))
-    (let ((*lexenv* (make-lexenv
-                    :default (process-decls decls nil nil
-                                            (make-continuation)
-                                            (make-null-lexenv))
-                    :variables (copy-list symbol-macros)
-                    :functions
-                    (mapcar #'(lambda (x)
-                                `(,(car x) .
-                                  (macro . ,(coerce (cdr x) 'function))))
-                            macros)
-                    :policy (lexenv-policy *lexenv*)
-                    :interface-policy (lexenv-interface-policy *lexenv*))))
-      (ir1-convert-lambda `(lambda ,@body) name))))
-
-;;; Return a lambda that has been "closed" with respect to ENV,
-;;; returning a LAMBDA-WITH-ENVIRONMENT if there are interesting
-;;; macros or declarations. If there is something too complex (like a
-;;; lexical variable) in the environment, then we return NIL.
-(defun inline-syntactic-closure-lambda (lambda &optional (env *lexenv*))
-  (let ((variables (lexenv-variables env))
-       (functions (lexenv-functions env))
-       (decls ())
-       (symmacs ())
-       (macros ()))
-    (cond ((or (lexenv-blocks env) (lexenv-tags env)) nil)
-         ((and (null variables) (null functions))
-          lambda)
-         ((dolist (x variables nil)
-            (let ((name (car x))
-                  (what (cdr x)))
-              (when (eq x (assoc name variables :test #'eq))
-                (typecase what
-                  (cons
-                   (assert (eq (car what) 'macro))
-                   (push x symmacs))
-                  (global-var
-                   (assert (eq (global-var-kind what) :special))
-                   (push `(special ,name) decls))
-                  (t (return t))))))
-          nil)
-         ((dolist (x functions nil)
-            (let ((name (car x))
-                  (what (cdr x)))
-              (when (eq x (assoc name functions :test #'equal))
-                (typecase what
-                  (cons
-                   (push (cons name
-                               (function-lambda-expression (cdr what)))
-                         macros))
-                  (global-var
-                   (when (defined-function-p what)
-                     (push `(,(car (rassoc (defined-function-inlinep what)
-                                           *inlinep-translations*))
-                             ,name)
-                           decls)))
-                  (t (return t))))))
-          nil)
-         (t
-          `(lambda-with-environment ,decls
-                                    ,macros
-                                    ,symmacs
-                                    . ,(rest lambda))))))
-
-;;; Get a DEFINED-FUNCTION object for a function we are about to
-;;; define. If the function has been forward referenced, then
-;;; substitute for the previous references.
-(defun get-defined-function (name)
-  (let* ((name (proclaim-as-function-name name))
-        (found (find-free-function name "Eh?")))
-    (note-name-defined name :function)
-    (cond ((not (defined-function-p found))
-          (assert (not (info :function :inlinep name)))
-          (let* ((where-from (leaf-where-from found))
-                 (res (make-defined-function
-                       :name name
-                       :where-from (if (eq where-from :declared)
-                                       :declared :defined)
-                       :type (leaf-type found))))
-            (substitute-leaf res found)
-            (setf (gethash name *free-functions*) res)))
-         ;; If *FREE-FUNCTIONS* has a previously converted definition for this
-         ;; name, then blow it away and try again.
-         ((defined-function-functional found)
-          (remhash name *free-functions*)
-          (get-defined-function name))
-         (t found))))
-
-;;; Check a new global function definition for consistency with
-;;; previous declaration or definition, and assert argument/result
-;;; types if appropriate. This assertion is suppressed by the
-;;; EXPLICIT-CHECK attribute, which is specified on functions that
-;;; check their argument types as a consequence of type dispatching.
-;;; This avoids redundant checks such as NUMBERP on the args to +,
-;;; etc.
-(defun assert-new-definition (var fun)
-  (let ((type (leaf-type var))
-       (for-real (eq (leaf-where-from var) :declared))
-       (info (info :function :info (leaf-name var))))
-    (assert-definition-type
-     fun type
-     ;; KLUDGE: Common Lisp is such a dynamic language that in general
-     ;; all we can do here in general is issue a STYLE-WARNING. It
-     ;; would be nice to issue a full WARNING in the special case of
-     ;; of type mismatches within a compilation unit (as in section
-     ;; 3.2.2.3 of the spec) but at least as of sbcl-0.6.11, we don't
-     ;; keep track of whether the mismatched data came from the same
-     ;; compilation unit, so we can't do that. -- WHN 2001-02-11
-     ;;
-     ;; FIXME: Actually, I think we could issue a full WARNING if the
-     ;; new definition contradicts a DECLAIM FTYPE.
-     :error-function #'compiler-style-warning
-     :warning-function (cond (info #'compiler-style-warning)
-                            (for-real #'compiler-note)
-                            (t nil))
-     :really-assert
-     (and for-real
-         (not (and info
-                   (ir1-attributep (function-info-attributes info)
-                                   explicit-check))))
-     :where (if for-real
-               "previous declaration"
-               "previous definition"))))
-
-;;; Convert a lambda doing all the basic stuff we would do if we were
-;;; converting a DEFUN. This is used both by the %DEFUN translator and
-;;; for global inline expansion.
-;;;
-;;; Unless a :INLINE function, we temporarily clobber the inline
-;;; expansion. This prevents recursive inline expansion of
-;;; opportunistic pseudo-inlines.
-(defun ir1-convert-lambda-for-defun (lambda var expansion converter)
-  (declare (cons lambda) (function converter) (type defined-function var))
-  (let ((var-expansion (defined-function-inline-expansion var)))
-    (unless (eq (defined-function-inlinep var) :inline)
-      (setf (defined-function-inline-expansion var) nil))
-    (let* ((name (leaf-name var))
-          (fun (funcall converter lambda name))
-          (function-info (info :function :info name)))
-      (setf (functional-inlinep fun) (defined-function-inlinep var))
-      (assert-new-definition var fun)
-      (setf (defined-function-inline-expansion var) var-expansion)
-      ;; If definitely not an interpreter stub, then substitute for any
-      ;; old references.
-      (unless (or (eq (defined-function-inlinep var) :notinline)
-                 (not *block-compile*)
-                 (and function-info
-                      (or (function-info-transforms function-info)
-                          (function-info-templates function-info)
-                          (function-info-ir2-convert function-info))))
-       (substitute-leaf fun var)
-       ;; If in a simple environment, then we can allow backward
-       ;; references to this function from following top-level forms.
-       (when expansion (setf (defined-function-functional var) fun)))
-      fun)))
-
-;;; Convert the definition and install it in the global environment
-;;; with a LABELS-like effect. If the lexical environment is not null,
-;;; then we only install the definition during the processing of this
-;;; DEFUN, ensuring that the function cannot be called outside of the
-;;; correct environment. If the function is globally NOTINLINE, then
-;;; that inhibits even local substitution. Also, emit top-level code
-;;; to install the definition.
-;;;
-;;; This is one of the major places where the semantics of block
-;;; compilation is handled. Substitution for global names is totally
-;;; inhibited if *BLOCK-COMPILE* is NIL. And if *BLOCK-COMPILE* is
-;;; true and entry points are specified, then we don't install global
-;;; definitions for non-entry functions (effectively turning them into
-;;; local lexical functions.)
-(def-ir1-translator %defun ((name def doc source) start cont
-                           :kind :function)
-  (declare (ignore source))
-  (let* ((name (eval name))
-        (lambda (second def))
-        (*current-path* (revert-source-path 'defun))
-        (expansion (unless (eq (info :function :inlinep name) :notinline)
-                     (inline-syntactic-closure-lambda lambda))))
-    ;; If not in a simple environment or NOTINLINE, then discard any
-    ;; forward references to this function.
-    (unless expansion (remhash name *free-functions*))
-
-    (let* ((var (get-defined-function name))
-          (save-expansion (and (member (defined-function-inlinep var)
-                                       '(:inline :maybe-inline))
-                               expansion)))
-      (setf (defined-function-inline-expansion var) expansion)
-      (setf (info :function :inline-expansion name) save-expansion)
-      ;; If there is a type from a previous definition, blast it,
-      ;; since it is obsolete.
-      (when (eq (leaf-where-from var) :defined)
-       (setf (leaf-type var) (specifier-type 'function)))
-
-      (let ((fun (ir1-convert-lambda-for-defun lambda
-                                              var
-                                              expansion
-                                              #'ir1-convert-lambda)))
-       (ir1-convert
-        start cont
-        (if (and *block-compile* *entry-points*
-                 (not (member name *entry-points* :test #'equal)))
-            `',name
-            `(%%defun ',name ,fun ,doc
-                      ,@(when save-expansion `(',save-expansion)))))
-
-       (when sb!xc:*compile-print*
-         (compiler-mumble "~&; converted ~S~%" name))))))
+         (let ((found (find-free-var name)))
+           (when (heap-alien-info-p found)
+             (compiler-error
+              "~S is an alien variable and so can't be declared special."
+              name))
+           (unless (global-var-p found)
+             (compiler-error
+              "~S is a constant and so can't be declared special."
+              name))
+           found))
+        (t
+         (make-global-var :kind :special
+                          :%source-name name
+                          :where-from :declared))))