File 0289-Document-performance-reduction-with-QLC-string-handl.patch of Package erlang
From 3d8aa06ece2a844d08ae0ea16378d609c0b7c04b Mon Sep 17 00:00:00 2001
From: Johannes Christ <jc@jchri.st>
Date: Mon, 22 May 2023 20:24:42 +0200
Subject: [PATCH] Document performance reduction with QLC string handles
`qlc:string_to_handle` seems to have worse performance than `qlc:q` with
the same input query, presumably because the parse transform is not
optimizing `qlc:string_to_handle`.
Benchmarks that showcase this behaviour can be found here:
https://elixirforum.com/t/performance-discrepancies-with-using-qlc-queries-written-in-erlang-and-elixir/
---
lib/stdlib/doc/src/qlc.xml | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/lib/stdlib/doc/src/qlc.xml b/lib/stdlib/doc/src/qlc.xml
index 18f2bcfb10..84302337fa 100644
--- a/lib/stdlib/doc/src/qlc.xml
+++ b/lib/stdlib/doc/src/qlc.xml
@@ -1247,6 +1247,11 @@ ets:match_spec_run(
<anno>Options</anno>, erl_eval:new_bindings())</c>.</p>
<p>This function is probably mainly useful when called from
outside of Erlang, for example from a driver written in C.</p>
+ <note>
+ <p>Query handles created this way may have worse
+ performance than when created directly via
+ <seemfa marker="#q/1"><c>q/1,2</c></seemfa>.</p>
+ </note>
</desc>
</func>
--
2.35.3