Documentation updates

Author: djowel

lib/include/elements/element/align.hpp

@@ -352,7 +352,8 @@ namespace cycfi::elements
    }
 
    /**
-    * \brief Create an element that is aligned to left and top.
+    * \brief
+    *    Create an element that is aligned to left and top.
     *
     * \tparam Subject
     *    The subject type, must meet the `Element` concept.
@@ -370,7 +371,8 @@ namespace cycfi::elements
    }
 
    /**
-    * \brief Create an element that is aligned to center and top.
+    * \brief
+    *    Create an element that is aligned to center and top.
     *
     * \tparam Subject
     *    The subject type, must meet the `Element` concept.
@@ -388,7 +390,8 @@ namespace cycfi::elements
    }
 
    /**
-    * \brief Create an element that is aligned to right and top.
+    * \brief
+    *    Create an element that is aligned to right and top.
     *
     * \tparam Subject
     *    The subject type, must meet the `Element` concept.
@@ -406,7 +409,8 @@ namespace cycfi::elements
    }
 
    /**
-    * \brief Create an element that is aligned to left and middle.
+    * \brief
+    *    Create an element that is aligned to left and middle.
     *
     * \tparam Subject
     *    The subject type, must meet the `Element` concept.
@@ -424,7 +428,8 @@ namespace cycfi::elements
    }
 
    /**
-    * \brief Create an element that is aligned to center and middle.
+    * \brief
+    *    Create an element that is aligned to center and middle.
     *
     * \tparam Subject
     *    The subject type, must meet the `Element` concept.
@@ -442,7 +447,8 @@ namespace cycfi::elements
    }
 
    /**
-    * \brief Create an element that is aligned to right and middle.
+    * \brief
+    *    Create an element that is aligned to right and middle.
     *
     * \tparam Subject
     *    The subject type, must meet the `Element` concept.
@@ -460,7 +466,8 @@ namespace cycfi::elements
    }
 
    /**
-    * \brief Create an element that is aligned to left and bottom.
+    * \brief
+    *    Create an element that is aligned to left and bottom.
     *
     * \tparam Subject
     *    The subject type, must meet the `Element` concept.
@@ -478,7 +485,8 @@ namespace cycfi::elements
    }
 
    /**
-    * \brief Create an element that is aligned to center and bottom.
+    * \brief
+    *    Create an element that is aligned to center and bottom.
     *
     * \tparam Subject
     *    The subject type, must meet the `Element` concept.
@@ -496,7 +504,8 @@ namespace cycfi::elements
    }
 
    /**
-    * \brief Create an element that is aligned to right and bottom.
+    * \brief
+    *    Create an element that is aligned to right and bottom.
     *
     * \tparam Subject
     *    The subject type, must meet the `Element` concept.

lib/include/elements/element/button.hpp

@@ -33,13 +33,14 @@ namespace cycfi::elements
    /**
     *  \struct button_state
     *
-    *  \brief A structure to maintain and manage the state of a button.
+    *  \brief
+    *    A structure to maintain and manage the state of a button.
     *
-    *  This structure captures the various states that a button can have:
-    *  - `value`: The button's value; 0(off) or 1(on).
-    *  - `hilite`: True if the button is highlighted.
-    *  - `tracking`: True if the mouse button being pressed.
-    *  - `enabled`: True if the button is enabled.
+    *    This structure captures the various states that a button can have:
+    *    - `value`: The button's value; 0(off) or 1(on).
+    *    - `hilite`: True if the button is highlighted.
+    *    - `tracking`: True if the mouse button being pressed.
+    *    - `enabled`: True if the button is enabled.
     */
    struct button_state
    {
@@ -350,7 +351,8 @@ namespace cycfi::elements
    };
 
    /**
-    *  \brief Get the current selection state of the button.
+    *  \brief
+    *    Get the current selection state of the button.
     *
     *    This function uses the `value()` method to get the current selection
     *    state of the button.
@@ -365,7 +367,8 @@ namespace cycfi::elements
    }
 
    /**
-    *  \brief Set the selection state of the button.
+    *  \brief
+    *    Set the selection state of the button.
     *
     *    This function uses the `value()` member function to set the new
     *    state of the button.

lib/include/elements/element/drag_and_drop.hpp

@@ -281,7 +281,8 @@ namespace cycfi::elements
    }
 
    /**
-    * \brief Sets the selected state of the draggable element.
+    * \brief
+    *    Sets the selected state of the draggable element.
     *
     * \param state_
     *    The new selected state (`true`==selected and `false` otherwise).

lib/include/elements/element/element.hpp

@@ -184,11 +184,12 @@ namespace cycfi::elements
    }
 
    /**
-    * \brief Constructs an empty `element` instance.
+    * \brief
+    *    Constructs an empty `element` instance.
     *
-    * This function is used to create an instance of an `element` that is
-    * effectively empty. This can be useful for creating placeholder or
-    * default elements within a UI.
+    *    This function is used to create an instance of an `element` that is
+    *    effectively empty. This can be useful for creating placeholder or
+    *    default elements within a UI.
     *
     * \return
     *    An instance of an `element` that has no associated properties or