NH-2319 - documenting the feature, to be squashed.

Author: fredericDelaporte

doc/reference/modules/query_linq.xml

@@ -42,6 +42,22 @@ using NHibernate.Linq;]]></programlisting>
         .Where(c => c.Name == "Max")
         .ToList();]]></programlisting>
 
+    <para>
+      Starting with NHibernate 5.0, queries can also be created from an entity collection, with the standard
+      Linq extension <literal>AsQueryable</literal> available from <literal>System.Linq</literal> namespace.
+    </para>
+    <programlisting>
+      <![CDATA[IList<Cat> whiteKittens =
+    cat.Kittens.AsQueryable()
+        .Where(k => k.Color == "white")
+        .ToList();]]>
+    </programlisting>
+    <para>
+      This will be executed as a query on that <literal>cat</literal>'s kittens without loading the
+      entire collection.
+    </para>
+    <para>&nbsp;</para>
+
     <para>
       A client timeout for the query can be defined.
     </para>
@@ -789,4 +805,4 @@ cfg.LinqToHqlGeneratorsRegistry<ExtendedLinqToHqlGeneratorsRegistry>();
       </para>
     </sect2>
   </sect1>
-</chapter>
+</chapter>