added some detail in the doc string