diff --git a/blackhole.lua b/blackhole.lua
index 5099806..e04b110 100644
--- a/blackhole.lua
+++ b/blackhole.lua
@@ -19,7 +19,7 @@
 --                 +--------+
 --                /        /|
 --               +--------+ |
---     IN (L) <--|  BLACK | |          
+--     IN (L) -->|  BLACK | |          
 --               |  HOLE  | +
 --               |        |/
 --               +--------+
diff --git a/command.lua b/command.lua
index 0ecf260..29221e1 100644
--- a/command.lua
+++ b/command.lua
@@ -15,24 +15,27 @@
 ]]--
 
 --  
---  The facedirs, contact-sides, coordinates, and orientations of a node:
+-- Param 'side' is the node contact side where you push items out or let items in.
+-- This is one of B(ack), R(ight), F(ront), L(eft), D(own), U(p) acouring to the facedir.
+-- Here the facedirs, contact-sides, coordinates, and orientations of a node:
 --
---                 5/up/Y/-
---                         _ 
---                    /\    /| 0/back/Z/north
---                    |    /
---                    |   /
---                 +--|-----+
---                /   o    /|
---               +--------+ |
---         3 ----|        |o----> 1/right/X/east
---               |    o   | |
---               |   /    | +
---               |  /     |/
---               +-/------+
---                /   |
---               2    |
---                    4
+--                     5/up/Y/-
+--                             _ 
+--                        /\    /| 0/back/Z/north
+--                        |    /
+--                        |   /
+--                     +--|-----+
+--                    /   o    /|
+--                   +--------+ |
+--  3/left/-X/west---|        |o----> 1/right/X/east
+--                   |    o   | |
+--                   |   /    | +
+--                   |  /     |/
+--                   +-/------+
+--                    /   |
+--           2/front/-Z/- |
+--                        |
+--                     4/down/-y/-
 
 
 -------------------------------------------------------------------
diff --git a/pusher.lua b/pusher.lua
index 848f916..beede59 100644
--- a/pusher.lua
+++ b/pusher.lua
@@ -24,7 +24,7 @@
 --                 +--------+
 --                /        /|
 --               +--------+ |
---     IN (L) <--|        |x--> OUT (R)
+--     IN (L) -->|        |x--> OUT (R)
 --               | PUSHER | +
 --               |        |/
 --               +--------+