Huge update - I don't have time to write everything down but the directory

structure changes, some sections are expanded.  Take a look at the source
code or ask me to elaborate on certain issues/topics.