Add a doc note that the .find() methods are usually faster than one m…

…ight expect.
lxml · Oct 18, 2020 · fd8893c · fd8893c
1 parent eb6df27
commit fd8893c
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/doc/xpathxslt.txt b/doc/xpathxslt.txt
@@ -63,6 +63,10 @@ comparison`_ to learn when to use which.  Their semantics when used on
 Elements and ElementTrees are the same as for the ``xpath()`` method described
 here.
 
+Note that the ``.find*()`` methods are usually faster than the full-blown XPath
+support.  They also support incremental tree processing through the ``.iterfind()``
+method, whereas XPath always collects all results before returning them.
+
 .. _`performance comparison`: performance.html#xpath