clarify CommentStyle
diff --git a/include/json/writer.h b/include/json/writer.h
index 6e46cf1..e4d665e 100644
--- a/include/json/writer.h
+++ b/include/json/writer.h
@@ -41,7 +41,11 @@
protected:
std::ostream& sout_; // not owned; will not delete
public:
- enum class CommentStyle {None, Some, All};
+ /// `All`: Keep all comments.
+ /// `None`: Drop all comments.
+ /// Use `Most` to recover the odd behavior of previous versions.
+ /// Only `All` is currently implemented.
+ enum class CommentStyle {None, Most, All};
/// Keep a reference, but do not take ownership of `sout`.
StreamWriter(std::ostream* sout);