--- a/src/chess/rules.h	Mon Aug 24 13:20:19 2026 +0200
+++ b/src/chess/rules.h	Mon Aug 24 13:42:35 2026 +0200
@@ -527,9 +527,12 @@
 /**
  * Calculates the move string within the specified move.
  *
- * This corrects any missing check / checkmate flags, first.
+ * The string calculated in short algebraic notation.
+ * The @p gamestate is needed to determine how to disambiguate the move,
+ * if necessary.
  *
- * Do not call this function after eval_move() or eval_move_strict().
+ * Recommended to be called before apply_move() so that a clean
+ * move string is added to the list of recorded moves.
  *
  * @param gamestate the current game state
  * @param move the move data