minor documentation updates
inlined get_memory_top in single usage instance
more documentation and removed functions
fixed corner case situation (not all ;-) )