document flags - fixes #8