C++: Document sixtyfps::interpreter::Value::Type

api/sixtyfps-cpp/include/sixtyfps_interpreter.h

@@ -279,8 +279,36 @@ public:
     /// Destroys the value.
     ~Value() { cbindgen_private::sixtyfps_interpreter_value_destructor(&inner); }
 
-    /// \private
+#if !defined(DOXYGEN)
     using Type = cbindgen_private::ValueType;
+#else
+    /// This enum describes the different types the Value class can represent.
+    enum Type {
+        /// The variant that expresses the non-type. This is the default.
+        Void,
+        /// An `int` or a `float` (this is also used for unit based type such as `length` or
+        /// `angle`)
+        Number,
+        /// Correspond to the `string` type in .60
+        String,
+        /// Correspond to the `bool` type in .60
+        Bool,
+        /// An Array in the .60 language.
+        Array,
+        /// A more complex model which is not created by the interpreter itself (Type::Array can
+        /// also be used for models)
+        Model,
+        /// An object
+        Struct,
+        /// Correspond to `brush` or `color` type in .60.  For color, this is then a
+        /// sixtyfps::Brush with just a color.
+        Brush,
+        /// Correspond to `image` type in .60.
+        Image,
+        /// The type is not a public type but something internal.
+        Other = -1,
+    };
+#endif // else !defined(DOXYGEN)
 
     // optional<int> to_int() const;
     // optional<float> to_float() const;

sixtyfps_runtime/interpreter/api.rs

@@ -22,6 +22,8 @@ pub use sixtyfps_compilerlib::diagnostics::{Diagnostic, DiagnosticLevel};
 
 /// This enum represents the different public variants of the [`Value`] enum, without
 /// the contained values.
+// NOTE: The docs for ValueType are duplicated in sixtyfps_interpreter.h, for extraction by
+// Doxygen. Keep in sync!
 #[derive(Debug, Copy, Clone, PartialEq)]
 #[repr(i8)]
 pub enum ValueType {
@@ -35,7 +37,7 @@ pub enum ValueType {
     Bool,
     /// An Array in the .60 language.
     Array,
-    /// A more complex model which is not created by the interpreter itself (Value::Array can also be used for model)
+    /// A more complex model which is not created by the interpreter itself (ValueType::Array can also be used for models)
     Model,
     /// An object
     Struct,
@@ -98,7 +100,7 @@ pub enum Value {
     Image(Image),
     /// An Array in the .60 language.
     Array(SharedVector<Value>),
-    /// A more complex model which is not created by the interpreter itself (Value::Array can also be used for model)
+    /// A more complex model which is not created by the interpreter itself (Value::Array can also be used for models)
     Model(Rc<dyn sixtyfps_corelib::model::Model<Data = Value>>),
     /// An object
     Struct(Struct),