I added more info to the doc string about this.