# HG changeset patch
# User Mike Becker <universe@uap-core.de>
# Date 1775500031 -7200
# Node ID 066481b8b3a5cf42a81bf79ad385b05ce898bd13
# Parent  10f7d14405b6738007cf3584f6d4429cd3543666
add some docu to scene_node functions

diff -r 10f7d14405b6 -r 066481b8b3a5 src/ascension/scene_node.h
--- a/src/ascension/scene_node.h	Sun Feb 08 14:47:28 2026 +0100
+++ b/src/ascension/scene_node.h	Mon Apr 06 20:27:11 2026 +0200
@@ -214,14 +214,30 @@
  * Unlinks a node from its parent.
  *
  * This might be useful to temporarily remove a subtree from a scene.
- * To permanently remove the node use asc_scene_node_free().
+ * To permanently remove the node, use asc_scene_node_free().
  *
  * @param node the node to unlink
  */
 void asc_scene_node_remove(AscSceneNode *node);
 
+/**
+ * Advises the node to update its graphics.
+ * This usually involves updating the geometry / mesh, etc.
+ *
+ * @param node the node
+ */
 void asc_scene_node_update(AscSceneNode *node);
 
+/**
+ * Advises the node to recalculate transformation matrices.
+ * This is recursively applied to all children.
+ *
+ * Usually you never need to call this function manually.
+ * It is automatically called when you manipulate the transformation components
+ * via the respective setters.
+ *
+ * @param node the node
+ */
 void asc_scene_node_update_transform(AscSceneNode *node);
 
 /**