Minor docs updates. Added a method to Rectangle.

modules/juce_core/threads/juce_CriticalSection.h

@@ -31,9 +31,9 @@
 
 //==============================================================================
 /**
-    A mutex class.
+    A re-entrant mutex.
 
-    A CriticalSection acts as a re-entrant mutex lock. The best way to lock and unlock
+    A CriticalSection acts as a re-entrant mutex object. The best way to lock and unlock
     one of these is by using RAII in the form of a local ScopedLock object - have a look
     through the codebase for many examples of how to do this.
 

modules/juce_graphics/geometry/juce_Rectangle.h

@@ -478,6 +478,17 @@ public:
                                  jlimit (pos.y, pos.y + h, point.y));
     }
 
+    /** Returns a point within this rectangle, specified as proportional coordinates.
+        The relative X and Y values should be between 0 and 1, where 0 is the left or
+        top of this rectangle, and 1 is the right or bottom. (Out-of-bounds values
+        will return a point outside the rectangle).
+    */
+    Point<ValueType> getRelativePoint (double relativeX, double relativeY) const noexcept
+    {
+        return Point<ValueType> (pos.x + static_cast <ValueType> (w * relativeX),
+                                 pos.y + static_cast <ValueType> (h * relativeY));
+    }
+
     /** Returns true if any part of another rectangle overlaps this one. */
     bool intersects (const Rectangle& other) const noexcept
     {

modules/juce_gui_basics/components/juce_Component.h

@@ -810,8 +810,9 @@ public:
     */
     virtual void parentHierarchyChanged();
 
-    /** Subclasses can use this callback to be told when children are added or removed.
-        @see parentHierarchyChanged
+    /** Subclasses can use this callback to be told when children are added or removed, or
+        when their z-order changes.
+        @see parentHierarchyChanged, ComponentListener::componentChildrenChanged
     */
     virtual void childrenChanged();
 

modules/juce_gui_basics/components/juce_ComponentListener.h

@@ -71,9 +71,10 @@ public:
     */
     virtual void componentVisibilityChanged (Component& component);
 
-    /** Called when the component has children added or removed.
+    /** Called when the component has children added or removed, or their z-order
+        changes.
 
-        @param component    the component whose children were changed
+        @param component    the component whose children have changed
         @see Component::childrenChanged, Component::addChildComponent,
              Component::removeChildComponent
     */