add missing documentation, minor changes