diff --git a/doc/org.texi b/doc/org.texi
index 3f02efb..618b287 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -13627,7 +13627,9 @@ concatenated together to form the replacement text.
 By setting this header argument at the sub-tree or file level, simple code
 block concatenation may be achieved.  For example, when tangling the
 following Org mode file, the bodies of code blocks will be concatenated into
-the resulting pure code file.
+the resulting pure code file (note that this example needs that property
+inheritance be turned on for the @code{noweb-ref} property, see
address@hidden inheritance}).
 
 @example
  #+BEGIN_SRC sh :tangle yes :noweb yes :shebang #!/bin/sh