Omit: & No-Omit-Results:

[froggie]

Mostly documentation comments, all work as expected, but I was confused for a while:

OMIT: is a Search Function.
NOOMIT: is not documented. but works (the NO prefix is only documented for Search Modifiers).

NO-OMIT-RESULTS: is a Search Modifier.
OMIT-RESULTS: is not documented, but works.

Is there any functional difference between OMIT: and OMIT-RESULTS: ?

!OMIT: will list all (and only) the omitted items, but not if Enable Results Omissions is set. NOOMIT: !OMIT: will always work.

There is something counterintuitive about using OMIT: to list items that are not omitted.

[void]

omit-results: was the first search function added.
Initially, it was used to reference your result omissions list.
Many users thought it did the inverse (enable your result omissions)
Due to the confusion, omit-results: will now enable your result omissions.



result-omissions:

Matches any file/folder that is in your result omissions list.
Enabling Index -> "Enable Result Omissions" will exclude these results.
Combine with no-omit:



omit:
omit-results:

Matches any file/folder that is not in your result omissions list.
Index -> "Enable Result Omissions" does not need to be enabled.



no-omit:
no-omit-results:

Theses search modifiers are exactly the same.
no-omit: overrides the Index -> "Enable Result Omissions" option, disabling any result omissions and showing all files/folders.
Unlike most other modifiers they are always a global modifier.
-It doesn't matter where the no-omit: modifier is used, it will be applied to the entire search.

Is there any functional difference between OMIT: and OMIT-RESULTS: ?

They are the same function, except omit: is the inverse.
omit: = Matches any file/folder that is not in your result omissions list.
omit-results: (depreciated) = Matches any file/folder that is in your result omissions list.

!OMIT: will list all (and only) the omitted items, but not if Enable Results Omissions is set. NOOMIT: !OMIT: will always work.

!omit: will not disable result omissions.
I recommend using the following for improved readability:
noomit: result-omissions:
(disable result omissions and match files/folders in the result omissions list)

Looking at the wording I have used here, I should add some aliases and use them for support:
enable-result-omissions: (omit:)
disable-result-omissions: (no-omit:)
is-in-result-omission-list: (result-omissions:)

So the same as above would look like:

disable-result-omissions: is-in-result-omission-list:



omit:
omit-results:
result-omissions:
no-omit:
no-omit-results:

[froggie]

Thank you for your reply. I am looking forward to
enable-result-omissions: (omit:)
disable-result-omissions: (no-omit:)
is-in-result-omission-list: (result-omissions:)

You wrote that

result-omissions:
Matches any file/folder that is in your result omissions list.
Index -> "Enable Result Omissions" does not need to be enabled.

But rather than "does not need to be enabled" it only works if "Enable Result Omissions" is not enabled on my 1383a.

Also on my system OMIT: and OMIT-RESULTS: are not inverse, they are identical, however-much that matters for a depreciated function.

[void]

Index -> "Enable Result Omissions" does not need to be enabled.

But rather than "does not need to be enabled" it only works if "Enable Result Omissions" is not enabled on my 1383a.

Technically, "Enable Result Omissions" does not need to be enabled.
result-omissions: matches any file/folder that is in your result omissions list.
The correct files will be matched, but then also excluded if "Enable Result Omissions" is enabled.

Enabling Index -> "Enable Result Omissions" will exclude these results.
Combine with no-omit:

Also on my system OMIT: and OMIT-RESULTS: are not inverse, they are identical, however-much that matters for a depreciated function.

You are correct.
I forgot I changed this.
omit: and omit-results: are now the same.
I have added omit-results: to the documentation.
I have updated my previous post.