some cleanup and docs on collide-touch and the tie extractor (#1074)

* some cleanup and docs on collide-touch and the tie extractor

* temp

* more updates

* update ref tests

* type fix

* rest of collide shape

* another set of updates

test/decompiler/reference/engine/debug/default-menu_REF.gc

@@ -548,6 +548,7 @@
 (define *shader-pick-menu* (the-as debug-menu #f))
 
 ;; definition for function build-shader-list
+;; INFO: Return type mismatch object vs none.
 (defun build-shader-list ()
   (debug-menu-remove-all-items *shader-pick-menu*)
   (when *texture-page-dir*
@@ -575,10 +576,8 @@
         )
       )
     )
-  (let ((v0-3 (sort (-> *shader-pick-menu* items) debug-menu-node<?)))
-    (set! (-> *shader-pick-menu* items) (the-as pair v0-3))
-    v0-3
-    )
+  (set! (-> *shader-pick-menu* items) (the-as pair (sort (-> *shader-pick-menu* items) debug-menu-node<?)))
+  (none)
   )
 
 ;; definition for function dm-instance-pick-func

test/decompiler/reference/engine/debug/part-tester_REF.gc

@@ -27,9 +27,6 @@
   :method-count-assert 14
   :size-assert         #x7c
   :flag-assert         #xe0100007c
-  (:states
-    part-tester-idle
-    )
   )
 
 ;; definition for method 3 of type part-tester