updating doc strings to match code realities