Complete javadoc for PathGenerator