Added note in Preferences section

[policy-templates.git] / README.md

diff --git a/README.md b/README.md
index 3f0caa1e6b17d25c94cd4cd3b2b45a6120f3cc52..68b003071be5a2fb9c1b096c623d86c2a9755b9a 100644 (file)
--- a/README.md
+++ b/README.md
@@ -75,8 +75,8 @@ Policies can be specified using the [Group Policy templates on Windows](https://
 | **[`Permissions`](#permissions)** | Set permissions associated with camera, microphone, location, and notifications.
 | **[`PictureInPicture`](#pictureinpicture)** | Enable or disable Picture-in-Picture.
 | **[`PopupBlocking`](#popupblocking)** | Configure the default pop-up window policy as well as origins for which pop-up windows are allowed.
 | **[`Permissions`](#permissions)** | Set permissions associated with camera, microphone, location, and notifications.
 | **[`PictureInPicture`](#pictureinpicture)** | Enable or disable Picture-in-Picture.
 | **[`PopupBlocking`](#popupblocking)** | Configure the default pop-up window policy as well as origins for which pop-up windows are allowed.

-| **[`Preferences`](#preferences)** | Set and lock preferences.
-| **[`Preferences (Deprecated)`](#preferences--deprecated)** | Set and lock some preferences.
+| **[`Preferences`](#preferences)** | Set and lock preferences. (NOTE: in order to use this, settings in the **[`Preferences (Deprecated)`](#preferences-deprecated)** section must be cleared.
+| **[`Preferences (Deprecated)`](#preferences-deprecated)** | Set and lock some preferences.

 | **[`PromptForDownloadLocation`](#promptfordownloadlocation)** | Ask where to save each file before downloading.
 | **[`Proxy`](#proxy)** | Configure proxy settings.
 | **[`RequestedLocales`](#requestedlocales)** | Set the the list of requested locales for the application in order of preference.
 | **[`PromptForDownloadLocation`](#promptfordownloadlocation)** | Ask where to save each file before downloading.
 | **[`Proxy`](#proxy)** | Configure proxy settings.
 | **[`RequestedLocales`](#requestedlocales)** | Set the the list of requested locales for the application in order of preference.


@@ -1592,7 +1592,7 @@ Value (string):
   <dict>
     <key>InvalidCertificate</key>
     <true/> | <false/>
   <dict>
     <key>InvalidCertificate</key>
     <true/> | <false/>

-    <key><SafeBrowsing/key>
+    <key>SafeBrowsing</key>

     <true/> | <false/>
   </dict>
 </dict>
     <true/> | <false/>
   </dict>
 </dict>


@@ -2071,11 +2071,11 @@ Value (string):
   <dict>
     <key>Value</key>
     <true/> | <false/>
   <dict>
     <key>Value</key>
     <true/> | <false/>

-    <key><Locked</key>
+    <key>Locked</key>

     <true/> | <false/>
     <true/> | <false/>

-    <key><Cryptomining</key>
+    <key>Cryptomining</key>

     <true/> | <false/>
     <true/> | <false/>

-    <key><Fingerprinting</key>
+    <key>Fingerprinting</key>

     <true/> | <false/>
     <key>Exceptions</key>
     <array>
     <true/> | <false/>
     <key>Exceptions</key>
     <array>


@@ -2130,7 +2130,7 @@ Value (string):
   <dict>
     <key>Enabled</key>
     <true/> | <false/>
   <dict>
     <key>Enabled</key>
     <true/> | <false/>

-    <key><Locked</key>
+    <key>Locked</key>

     <true/> | <false/>
   </dict>
 </dict>
     <true/> | <false/>
   </dict>
 </dict>


@@ -3343,7 +3343,7 @@ Value (string):
   <dict>
     <key>Enabled</key>
     <true/> | <false/>
   <dict>
     <key>Enabled</key>
     <true/> | <false/>

-    <key><EnablePermissions</key>
+    <key>EnablePermissions</key>

     <true/> | <false/>
   </dict>
 </dict>
     <true/> | <false/>
   </dict>
 </dict>


@@ -3359,7 +3359,7 @@ Value (string):
 }
 ```
 ### Permissions
 }
 ```
 ### Permissions

-Set permissions associated with camera, microphone, location, notifications, autoplay, and virtual reality. Because these are origins, not domains, entries with unique ports must be specified separately. See examples below.
+Set permissions associated with camera, microphone, location, notifications, autoplay, and virtual reality. Because these are origins, not domains, entries with unique ports must be specified separately. This explicitly means that it is not possible to add wildcards. See examples below.

 
 `Allow` is a list of origins where the feature is allowed.
 
 
 `Allow` is a list of origins where the feature is allowed.
 


@@ -3752,6 +3752,8 @@ Value (string):
 ### Preferences
 Set and lock preferences.
 
 ### Preferences
 Set and lock preferences.
 

+**NOTE** In order to use this policy, you must clear all settings in the old **Preferences (Deprecated)** section.
+

 Previously you could only set and lock a subset of preferences. Starting with Firefox 81 and Firefox ESR 78.3 you can set many more preferences. You can also set default preferences, user preferences and you can clear preferences.
 
 Preferences that start with the following prefixes are supported:
 Previously you could only set and lock a subset of preferences. Starting with Firefox 81 and Firefox ESR 78.3 you can set many more preferences. You can also set default preferences, user preferences and you can clear preferences.
 
 Preferences that start with the following prefixes are supported: