Improved some debug code & lots of documentation

Added full documentation for SIF/Debug.

Added a debug conditional compilation flag for compiling with debug
labels.

Minor readme changes.