diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml index fd0370a1b43..7a748392cbc 100644 --- a/doc/src/sgml/func.sgml +++ b/doc/src/sgml/func.sgml @@ -16236,6 +16236,24 @@ strict $.track.segments[*].location + + Note that .** accessor could lead to surprising results + when using the lax mode. For instance, the following query selects every + HR value twice. + +lax $.**.HR + + This happens because .** accessor selects both + segments array and each of its elements, while + .HR accessor automatically unwraps arrays when using + the lax mode. To evade surprising results, we recommend the usage of + .** accessor in the strict mode. The following query + selects each HR value once. + +strict $.**.HR + + +