instance.pm converted to using new-style parameter parsing
work on documentation