Improve size hint documentation

1 files changed, 21 insertions, 3 deletions

diff --git a/include/pugl/pugl.h b/include/pugl/pugl.h
index 189cfe4..f9dd37e 100644
--- a/include/pugl/pugl.h
+++ b/include/pugl/pugl.h
@@ -955,9 +955,27 @@ typedef enum {
    size gracefully.
 */
 typedef enum {
-  PUGL_DEFAULT_SIZE, ///< Default size
-  PUGL_MIN_SIZE,     ///< Minimum size
-  PUGL_MAX_SIZE,     ///< Maximum size
+  /**
+     Default size.
+
+     This is used as the size during window creation as a default, if no other
+     size is specified.
+  */
+  PUGL_DEFAULT_SIZE,
+
+  /**
+     Minimum size.
+
+     If set, the view's size should be constrained to be at least this large.
+  */
+  PUGL_MIN_SIZE,
+
+  /**
+     Maximum size.
+
+     If set, the view's size should be constrained to be at most this large.
+  */
+  PUGL_MAX_SIZE,
 
   /**
      Fixed aspect ratio.