improvements, fixes
 updated system documentation