Mercurial > hg > terminal-chess / file diff

--- a/src/chess/rules.h	Sat Aug 01 10:58:39 2026 +0200
+++ b/src/chess/rules.h	Sat Aug 01 11:26:48 2026 +0200
@@ -383,15 +383,15 @@
 /**
  * Checks, if a specified field is protected by a piece of a certain color.
  * 
- * This is the same as is_attacked(), but only considers pieces that are not
- * the king.
+ * A field is protected, if any piece except the king can either capture on
+ * that field or move to that field (and is not pinned).
  * 
  * @param gamestate the current game state
  * @param row row of the field to check
  * @param file file of the field to check
  * @param color the color of the piece that should cover the field
  * @return true, if any piece (excluding the king) of the specified color
- * threatens the specified field and could capture an opponent piece
+ * can move to the specified field (including capturing moves)
  */
 bool is_protected(const GameState *gamestate, Row row, File file, Color color);