improved doc strings