diff --git a/src/main/java/carpet/script/CarpetExpression.java b/src/main/java/carpet/script/CarpetExpression.java
index 8fdaa0ca..0467770b 100644
--- a/src/main/java/carpet/script/CarpetExpression.java
+++ b/src/main/java/carpet/script/CarpetExpression.java
@@ -616,6 +616,13 @@ public class CarpetExpression
* but chunks can only be valid in a few states: full, features, liquid_carvers,
* and structure_starts. Returns null if the chunk is not in memory unless called with optional
* true.
structures(pos), structures(pos, structure_name)Returns structure information for a given block position. Note that strucuture information is the same for
+ * all the blocks from the same chunk. structures function can be called with a block, or a block and
+ * structure name. In the first case it returns a map of structures at a given position, keyed by structure name,
+ * with values indicating the bounding box of the structure - a pair of two 3-value coords (see examples). When
+ * called with extra structure name, returns list of components for that structure, with their name, direction
+ * and two sets of coordinates indicating the bounding box of the structure piece.
suffocates(pos)Boolean function, true if the block causes suffocation.
*power(pos)