Add info about logical operators for filter patterns, and examples, to help text

[vapniks]

I have so many different query languages to remember (regexps, xpath, jq,...)
It would be useful to have more info in the help page in case I forget exactly how broot filter queries work (e.g. after not using it for a long while). Maybe some short examples too (e.g. for the tokens search; it took me a while to work out you need to separate tokens with commas).

[Canop]

You mean the help page inside the application or the help site ? I suspect nobody would read the in-app help if it was longer.

[vapniks]

I mean the in-app help. The box showing the search prefixes is about half the width of the screen so there's easily enough space for another column showing examples, and perhaps a column with a short explanation. If you did that then I think you could remove lines 2 & 3 below the "Search Modes" header without any loss of comprehension. Those lines could be replaced by a couple of lines stating the logical operators, e.g:

"logical operators !,&,| and parentheses can be used to combine filters, e.g. '(!/foo/)&c/bar/'. For efficiency place content matches last."

This would be enough to prompt memory or figure out how they work.
These logical operators significantly increase the power of broot, so I think it would be worth it.

[Canop]

I think you're right.

[vapniks]

Also IMO it makes more sense to put the "Search Modes" section first (and the "Configuration" section last) on the help page since I suspect that people will be looking at it more frequently than the other stuff (there are 10 different prefixes to remember). When I press ? I have to press PgDwn three times to reach the filter table.

[Canop]

[vapniks]

Looks good to me