Documentation: Are parenthesis able to group logical operators?

Please provide a link to the documentation page and section

https://blacksmithgu.github.io/obsidian-dataview/api/code-reference/#dvpagessource

Describe the problem

• The documentation doesn’t say whether parenthesis are a valid way to group logical operators.
• For example, I’d like to do dv.pages('"dir" and (#tag1 or #tag2)') to find all documents in “dir/” that contain EITHER tag1 OR tag2. Documents must only match from the “dir” folder. Initial testing seems to confirm that this works, but it’s not documented anywhere.
• Another example query is dv.pages('"dir" and (#tag1 and #tag2)') to find all documents in “dir/” that contain BOTH tag1 AND tag2.
• If both of those queries are legal/valid, what about something even more complex, such as this? dv.pages('"dir" and (#tag1 and (#tag2 or #tag3))') - Is that valid?
• What about groups with just one operand, like this? dv.pages('"dir" and (#tag1) and (#tag2)') - is this valid?

Describe the solution you’d like

• Can you confirm whether the syntax I just described is legal/safe to use?
• If so, it would be very useful to document it on the dv.pages() API page among the other examples listed there. 😃

[blacksmithgu]

Yes, arbitrary nesting is fine - Dataview uses a parser combinator library which supports LL(infinity) grammars, including all the standard things you expect out of an expression parser like in JavaScript.

[blacksmithgu]

Fixed in documentation; will show up during the 0.5.38 release later.