convert docs to markdown proper
fixed conditional bug; updated and cleaned test programs; more notes about the whole thing