Merge pull request #893 from AdguardTeam/include-directive-and-macos-uninstall

[AGM-943] `!#include` directive, macOS uninstall instruction, `$removeparam` modifier updated

01.general/02.how-to-create-your-own-ad-filters/docs.en.md

@@ -641,7 +641,7 @@ These modifiers are able to completely change the behaviour of basic rules.
 
 >`$removeparam` and `$queryprune` are completely interchangeable and are aliases to each other.
 
-Rules with `$removeparam` modifier are intended to to strip query parameters from pages’ URLs. Please note that such rules are only applied to `GET`, `HEAD`, and `OPTIONS` requests.
+Rules with `$removeparam` modifier are intended to to strip query parameters from requests' URLs. Please note that such rules are only applied to `GET`, `HEAD`, and `OPTIONS` requests.
 
 ##### Syntax
 
@@ -731,7 +731,7 @@ $removeparam=/^(utm_content|utm_campaign|utm_referrer)=/
 With these rules, specified UTM parameters will be removed from any request save for requests to example.org.
 
 > **Compatibility with other modifiers**
-> `$removeparam` rules are not compatible with any other modifiers except `$domain`, `$third-party`, `$app`, `$important` and `$match-case`. The rules which have any other modifiers are considered invalid and will be discarded.
+> `$removeparam` rules are compatible with [basic modifiers](#basic-rules-common-modifiers), [content-type modifiers](#content-type-modifiers), and with `$important` and `$app` modifiers. The rules which have any other modifiers are considered invalid and will be discarded.
 
 > Please note that `$removeparam` rules can also be disabled by `$document` and `$urlblock` exception rules. But basic exception rules without modifiers don't do that. For example, `@@||example.com^` will not disable `$removeparam=p` for requests to **example.com**, but `@@||example.com^$urlblock` will.
 
@@ -2050,6 +2050,8 @@ The `!#include` directive allows to include contents of a specified file into th
 ```
 - `file_path` — same origin absolute or relative file path to be included
 
+> The files must originate from the same domain but may be located in a different folder.
+
 > If included file is not found or unavailable, the whole filter update should fail.
 
 > Same-origin limitation should be disabled for local custom filters.

01.general/02.how-to-create-your-own-ad-filters/docs.ru.md

@@ -643,7 +643,7 @@ domain.com###banner
 
 >`$removeparam` и `$queryprune` полностью взаимозаменяемы и по сути являются одинаковыми модификаторами с различными названиями.
 
-Правила с модификатором `$removeparam` предназначены для того, чтобы убирать параметры из URL страниц. Такие правила применяются *только* к запросам типов `GET`, `HEAD`, и `OPTIONS`.
+Правила с модификатором `$removeparam` предназначены для того, чтобы убирать параметры из URL запросов. Такие правила применяются *только* к запросам типов `GET`, `HEAD`, и `OPTIONS`.
 
 ##### Синтаксис
 
@@ -725,6 +725,9 @@ $removeparam=/^(utm_content|utm_campaign|utm_referrer)=/
 
 С этими правилами некоторые [utm-параметры](https://ru.wikipedia.org/wiki/UTM-%D0%BC%D0%B5%D1%82%D0%BA%D0%B8) будут удалены из любого запроса, но в запросах к `example.com` не будут удаляться совсем. Например: `http://google.com/page?utm_source=s&utm_referrer=fb.com&utm_content=img` будет преобразован в `http://google.com/page`, но `http://example.com/page?utm_source=s&utm_referrer=fb.com&utm_content=img` вообще не будет затронут этим правилом блокировки. 
 
+> **Совместимость с другими модификаторами**
+> Правила с `$removeparam` совместимы с [базовыми модификаторами](#basic-rules-common-modifiers), [модификаторами с ограничением по типу контента](#content-type-modifiers), а также с модификаторами `$important` и `$app`. Правила, содержащие другие типы модификаторов, будут считаться некорректными и не будут применены.
+
 > **Обратите внимание**, что блокировку правил `$removeparam` также можно отключить с помощью правил исключений `$document` и `$urlblock`. Но базовые правила исключений без модификаторов не могут этого сделать. Например, `@@||example.com^` не отключит `$removeparam=p` для запросов к example.com, а вот `@@||example.com^$urlblock` - отключит.
 
 > **Совместимость с различными версиями AdGuard.** Правила с этим модификатором поддерживаются AdGuard для Windows, Mac, Android, а также браузерными расширениями AdGuard для Chrome, Firefox, Edge. **На данный момент только девелопер-сборки.**
@@ -2061,6 +2064,8 @@ AdGuard использует тот же синтаксис правил фил
 ```
 - `file_path` — абсолютный (того же источника) или относительный путь к файлу
 
+> Файлы должны находиться на том же домене, но могут быть расположены в другой директории.
+
 > Если включённый файл не найден или недоступен, не будут работать обновления всего фильтра.
 
 > Для локальных собственных фильтров ограничение на тот же источник не распространяется.

03.macos/02.installation/docs.en.md

@@ -86,6 +86,7 @@ Go to 'Applications' section. Find AdGuard there, right-click on it and choose '
 `sudo rm -R "/Library/Application Support/com.adguard.mac.adguard"`
 `rm -R "~/Library/Application Support/com.adguard.mac.adguard"`
 `rm ~/Library/Preferences/com.adguard.mac.adguard.plist`
+`rm ~/Library/Group Containers/TC3Q7MAJXF.com.adguard.com`
 
 * Run ’Activity Monitor’ app.
 * Using search tool, find the process **cfprefsd**.

03.macos/02.installation/docs.ja.md

@@ -88,6 +88,7 @@ AdGuardアプリを使用するにはmacOS管理者アカウントのパスワ
 `sudo rm -R "/Library/Application Support/com.adguard.mac.adguard"`
 `rm -R "~/Library/Application Support/com.adguard.mac.adguard"`
 `rm ~/Library/Preferences/com.adguard.mac.adguard.plist`
+`rm -R ~/Library/Group\ Containers/TC3Q7MAJXF.com.adguard.mac`
 
 * 「アクティビティモニタ」アプリを起動する
 * 検索ツールを使用して「**cfprefsd**」プロセスを見つける

03.macos/02.installation/docs.ko.md

@@ -103,6 +103,7 @@ Finder 앱을 엽니다.
 `sudo rm -R "/Library/Application Support/com.adguard.mac.adguard"`
 `rm -R "~/Library/Application Support/com.adguard.mac.adguard"`
 `rm ~/Library/Preferences/com.adguard.mac.adguard.plist`
+`rm -R ~/Library/Group\ Containers/TC3Q7MAJXF.com.adguard.mac`
 
 * '활동 모니터' 앱을 실행합니다.
 * 검색 도구를 사용하여 **cfprefsd** 프로세스를 찾습니다.

03.macos/02.installation/docs.ru.md

@@ -82,6 +82,7 @@ AdGuard удалён с вашего Mac!
     * */Library/Application Support/com.adguard.mac.adguard* (папка)
     * *~/Library/Application Support/com.adguard.mac.adguard* (папка)
     * *~/Library/Preferences/com.adguard.mac.adguard.plist* (файл)
+    * *rm -R ~/Library/Group\ Containers/TC3Q7MAJXF.com.adguard.mac* (папка)
 
 Для этого введите и выполните следующие команды через Terminal: 
 

03.macos/02.installation/docs.zh.md

@@ -85,6 +85,7 @@ taxonomy:
     * */Library/Application Support/com.adguard.mac.adguard*（文件夹）
     * *~/Library/Application Support/com.adguard.mac.adguard*（文件夹）
     * *~/Library/Preferences/com.adguard.mac.adguard.plist*（文件）
+    * *rm -R ~/Library/Group\ Containers/TC3Q7MAJXF.com.adguard.mac*（文件夹）
 
 **为了执行上述步骤**，请您打开 Terminal。然后输入并执行以下的指令：