added javadocs for the meaty methods of rosafactory.