From 2e082a5fbc61763ba0de5b544363565ff3631616 Mon Sep 17 00:00:00 2001
From: gwarser <gwarser@gmail.com>
Date: Mon, 12 Sep 2022 21:32:40 +0200
Subject: [PATCH] :others()

---
 Procedural-cosmetic-filters.md | 29 +++++++++++++++++++++++++++--
 1 file changed, 27 insertions(+), 2 deletions(-)

diff --git a/Procedural-cosmetic-filters.md b/Procedural-cosmetic-filters.md
index a7944e5..d868444 100644
--- a/Procedural-cosmetic-filters.md
+++ b/Procedural-cosmetic-filters.md
@@ -24,8 +24,6 @@ _Procedural_ means JavaScript code will find DOM elements that it must hide. A p
 
 ### `subject:has(arg)`
 
-<sub>Semantic changed in uBO 1.15.0 to resemble `:if(...)`</sub>
-
 - Description: Select element _subject_ if and only if evaluating _arg_ in the context of _subject_ returns one or more elements.
 - Chainable: Yes.
 - _subject_: Can be a plain CSS selector, or a procedural cosmetic filter.
@@ -130,6 +128,33 @@ Note that if _arg_ is valid CSS selector, uBO will not consider the `:not` opera
 
 ***
 
+### `subject:others()`
+
+Experimental.
+
+- Description: Target all elements _outside_ than the currently selected set of elements.
+- Chainable: Yes.
+- _subject_: Can be a plain CSS selector, or a procedural cosmetic filter.
+- Examples:
+    - `twitter.com##:matches-path(/^/home/) [data-testid="primaryColumn"]:others()`
+    - `nature.com##:matches-path(/^/articles//) :is(.c-breadcrumbs,.c-article-main-column):others()`
+
+Introduced in uBO [1.41.1b2](https://github.com/gorhill/uBlock/commit/152120bd9ec7a2ccea907e015fb195484ef7bc8e)
+
+For any element feeding into `others()`, the resultset of the `others()` operator will include everything else except:
+
+- the descendants of a subject element
+- the ancestors of a subject element
+
+The resultset will contains the siblings of a subject element _except_ when those siblings are either a descendant or ancestor of another subject element.
+
+Though this operator is unlikely to be used in default lists, it opens the door to create specialized filter lists which purpose is some sort of "reader mode", where everything _else_ than a selected set of elements are hidden from view.
+
+Related discussion:
+- https://www.reddit.com/r/uBlockOrigin/comments/slyjzp/
+
+***
+
 ### `subject:upward(arg)`
 
 - Description: lookup the ancestor relative to the currently selected node.