@marqh complete the doc-string ...