more script documentation, added some parameter defaults to methods.