diff --git a/doc/manual/expressions/language-constructs.xml b/doc/manual/expressions/language-constructs.xml
index 2f0027d47..47d95f8a1 100644
--- a/doc/manual/expressions/language-constructs.xml
+++ b/doc/manual/expressions/language-constructs.xml
@@ -61,7 +61,7 @@ evaluates to "foobar".
Inheriting attributes
-When defining a set it is often convenient to copy variables
+When defining a set or in a let-expression it is often convenient to copy variables
from the surrounding lexical scope (e.g., when you want to propagate
attributes). This can be shortened using the
inherit keyword. For instance,
@@ -72,7 +72,15 @@ let x = 123; in
y = 456;
}
-evaluates to { x = 123; y = 456; }. (Note that
+is equivalent to
+
+
+let x = 123; in
+{ x = x;
+ y = 456;
+}
+
+and both evaluate to { x = 123; y = 456; }. (Note that
this works because x is added to the lexical scope
by the let construct.) It is also possible to
inherit attributes from another set. For instance, in this fragment
@@ -101,6 +109,26 @@ variables from the surrounding scope (fetchurl
libXaw (the X Athena Widgets) from the
xlibs (X11 client-side libraries) set.
+
+Summarizing the fragment
+
+
+...
+inherit x y z;
+inherit (src-set) a b c;
+...
+
+is equivalent to
+
+
+...
+x = x; y = y; z = z;
+a = src-set.a; b = src-set.b; c = src-set.c;
+...
+
+when used while defining local variables in a let-expression or
+while defining a set.
+