more work on documentation. stopped more or less in the middle of going over Oscil.