diff --git a/v2/doc/src/reference.xml b/v2/doc/src/reference.xml
index e2053030e..b0b11f31f 100644
--- a/v2/doc/src/reference.xml
+++ b/v2/doc/src/reference.xml
@@ -462,13 +462,35 @@ path-constant DATA : data/a.txt ;
         <term><literal>link</literal></term>
         
         <listitem>
+
+          <para><emphasis role="bold">Allowed values:</emphasis> <literal>shared</literal>,
+            <literal>static</literal></para>
+
           <simpara>
             A feature that controls how libraries are built.
           </simpara>
           
+        </listitem></varlistentry>
+
+      <varlistentry id="bbv2.advanced.builtins.features.runtime-link">
+        <indexterm><primary>runtime linking</primary></indexterm>
+        <term><literal>runtime-link</literal></term>
+        
+        <listitem>
           <para><emphasis role="bold">Allowed values:</emphasis> <literal>shared</literal>,
             <literal>static</literal></para>
-        </listitem></varlistentry>
+
+          <simpara>
+            Controls if a static or shared C/C++ runtime should be used. There
+            are some restrictions how this feature can be used, for example
+            on some compilers an application using static runtime should
+            not use shared libraries at all, and on some compilers,
+            mixing static and shared runtime requires extreme care.  Check
+            your compiler documentation for more details.
+          </simpara>
+          
+        </listitem>
+      </varlistentry>
       
       <varlistentry><term><literal>source</literal></term>