Doc++

src/Platform/GlutApplication.h

@@ -91,10 +91,11 @@ class GlutApplication {
         /**
          * @brief Draw event
          *
-         * Here implement your drawing functions, such as calling
-         * SceneGraph::AbstractCamera::draw(). After drawing is finished, call
-         * swapBuffers(). If you want to draw immediately again, call also
-         * redraw().
+         * Called when the screen is redrawn. You should clean the framebuffer
+         * using Framebuffer::clear() and then add your own drawing functions,
+         * such as calling SceneGraph::AbstractCamera::draw(). After drawing
+         * is finished, call swapBuffers(). If you want to draw immediately
+         * again, call also redraw().
          */
         virtual void drawEvent() = 0;
 

src/SceneGraph/AbstractObject.h

@@ -35,7 +35,14 @@ Provides minimal interface for features, not depending on object transformation
 implementation. This class is not directly instantiatable, use Object subclass
 instead. See also @ref scenegraph for more information.
 
-Uses Corrade::Containers::LinkedList for storing features.
+Uses Corrade::Containers::LinkedList for storing features. Traversing through
+the list is done like in the following code. It is also possible to go in
+reverse order using lastFeature() and AbstractFeature::previousFeature().
+@code
+for(AbstractFeature* feature = o->firstFeature(); feature; feature = feature->nextFeature()) {
+    // ...
+}
+@endcode
 
 @see AbstractObject2D, AbstractObject3D
 */

src/SceneGraph/Object.h

@@ -50,6 +50,13 @@ care of parent/children relationship and contains features. See @ref scenegraph
 for introduction.
 
 Uses Corrade::Containers::LinkedList for parent/children relationship.
+Traversing through the list is done like in the following code. It is also
+possible to go in reverse order using lastChild() and previousSibling().
+@code
+for(Object* child = o->firstChild(); child; child = child->nextSibling()) {
+    // ...
+}
+@endcode
 
 @section Object-explicit-specializations Explicit template specializations