lots of little changes
added the beginning of a user manual in doc/