improve javadoc : constraints in gs-api