vm

vm/in/INSTRS

@@ -1,8 +1,21 @@
 # The OS/K Team licenses this file to you under the MIT license.
 # See the LICENSE file in the project root for more information.
 
+#---------------------------------------------------------------------------#
+# Special instructions                                                      #
+#---------------------------------------------------------------------------#
+
+#
+# Initiate machine shutdown (STOP)
+#
+#       THROW #SHT
+#
+# Throws:
+#       #SYS if not in supervisor mode
+#       #ILL if disabled through DV
+#       #SHT otherwise
+#
 stop
-nop
 
 #---------------------------------------------------------------------------#
 # Logical instructions                                                      #
@@ -47,7 +60,7 @@ nop
 #
 !xor rm rim
 
-
+# To document
 !shl rm rim
 !shr rm rim
 
@@ -382,6 +395,18 @@ iocall rim rim
 # Misc. instructions                                                        #
 #---------------------------------------------------------------------------#
 
+#
+# Do nothing (NOOP)
+#
+#       (nothing)
+#
+# Preserves all flags
+#
+# Throws:
+#       (nothing)
+#
+nop
+
 #
 # Get code/date offset (GCO/GCD)
 #