Added 'can_be_recommended' flag to the relevant policies.

chrome/app/policy/policy_templates.json

 {
 # policy_templates.json - Metafile for policy templates
 #
 # The content of this file is evaluated as a Python expression.
 #
 # This file is used as input to generate the following policy templates:
 # ADM, ADMX+ADML, MCX/plist and html documentation.
 #
 # Policy templates are user interface definitions or documents about the
 # policies that can be used to configure Chrome. Each policy is a name-value
@@ skipping 76 matching lines @@
 #     chrome.* -> Chrome policy definition list
 #     chrome_os -> Chrome policy definition list, when building OS_CHROMEOS
 #
 # Annotations:
 #   Additional information is specified under keys 'features' and
 #   'example_value'. These are used in the generated documentation and example
 #   policy configuration files. 'dynamic_refresh' controls if the generated
 #   documentation should state that the policy supports dynamic refresh or not.
 #   Supporting dynamic refresh means that Chrome respects the changes to the
 #   policy immediately, without the need for restart.
+#   'can_be_recommended' can be set to True to include that policy in the
+#   recommended policies templates. This only affects the template generation;
+#   all policies can be at the recommended level. The default is False.
 #
 # IDs:
 #   Since a Protocol Buffer definition is generated from this file, unique and
 #   persistent IDs for all fields (but not for groups!) are needed. These are
 #   specified by the 'id' keys of each policy. NEVER CHANGE EXISTING IDs,
 #   because doing so would break the deployed wire format!
 #   For your editing convenience: highest ID currently used: 113
 #
 # Placeholders:
 #   The following placeholder strings are automatically substituted:
@@ skipping 16 matching lines @@
       'desc': '''Configure the default home page in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> and prevents users from changing it.
 
       The user's home page settings are only completely locked down, if you either select the home page to be the new tab page, or set it to be a URL and specify a home page URL. If you don't specify the home page URL, then the user is still able to set the home page to the new tab page by specifying 'chrome://newtab'.''',
       'policies': [
         {
           'name': 'HomepageLocation',
           'type': 'string',
           'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 'http://chromium.org',
+          'can_be_recommended': True,
           'id': 1,
           'caption': '''Configure the home page URL''',
           'desc': '''Configures the default home page URL in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> and prevents users from changing it.
 
           The home page type can either be set to a URL you specify here or set to the New Tab Page.
 
           If you select the New Tab Page, then this policy is ignored.
 
           If you enable this setting, users cannot change their home page URL in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>, but they can still can choose the New Tab Page as their home page.
 
           Leaving this policy not set will allow the user to choose his home page on his own if HomepageIsNewTabPage is not set too.''',
           'label': '''Home page URL''',
         },
         {
           'name': 'HomepageIsNewTabPage',
           'type': 'main',
           'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': True,
+          'can_be_recommended': True,
           'id': 2,
           'caption': '''Use New Tab Page as homepage''',
           'desc': '''Configures the type of the default home page in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> and prevents users from changing home page preferences. The home page can either be set to a URL you specify or set to the New Tab Page.
 
           If you enable this setting, the New Tab Page is always used for the home page, and the home page URL location is ignored.
 
           If you disable this setting, the user's homepage will never be the New Tab Page, unless its URL is set to 'chrome://newtab'.
 
           If you enable or disable this setting, users cannot change their homepage type in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
           Leaving this policy not set will allow the user to choose whether the new tab page is his home page on his own.''',
         },
       ],
     },
     {
       'name': 'DefaultBrowserSettingEnabled',
       'type': 'main',
       'supported_on': ['chrome.*:11-'],
       'features': {'dynamic_refresh': 1},
       'example_value': True,
+      'can_be_recommended': True,

[Mattias Nissler (ping if slow), 2011/12/01 10:11:35]

What's the point here?

[Joao da Silva, 2011/12/07 10:28:41]

Removed.

       'id': 3,
       'caption': '''Set Chrome as Default Browser''',
       'desc': '''Configures the default browser checks in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> and prevents users from changing them.
 
       If you enable this setting, <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> will always check on startup whether it is the default browser and automatically register itself if possible.
 
       If this setting is disabled, <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> will never check if it is the default browser and will disable user controls for setting this option.
 
       If this setting is not set, <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> will allow the user to control whether it is the default browser and whether user notifications should be shown when it isn't.''',
       'label': '''Set Chrome as Default Browser''',
     },
     {
       'name': 'ApplicationLocaleValue',

[pastarmovj, 2011/12/01 09:43:19]

I can imagine some cases where this can be useful as recommended policy too. If
the windows locale is not the proper one for some reason people can still be
guided to the right Chrome locale through a recommended policy but be allowed to
override it if they want to.

[Joao da Silva, 2011/12/07 10:28:41]

I initially skipped this one because chrome_frame reads it directly from the
registry, and I thought a recommended setting wouldn't ever apply. However, I
just verified that there's a --lang command line flag that the user can use, so
it makes sense as recommended after all. Good catch!

       'type': 'string',
       'supported_on': ['chrome.win:8-'],
       'features': {'dynamic_refresh': 0},
       'example_value': 'en',
       'id': 4,
       'caption': '''Application locale''',
       'desc': '''Configures the application locale in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> and prevents users from changing the locale.
 
       If you enable this setting, <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> uses the specified locale. If the configured locale is not supported, 'en-US' is used instead.
 
       If this setting is disabled or not set, <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> uses either the user-specified preferred locale (if configured), the system locale or the fallback locale 'en-US'.''',
       'label': '''Application locale''',
     },
     {
       'name': 'AlternateErrorPagesEnabled',
       'type': 'main',
       'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
       'features': {'dynamic_refresh': 1},
       'example_value': True,
+      'can_be_recommended': True,
       'id': 5,
       'caption': '''Enable alternate error pages''',
       'desc': '''Enables the use of alternate error pages that are built into <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> (such as 'page not found') and prevents users from changing this setting.
 
       If you enable this setting, alternate error pages are used.
 
       If you disable this setting, alternate error pages are never used.
 
       If you enable or disable this setting, users cannot change or override this setting in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
       If this policy is left not set, this will be enabled but the user will be able to change it.''',
     },
     {
       'name': 'SearchSuggestEnabled',
       'type': 'main',
       'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
       'features': {'dynamic_refresh': 1},
       'example_value': True,
+      'can_be_recommended': True,
       'id': 6,
       'caption': '''Enable search suggestions''',
       'desc': '''Enables search suggestions in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>'s Omnibox and prevents users from changing this setting.
 
       If you enable this setting, search suggestions are used.
 
       If you disable this setting, search suggestions are never used.
 
       If you enable or disable this setting, users cannot change or override this setting in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
       If this policy is left not set, this will be enabled but the user will be able to change it.''',
     },
     {
       'name': 'DnsPrefetchingEnabled',
       'type': 'main',
       'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
       'features': {'dynamic_refresh': 1},
       'example_value': True,
+      'can_be_recommended': True,
       'id': 7,
       'caption': '''Enable network prediction.''',
       'desc': '''Enables network prediction in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> and prevents users from changing this setting.
 
       If you enable or disable this setting, users cannot change or override this setting in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
       If this policy is left not set, this will be enabled but the user will be able to change it.''',
     },
     {
       'name': 'DisableSpdy',
       'type': 'main',
       'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
       'features': {'dynamic_refresh': 1},
       'example_value': True,
+      'can_be_recommended': True,

[Joao da Silva, 2011/12/07 10:28:41]

I've removed this one, since there's no knob for the user to toggle this. The
description text has been updated too.

       'id': 8,
       'caption': '''Disable SPDY protocol''',
       'desc': '''Disables use of the SPDY protocol in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
       If this policy is enabled the SPDY protocol will not be available in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
       Setting this policy to disabled will allow the usage of SPDY.
 
       If this policy is left not set, SPDY will be available but the user will be able to change it.''',
     },
@@ skipping 172 matching lines @@
       If this setting is disabled, users cannot enable the proxy, and the machine will not be allowed to share it's printers with <ph name="CLOUD_PRINT_NAME">Google Cloud Print</ph>.
 
       If this policy is left not set, this will be enabled but the user will be able to change it.''',
     },
     {
       'name': 'SafeBrowsingEnabled',
       'type': 'main',
       'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
       'features': {'dynamic_refresh': 0},
       'example_value': True,
+      'can_be_recommended': True,
       'id': 14,
       'caption': '''Enable Safe Browsing''',
       'desc': '''Enables <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>'s Safe Browsing feature and prevents users from changing this setting.
 
       If you enable this setting, Safe Browsing is always active.
 
       If you disable this setting, Safe Browsing is never active.
 
       If you enable or disable this setting, users cannot change or override this setting in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
       If this policy is left not set, this will be enabled but the user will be able to change it.''',
     },
     {
       'name': 'MetricsReportingEnabled',
       'type': 'main',
       'supported_on': ['chrome.*:8-'],
       'features': {'dynamic_refresh': 0},
       'example_value': True,
+      'can_be_recommended': True,
       'id': 15,
       'caption': '''Enable reporting of usage and crash-related data''',
       'desc': '''Enables anonymous reporting of usage and crash-related data about <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> to Google and prevents users from changing this setting.
 
       If you enable this setting, anonymous reporting of usage and crash-related data is sent to Google.
 
       If you disable this setting, anonymous reporting of usage and crash-related data is never sent to Google.
 
       If you enable or disable this setting, users cannot change or override this setting in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
       If this policy is left not set the setting will be what the user chose upon installation / first run.''',
     },
     {
       'name': 'PasswordManager',
       'type': 'group',
       'caption': '''Password manager''',
       'desc': '''Configures the password manager. If the password manager is enabled, then you can choose to enable or disable whether the user may show stored passwords in clear text.''',
       'policies': [
         {
           'name': 'PasswordManagerEnabled',
           'type': 'main',
           'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': True,
+          'can_be_recommended': True,
           'id': 16,
           'caption': '''Enable the password manager''',
           'desc': '''Enables saving passwords and using saved passwords in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
           If you enable this setting, users can have <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> memorize passwords and provide them automatically the next time they log in to a site.
 
           If you disable this setting, users are not able to save passwords or use already saved passwords.
 
           If you enable or disable this setting, users cannot change or override this setting in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
           If this policy is left not set, this will be enabled but the user will be able to change it.''',
         },
         {
           'name': 'PasswordManagerAllowShowPasswords',
           'type': 'main',
           'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': False,
+          'can_be_recommended': True,

[Mattias Nissler (ping if slow), 2011/12/01 10:11:35]

I don't think this makes sense, since the user doesn't have a way to toggle this
AFAIK.

[Joao da Silva, 2011/12/07 10:28:41]

Right, removed.

           'id': 17,
           'caption': '''Allow users to show passwords in Password Manager''',
           'desc': '''Controls whether the user may show passwords in clear text in the password manager.
 
           If you disable this setting, the password manager does not allow showing stored passwords in clear text in the password manager window.
 
           If you enable or do not set this policy, users can view their passwords in clear text in the password manager.''',
         },
       ],
     },
     {
       'name': 'AutoFillEnabled',
       'type': 'main',
       'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
       'features': {'dynamic_refresh': 1},
       'example_value': False,
+      'can_be_recommended': True,
       'id': 18,
       'caption': '''Enable AutoFill''',
       'desc': '''Enables <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>'s AutoFill feature and allows users to auto complete web forms using previously stored information such as address or credit card information.
 
       If you disable this setting, AutoFill will be inaccessible to users.
 
       If you enable this setting or do not set a value, AutoFill will remain under the control of the user. This will allow them to configure AutoFill profiles and to switch AutoFill on or off at their own discretion.''',
     },
     {
       'name': 'DisabledPlugins',
@@ skipping 142 matching lines @@
 
       If this policy is not set the default size will be used and the user will be able to override it with the --media-cache-size flag.''',
       'label': '''Set media disk cache size''',
     },
     {
       'name': 'DownloadDirectory',
       'type': 'string',
       'supported_on': ['chrome.*:11-'],
       'features': {'dynamic_refresh': 1},
       'example_value': '/home/${user_name}/Downloads',
+      'can_be_recommended': True,
       'id': 64,
       'caption': '''Set download directory''',
       'desc': '''Configures the directory that <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> will use for downloading files.
 
       If you set this policy, <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> will use the provided directory regardless whether the user has specified one or enabled the flag to be prompted for download location every time.
 
       If this policy is left not set the default download directory will be used and the user will be able to change it.''',
       'label': '''Set download directory''',
     },
     {
       'name': 'ClearSiteDataOnExit',
       'type': 'main',
       'supported_on': ['chrome.*:11-', 'chrome_os:0.11-'],
       'features': {'dynamic_refresh': 1},
       'example_value': True,
+      'can_be_recommended': True,
       'id': 65,
       'caption': '''Clear site data on browser shutdown''',
       'desc': '''This policy is an override for the "Clear cookies and other site data when I close my browser" content settings option.
 
       When set to enabled <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> will delete all locally stored data from the browser when it is shut down.
 
       If set to disabled site data will not be cleared on exit.
 
       If this policy is left not set <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> will use the default which is to preserve site data on shut down and the user will be able to change this.''',
       'label': '''Clear site data on browser shutdown''',
     },
     {
       'name': 'Proxy',

[pastarmovj, 2011/12/01 09:43:19]

Why don't we make proxy settings recommended too?

[Mattias Nissler (ping if slow), 2011/12/01 10:11:35]

Doesn't make sense on desktop platforms, since system-level configuration would
override recommended.

       'type': 'group',
       'caption': '''Proxy server''',
       'desc': '''Allows you to specify the proxy server used by <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> and prevents users from changing proxy settings.
 
       If you choose to never use a proxy server and always connect directly, all other options are ignored.
 
       If you choose to auto detect the proxy server, all other options are ignored.
 
       For detailed examples, visit:
       <ph name="PROXY_HELP_URL">http://www.chromium.org/developers/design-documents/network-settings#TOC-Command-line-options-for-proxy-sett<ex>http://www.chromium.org/developers/design-documents/network-settings#TOC-Command-line-options-for-proxy-sett</ex></ph>
@@ skipping 312 matching lines @@
           'label': '''Extension IDs and update URLs to be silently installed''',
         },
       ],
     },
     {
       'name': 'ShowHomeButton',
       'type': 'main',
       'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
       'features': {'dynamic_refresh': 1},
       'example_value': True,
+      'can_be_recommended': True,
       'id': 35,
       'caption': '''Show Home button on toolbar''',
       'desc': '''Shows the Home button on <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>'s toolbar.
 
       If you enable this setting, the Home button is always shown.
 
       If you disable this setting, the Home button is never shown.
 
       If you enable or disable this setting, users cannot change or override this setting in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
@@ skipping 37 matching lines @@
             },
             {
               'name': 'RestoreOnStartupIsURLs',
               'value': 4,
               'caption': '''Open a list of URLs'''
             },
           ],
           'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 4,
+          'can_be_recommended': True,
           'id': 37,
           'caption': '''Action on startup''',
           'desc': '''Allows you to specify the behavior on startup.
 
           If you choose 'Open home page' the home page will always be opened when you start <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
           If you choose 'Reopen the URLs that were open last', the URLs that were open last time <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> was closed will be reopened.
 
           If you choose 'Open a list of URLs', the list of 'URLs to open on startup' will be opened when a user starts <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
           If you enable this setting, users cannot change or override it in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
           Disabling this setting is equvalent to leaving it not configured. The user will still be able to change it in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.''',
         },
         {
           'name': 'RestoreOnStartupURLs',
           'type': 'list',
           'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://example.com', 'http://chromium.org'],
+          'can_be_recommended': True,

[Joao da Silva, 2011/12/07 10:28:41]

This has the same effect as the mandatory policy, when used as recommended (the
user can't change the URLs). Removed for now and added a bug to track this.

           'id': 38,
           'caption': '''URLs to open on startup''',
           'desc': '''If 'Open a list of URLs' is selected as the startup action, this allows you to specify the list of URLs that are opened. If left not set no URL will be opened on start up.
 
           This policy only works if the 'RestoreOnStartup' policy is set to 'RestoreOnStartupIsURLs'.''',
         },
       ],
     },
     {
       'name': 'BlockThirdPartyCookies',
       'type': 'main',
       'supported_on': ['chrome.*:10-', 'chrome_os:0.11-'],
       'features': {'dynamic_refresh': 1},
       'example_value': False,
+      'can_be_recommended': True,
       'id': 39,
       'caption': '''Block third party cookies''',
       'desc': '''Blocks third party cookies.
 
       Enabling this setting prevents cookies from being set by web page elements that are not from the domain that is in the browser's address bar.
 
       Disabling this setting allows cookies to be set by web page elements that are not from the domain that is in the browser's address bar and prevents users from changing this setting.
 
       If this policy is left not set, third party cookies will be enabled but the user will be able to change that.''',
     },
@@ skipping 22 matching lines @@
           If you enable or disable this setting, users cannot change or override this setting in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
           If this policy is left not set, the default search provider is enabled, and the user will be able to set the search provider list.''',
         },
         {
           'name': 'DefaultSearchProviderName',
           'type': 'string',
           'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 'My Intranet Search',
+          'can_be_recommended': True,

[Joao da Silva, 2011/12/07 10:28:41]

These turned out not to work as recommended policies. Removed for now and added
a bug to track this.

           'id': 41,
           'caption': '''Default search provider name''',
           'desc': '''Specifies the name of the default search provider. If left empty or not set, the host name specified by the search URL will be used.
 
           This policy is only considered if the 'DefaultSearchProviderEnabled' policy is enabled.''',
         },
         {
           'name': 'DefaultSearchProviderKeyword',
           'type': 'string',
           'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 'mis',
+          'can_be_recommended': True,
           'id': 42,
           'caption': '''Default search provider keyword''',
           'desc': '''Specifies the keyword, which is the shortcut used in the omnibox to trigger the search for this provider.
 
           This policy is optional. If not set, no keyword will activate the search provider.
 
           This policy is only considered if the 'DefaultSearchProviderEnabled' policy is enabled.''',
         },
         {
           'name': 'DefaultSearchProviderSearchURL',
           'type': 'string',
           'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 'http://search.my.company/search?q={searchTerms}',
+          'can_be_recommended': True,
           'id': 43,
           'caption': '''Default search provider search URL''',
           'desc': '''Specifies the URL of the search engine used when doing a default search. The URL should contain the string '<ph name="SEARCH_TERM_MARKER">{searchTerms}</ph>', which will be replaced at query time by the terms the user is searching for.
 
           This option must be set when the 'DefaultSearchProviderEnabled' policy is enabled and will only be respected if this is the case.''',
         },
         {
           'name': 'DefaultSearchProviderSuggestURL',
           'type': 'string',
           'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 'http://search.my.company/suggest?q={searchTerms}',
+          'can_be_recommended': True,
           'id': 44,
           'caption': '''Default search provider suggest URL''',
           'desc': '''Specifies the URL of the search engine used to provide search suggestions. The URL should contain the string '<ph name="SEARCH_TERM_MARKER">{searchTerms}</ph>', which will be replaced at query time by the text the user has entered so far.
 
           This policy is optional. If not set, no suggest URL will be used.
 
           This policy is only respected if the 'DefaultSearchProviderEnabled' policy is enabled.''',
         },
         {
           'name': 'DefaultSearchProviderInstantURL',
           'type': 'string',
           'supported_on': ['chrome.*:10-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 'http://search.my.company/suggest?q={searchTerms}',
+          'can_be_recommended': True,
           'id': 45,
           'caption': '''Default search provider instant URL''',
           'desc': '''Specifies the URL of the search engine used to provide instant results. The URL should contain the string <ph name="SEARCH_TERM_MARKER">'{searchTerms}'</ph>, which will be replaced at query time by the text the user has entered so far.
 
           This policy is optional. If not set, no instant search results will be provided.
 
           This policy is only respected if the 'DefaultSearchProviderEnabled' policy is enabled.''',
         },
         {
           'name': 'DefaultSearchProviderIconURL',
           'type': 'string',
           'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 'http://search.my.company/favicon.ico',
+          'can_be_recommended': True,
           'id': 46,
           'caption': '''Default search provider icon''',
           'desc': '''Specifies the favorite icon URL of the default search provider.
 
           This policy is optional. If not set, no icon will be present for the search provider.
 
           This policy is only respected if the 'DefaultSearchProviderEnabled' policy is enabled.''',
         },
         {
           'name': 'DefaultSearchProviderEncodings',
           'type': 'list',
           'supported_on': ['chrome.*:8-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['UTF-8', 'UTF-16', 'GB2312', 'ISO-8859-1'],
+          'can_be_recommended': True,
           'id': 47,
           'caption': '''Default search provider encodings''',
           'desc': '''Specifies the character encodings supported by the search provider. Encodings are code page names like UTF-8, GB2312, and ISO-8859-1. They are tried in the order provided.
 
           This policy is optional. If not set, the default will be used which is UTF-8.
 
           This policy is only respected if the 'DefaultSearchProviderEnabled' policy is enabled.''',
         },
       ],
     },
@@ skipping 14 matching lines @@
             },
             {
               'name': 'BlockCookies',
               'value': 2,
               'caption': '''Do not allow any site to set local data'''
             },
           ],
           'supported_on': ['chrome.*:10-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 1,
+          'can_be_recommended': True,

[Mattias Nissler (ping if slow), 2011/12/01 10:11:35]

Not sure whether this would actually do the right thing. Have you tested? We
might want to ask Markus.

[Joao da Silva, 2011/12/07 10:28:41]

It DCHECKs on debug and is ignored on release. Removed for now and opened a bug
to track this.

           'id': 48,
           'caption': '''Default cookies setting''',
           'desc': '''Allows you to set whether websites are allowed to set local data. Setting local data can be either allowed for all websites or denied for all websites.
 
           If this policy is left not set, 'AllowCookies' will be used and the user will be able to change it.''',
         },
         {
           'name': 'DefaultImagesSetting',
           'type': 'int-enum',
           'items': [
             {
               'name': 'AllowImages',
               'value': 1,
               'caption': '''Allow all sites to show all images'''
             },
             {
               'name': 'BlockImages',
               'value': 2,
               'caption': '''Do not allow any site to show images'''
             },
           ],
           'supported_on': ['chrome.*:10-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 1,
+          'can_be_recommended': True,
           'id': 49,
           'caption': '''Default images setting''',
           'desc': '''Allows you to set whether websites are allowed to display images. Displaying images can be either allowed for all websites or denied for all websites.
 
           If this policy is left not set, 'AllowImages' will be used and the user will be able to change it.''',
         },
         {
           'name': 'DefaultJavaScriptSetting',
           'type': 'int-enum',
           'items': [
             {
               'name': 'AllowJavaScript',
               'value': 1,
               'caption': '''Allow all sites to run JavaScript'''
             },
             {
               'name': 'BlockJavaScript',
               'value': 2,
               'caption': '''Do not allow any site to run JavaScript'''
             },
           ],
           'supported_on': ['chrome.*:10-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 1,
+          'can_be_recommended': True,
           'id': 50,
           'caption': '''Default JavaScript setting''',
           'desc': '''Allows you to set whether websites are allowed to run JavaScript. Running JavaScript can be either allowed for all websites or denied for all websites.
 
           If this policy is left not set, 'AllowJavaScript' will be used and the user will be able to change it.''',
         },
         {
           'name': 'DefaultPluginsSetting',
           'type': 'int-enum',
           'items': [
             {
               'name': 'AllowPlugins',
               'value': 1,
               'caption': '''Allow all sites to automatically run plugins'''
             },
             {
               'name': 'BlockPlugins',
               'value': 2,
               'caption': '''Block all plugins'''
             },
           ],
           'supported_on': ['chrome.*:10-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 1,
+          'can_be_recommended': True,
           'id': 51,
           'caption': '''Default plugins setting''',
           'desc': '''Allows you to set whether websites are allowed to automatically run plugins. Automatically running plugins can be either allowed for all websites or denied for all websites.
 
           If this policy is left not set, 'AllowPlugins' will be used and the user will be able to change it.''',
         },
         {
           'name': 'DefaultPopupsSetting',
           'type': 'int-enum',
           'items': [
             {
               'name': 'AllowPopups',
               'value': 1,
               'caption': '''Allow all sites to show pop-ups'''
             },
             {
               'name': 'BlockPopups',
               'value': 2,
               'caption': '''Do not allow any site to show popups'''
             },
           ],
           'supported_on': ['chrome.*:10-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 1,
+          'can_be_recommended': True,
           'id': 52,
           'caption': '''Default popups setting''',
           'desc': '''Allows you to set whether websites are allowed to show pop-ups. Showing popups can be either allowed for all websites or denied for all websites.
 
           If this policy is left not set, 'BlockPopups' will be used and the user will be able to change it.''',
         },
         {
           'name': 'DefaultNotificationsSetting',
           'type': 'int-enum',
           'items': [
             {
               'name': 'AllowNotifications',
               'value': 1,
               'caption': '''Allow sites to show desktop notifications'''
             },
             {
               'name': 'BlockNotifications',
               'value': 2,
               'caption': '''Do not allow any site to show desktop notifications'''
             },
             {
               'name': 'AskNotifications',
               'value': 3,
               'caption': '''Ask every time a site wants to show desktop notifications'''
             },
           ],
           'supported_on': ['chrome.*:10-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 2,
+          'can_be_recommended': True,
           'id': 53,
           'caption': '''Default notification setting''',
           'desc': '''Allows you to set whether websites are allowed to display desktop notifications. Displaying desktop notifications can be allowed by default, denied by default or the user can be asked every time a website wants to show desktop notifications.
 
           If this policy is left not set, 'AskNotifications' will be used and the user will be able to change it.''',
         },
         {
           'name': 'DefaultGeolocationSetting',
           'type': 'int-enum',
           'items': [
             {
               'name': 'AllowGeolocation',
               'value': 1,
               'caption': '''Allow sites to track the users' physical location'''
             },
             {
               'name': 'BlockGeolocation',
               'value': 2,
               'caption': '''Do not allow any site to track the users' physical location'''
             },
             {
               'name': 'AskGeolocation',
               'value': 3,
               'caption': '''Ask whenever a site wants to track the users' physical location'''
             },
           ],
           'supported_on': ['chrome.*:10-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': 0,
+          'can_be_recommended': True,
           'id': 54,
           'caption': '''Default geolocation setting''',
           'desc': '''Allows you to set whether websites are allowed to track the users' physical location. Tracking the users' physical location can be allowed by default, denied by default or the user can be asked every time a website requests the physical location.
 
           If this policy is left not set, 'AskGeolocation' will be used and the user will be able to change it.''',
         },
         {
           'name': 'AutoSelectCertificateForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:15-', 'chrome_os:0.15-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ["{\\\"pattern\\\":\\\"https://www.example.com\\\",\\\"filter\\\":{\\\"ISSUER\\\":{\\\"CN\\\":\\\"certificate issuer name\\\"}}}"],
           'id': 102,
           'caption': '''Automatically select client certificates for these sites''',
           'desc': '''Allows you to specify a list of url patterns that specify sites for which <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> should automatically select a client certificates, if the site requests a certificate.
 
           If this policy is left not set no auto-selection will be done for any site.''',
         },
         {
           'name': 'CookiesAllowedForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:11-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://www.example.com', '[*.]example.edu'],
+          'can_be_recommended': True,
           'id': 77,
           'caption': '''Allow cookies on these sites''',
           'desc': '''Allows you to set a list of url patterns that specify sites which are allowed to set cookies.
 
           If this policy is left not set the global default value will be used for all sites either from the 'DefaultCookiesSetting' policy if it is set, or the user's personal configuration otherwise.''',
         },
         {
           'name': 'CookiesBlockedForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:11-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://www.example.com', '[*.]example.edu'],
+          'can_be_recommended': True,
           'id': 67,
           'caption': '''Block cookies on these sites''',
           'desc': '''Allows you to set a list of url patterns that specify sites which are not allowed to set cookies.
 
           If this policy is left not set the global default value will be used for all sites either from the 'DefaultCookiesSetting' policy if it is set, or the user's personal configuration otherwise.''',
         },
         {
           'name': 'CookiesSessionOnlyForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:11-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://www.example.com', '[*.]example.edu'],
+          'can_be_recommended': True,
           'id': 68,
           'caption': '''Allow session only cookies on these sites''',
           'desc': '''Allows you to set a list of url patterns that specify sites which are allowed to set session only cookies.
 
           If this policy is left not set the global default value will be used for all sites either from the 'DefaultCookiesSetting' policy if it is set, or the user's personal configuration otherwise.''',
         },
         {
           'name': 'ImagesAllowedForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:11-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://www.example.com', '[*.]example.edu'],
+          'can_be_recommended': True,
           'id': 69,
           'caption': '''Allow images on these sites''',
           'desc': '''Allows you to set a list of url patterns that specify sites which are allowed to display images.
 
           If this policy is left not set the global default value will be used for all sites either from the 'DefaultImagesSetting' policy if it is set, or the user's personal configuration otherwise.''',
         },
         {
           'name': 'ImagesBlockedForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:11-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://www.example.com', '[*.]example.edu'],
+          'can_be_recommended': True,
           'id': 70,
           'caption': '''Block images on these sites''',
           'desc': '''Allows you to set a list of url patterns that specify sites which are not allowed to display images.
 
           If this policy is left not set the global default value will be used for all sites either from the 'DefaultImagesSetting' policy if it is set, or the user's personal configuration otherwise.''',
         },
         {
           'name': 'JavaScriptAllowedForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:11-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://www.example.com', '[*.]example.edu'],
+          'can_be_recommended': True,
           'id': 71,
           'caption': '''Allow JavaScript on these sites''',
           'desc': '''Allows you to set a list of url patterns that specify sites which are allowed to run JavaScript.
 
           If this policy is left not set the global default value will be used for all sites either from the 'DefaultJavaScriptSetting' policy if it is set, or the user's personal configuration otherwise.''',
         },
         {
           'name': 'JavaScriptBlockedForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:11-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://www.example.com', '[*.]example.edu'],
+          'can_be_recommended': True,
           'id': 72,
           'caption': '''Block JavaScript on these sites''',
           'desc': '''Allows you to set a list of url patterns that specify sites which are not allowed to run JavaScript.
 
           If this policy is left not set the global default value will be used for all sites either from the 'DefaultJavaScriptSetting' policy if it is set, or the user's personal configuration otherwise.''',
         },
         {
           'name': 'PluginsAllowedForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:11-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://www.example.com', '[*.]example.edu'],
+          'can_be_recommended': True,
           'id': 73,
           'caption': '''Allow plugins on these sites''',
           'desc': '''Allows you to set a list of url patterns that specify sites which are allowed to run plugins.
 
           If this policy is left not set the global default value will be used for all sites either from the 'DefaultPluginsSetting' policy if it is set, or the user's personal configuration otherwise.''',
         },
         {
           'name': 'PluginsBlockedForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:11-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://www.example.com', '[*.]example.edu'],
+          'can_be_recommended': True,
           'id': 74,
           'caption': '''Block plugins on these sites''',
           'desc': '''Allows you to set a list of url patterns that specify sites which are not allowed to run plugins.
 
           If this policy is left not set the global default value will be used for all sites either from the 'DefaultPluginsSetting' policy if it is set, or the user's personal configuration otherwise.''',
         },
         {
           'name': 'PopupsAllowedForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:11-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://www.example.com', '[*.]example.edu'],
+          'can_be_recommended': True,
           'id': 75,
           'caption': '''Allow popups on these sites''',
           'desc': '''Allows you to set a list of url patterns that specify sites which are allowed to open popups.
 
           If this policy is left not set the global default value will be used for all sites either from the 'DefaultPopupsSetting' policy if it is set, or the user's personal configuration otherwise.''',
         },
         {
           'name': 'PopupsBlockedForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:11-', 'chrome_os:0.11-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://www.example.com', '[*.]example.edu'],
+          'can_be_recommended': True,
           'id': 76,
           'caption': '''Block popups on these sites''',
           'desc': '''Allows you to set a list of url patterns that specify sites which are not allowed to open popups.
 
           If this policy is left not set the global default value will be used for all sites either from the 'DefaultPopupsSetting' policy if it is set, or the user's personal configuration otherwise.''',
         },
         {
           'name': 'NotificationsAllowedForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:16-', 'chrome_os:0.16-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://www.example.com', '[*.]example.edu'],
+          'can_be_recommended': True,
           'id': 105,
           'caption': '''Allow notifications on these sites''',
           'desc': '''Allows you to set a list of url patterns that specify sites which are allowed to display notifications.
 
           If this policy is left not set the global default value will be used for all sites either from the 'DefaultNotificationsSetting' policy if it is set, or the user's personal configuration otherwise.''',
         },
         {
           'name': 'NotificationsBlockedForUrls',
           'type': 'list',
           'supported_on': ['chrome.*:16-', 'chrome_os:0.16-'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://www.example.com', '[*.]example.edu'],
+          'can_be_recommended': True,
           'id': 106,
           'caption': '''Block notifications on these sites''',
           'desc': '''Allows you to set a list of url patterns that specify sites which are not allowed to display notifications.
 
           If this policy is left not set the global default value will be used for all sites either from the 'DefaultNotificationsSetting' policy if it is set, or the user's personal configuration otherwise.''',
         }
       ],
     },
     {
       'name': 'Disable3DAPIs',
@@ skipping 99 matching lines @@
           'example_value': ['text/xml', 'application/xml'],
           'id': 60,
           'caption': '''Allow <ph name="PRODUCT_FRAME_NAME">$3<ex>Google Chrome Frame</ex></ph> to handle the listed content types.''',
           'desc': '''Allow <ph name="PRODUCT_FRAME_NAME">$3<ex>Google Chrome Frame</ex></ph> to handle the listed content types.
 
           If this policy is not set the default renderer will be used for all sites as specified by the 'ChromeFrameRendererSettings' policy.''',
         },
       ],
     },
     {
       'name': 'ChromeOsLockOnIdleSuspend',

[Mattias Nissler (ping if slow), 2011/12/01 10:11:35]

why does this not have the flag?

[Joao da Silva, 2011/12/07 10:28:41]

Good catch, added.

       'type': 'main',
       'supported_on': ['chrome_os:0.9-'],
       'features': {'dynamic_refresh': 1},
       'example_value': True,
       'id': 61,
       'caption': '''Enable lock when ChromeOS devices become idle or suspended.''',
       'desc': '''Enable lock when ChromeOS devices become idle or suspended.
 
       If you enable this setting, users will be asked for a password to unlock ChromeOS devices from sleep.
 
       If you disable this setting, users will not be asked for a password to wake ChromeOS devices from sleep.
 
       If you enable or disable this setting, users cannot change or override this setting in <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph>.
 
       If the policy is left not set the user can choose whether he wants to be asked for password to unlock the device or not.''',
     },
     {
       'name': 'InstantEnabled',
       'type': 'main',
       'supported_on': ['chrome.*:11-', 'chrome_os:0.11-'],
       'features': {'dynamic_refresh': 1},
       'example_value': True,
+      'can_be_recommended': True,
       'id': 62,
       'caption': '''Enable Instant''',
       'desc': '''Enables <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>'s Instant feature and prevents users from changing this setting.
 
       If you enable this setting, <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> Instant is enabled.
 
       If you disable this setting, <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> Instant is disabled.
 
       If you enable or disable this setting, users cannot change or override this setting.
 
       If this setting is left not set the user can decide to use this function or not.''',
     },
     {
       'name': 'TranslateEnabled',
       'type': 'main',
       'supported_on': ['chrome.*:12-', 'chrome_os:0.12-'],
       'features': {'dynamic_refresh': 1},
       'example_value': True,
+      'can_be_recommended': True,
       'id': 80,
       'caption': '''Enable Translate''',
       'desc': '''Enables the integrated Google Translate service on <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
       If you enable this setting, <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> will show an integrated toolbar offering to translate the page for the user, when appropriate.
 
       If you disable this setting, users will never see the translation bar.
 
       If you enable or disable this setting, users cannot change or override this setting in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
@@ skipping 28 matching lines @@
       If you enable this setting, plugins that are not outdated always run.
 
       If this setting is disabled or not set, users will be asked for permission to run plugins that require authorization. These are plugins that can compromise security.''',
     },
     {
       'name': 'BookmarkBarEnabled',
       'type': 'main',
       'supported_on': ['chrome.*:12-', 'chrome_os:0.12-'],
       'features': {'dynamic_refresh': 1},
       'example_value': True,
+      'can_be_recommended': True,
       'id': 82,
       'caption': '''Enable Bookmark Bar''',
       'desc': '''Enables the bookmark bar on <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
       If you enable this setting, <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> will show a bookmark bar.
 
       If you disable this setting, users will never see the bookmark bar.
 
       If you enable or disable this setting, users cannot change or override it in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
@@ skipping 96 matching lines @@
       'id': 97,
       'caption': '''Import bookmarks from default browser on first run''',
       'desc': '''This policy forces bookmarks to be imported from the current default browser if enabled. If enabled, this policy also affects the import dialog.
 
       If disabled, no bookmarks are imported.
 
       If it is not set, the user may be asked whether to import, or importing may happen automatically.''',
       'label': '''Import bookmarks from default browser on first run''',
     },
     {
       'name': 'ImportHistory',

[pastarmovj, 2011/12/01 09:43:19]

For all the import policies I think those might be recommended as well. The idea
is that if the admin set those to false it will skip initial import but the
import option in the settings will work so that users can still do it from
"preferences" if they feel like they want to. 

[Mattias Nissler (ping if slow), 2011/12/01 10:11:35]

seconded. These should actually work fine, but please test :)

[Joao da Silva, 2011/12/07 10:28:41]

Tested and works as expected (sets the default for the checkboxes on the import
dialog).

       'type': 'main',
       'supported_on': ['chrome.*:15-'],
       'features': {'dynamic_refresh': 1},
       'example_value': True,
       'id': 98,
       'caption': '''Import browsing history from default browser on first run''',
       'desc': '''This policy forces the browsing history to be imported from the current default browser if enabled. If enabled, this policy also affects the import dialog.
 
       If disabled, no browsing history is imported.
 
@@ skipping 264 matching lines @@
       'desc': '''The name of the feature that indicates for a given policy that changes to it are respected by Chrome without a browser restart''',
       'text': '''Dynamic Policy Refresh'''
     },
     'doc_deprecated': {
       'desc': '''Text appended in parentheses to the policy name to indicate t hat it has been deprecated''',
       'text': 'deprecated',
     }
   },
   'placeholders': [],
 }