improved doc thanks to Vincent Kersten