Add version information to the policy templates

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 40 matching lines @@
 #     or other messages of the policy HomepageLocation:
 #       IDS_POLICY_HOMEPAGELOCATION_LABEL
 #       IDS_POLICY_HOMEPAGELOCATION_DESC
 #   -For enum items:
 #     IDS_POLICY_ENUM_<NAME OF THE ITEM>
 #     e.g. the name of the caption of ProxyServerDisabled:
 #       IDS_POLICY_ENUM_PROXYSERVERDISABLED_CAPTION
 #
 # Annotations:
 #   Each policy has metadata under the key 'annotations'.
-#   These values are only used for the generated documentation, except for
-#   'platforms', that is also used for filtering policies. It is a list
-#   enumerating the platforms on which Chrome supports the given policy.
-#   In a given template, only those policies are included that are compatible
-#   with the target OS of that template.
-#     Windows: ADM,ADMX,ADML
-#     Mac: plist,plist_strings
+#   These values are only used for the generated documentation.
+#
+# Products and versions:
+#   Each policy has the list of products and version numbers where it is
+#   supported under the key 'supported_on'. Each item of this list has the
+#   form of 'product:since_version-until_version', which means that support
+#   for the policy in 'product' was introduced in 'since_version' and removed
+#   after 'until_version'. Product names may contain a suffix specifying a
+#   platform name, e.g.: 'chrome.win' is read as 'Chrome on Windows'. Version
+#   numbers can be any string that does not contain ':' or '-' characters.
+#
+# Currently supported product names:
+#     'chrome_frame', 'chrome_os'
+#     'chrome.win', 'chrome.linux', 'chrome.mac', 'chrome.*'
+#     For example if 'chrome.*:5-10' is specified for a policy, then it should
+#     be read as:
+#     'chrome.linux:5-10,chrome.mac:5-10,chrome.win:5-10'
+#   The product name also affects in which templates will the policy be included.
+#     chrome.*, chrome.win, chrome_frame -> ADM,ADMX,ADML,doc
+#     chrome.*, chrome.linux -> JSON,doc
+#     chrome.*, chrome.mac -> plist, plist_strings,doc
+#     everything else -> doc
 #
   'policy_definitions': [
     {
       'name': 'Homepage',
       'type': 'group',
       'policies': [
         {
           'name':  'HomepageLocation',
           'type': 'string',
+          'supported_on': ['chrome.*:8-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 1},
             'example_value': 'http://chromium.org',
           }
         },
         {
           'name': 'HomepageIsNewTabPage',
           'type': 'main',
+          'supported_on': ['chrome.*:8-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 1},
             'example_value': True,
           }
         }
       ]
     },
     {
       'name': 'ApplicationLocaleValue',
       'type': 'string',
+      'supported_on': ['chrome.win:8-'],
       'annotations': {
-        'platforms': ['win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 0},
         'example_value': 'en',
       },
     },
     {
       'name': 'AlternateErrorPagesEnabled',
       'type': 'main',
+      'supported_on': ['chrome.*:8-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 1},
         'example_value': True,
       },
     },
     {
       'name': 'SearchSuggestEnabled',
       'type': 'main',
+      'supported_on': ['chrome.*:8-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 1},
         'example_value': True,
       }
     },
     {
       'name': 'DnsPrefetchingEnabled',
       'type': 'main',
+      'supported_on': ['chrome.*:8-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 1},
         'example_value': True,
       }
     },
     {
       'name': 'DisableSpdy',
       'type': 'main',
+      'supported_on': ['chrome.*:8-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 1},
         'example_value': True,
       }
     },
     {
       'name': 'JavascriptEnabled',
       'type': 'main',
+      'supported_on': ['chrome.*:8-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 0},
         'example_value': True,
       }
     },
     {
       'name': 'SavingBrowserHistoryDisabled',
       'type': 'main',
+      'supported_on': ['chrome.*:8-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 1},
         'example_value': True,
       }
     },
     {
       'name': 'PrintingEnabled',
       'type': 'main',
+      'supported_on': ['chrome.*:8-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 1},
         'example_value': True,
       }
     },
     {
       'name': 'SafeBrowsingEnabled',
       'type': 'main',
+      'supported_on': ['chrome.*:8-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 0},
         'example_value': True,
       }
     },
     {
       'name': 'MetricsReportingEnabled',
       'type': 'main',
+      'supported_on': ['chrome.*:8-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 0},
         'example_value': True,
         'problem_href':
           'http://www.chromium.org/administrators/'
           'policy-list-3/metrics-reporting-enabled',
       }
     },
     {
       'name': 'PasswordManager',
       'type': 'group',
       'policies': [{
         'name': 'PasswordManagerEnabled',
         'type': 'main',
+        'supported_on': ['chrome.*:8-'],
         'annotations': {
-          'platforms': ['linux', 'mac', 'win'],
-          'products': ['chrome'],
           'features': {'dynamic_refresh': 1},
           'example_value': True,
         }
       },
       {
         'name': 'PasswordManagerAllowShowPasswords',
         'type': 'main',
+        'supported_on': ['chrome.*:8-'],
         'annotations': {
-          'platforms': ['linux', 'mac', 'win'],
-          'products': ['chrome'],
           'features': {'dynamic_refresh': 1},
           'example_value': False,
         }
       }]
     },
     {
       'name': 'AutoFillEnabled',
       'type': 'main',
+      'supported_on': ['chrome.*:8-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 1},
         'example_value': False,
       }
     },
     {
       'name': 'DisabledPlugins',
       'type': 'list',
+      'supported_on': ['chrome.*:8-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 1},
         'example_value': ['Java', 'Shockwave Flash', 'Chrome PDF Viewer'],
       }
     },
     {
       'name': 'SyncDisabled',
       'type': 'main',
+      'supported_on': ['chrome.*:8-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 1},
         'example_value': True,
       }
     },
     {
       'name': 'Proxy',
       'type': 'group',
       'policies': [
         {
           'name': 'ProxyServerMode',
           'type': 'enum',
           'items': [
             {'name': 'ProxyServerDisabled', 'value': '0'},
             {'name': 'ProxyServerAutoDetect', 'value': '1'},
             {'name': 'ProxyServerManual', 'value': '2'},
             {'name': 'ProxyServerUseSystem', 'value': '3'},
           ],
+          'supported_on': ['chrome.*:8-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 0},
             'example_value': 2,
           }
         },
         {
           'name': 'ProxyServer',
           'type': 'string',
+          'supported_on': ['chrome.*:8-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 0},
             'example_value': '123.123.123.123:8080',
           }
         },
         {
           'name': 'ProxyPacUrl',
           'type': 'string',
+          'supported_on': ['chrome.*:8-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 0},
             'example_value': 'http://internal.site/example.pac'
           }
         },
         {
           'name': 'ProxyBypassList',
           'type': 'string',
+          'supported_on': ['chrome.*:8-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 0},
             'example_value':
               'http://www.example1.com,'
               'http://www.example2.com,http://internalsite/',
           }
         },
       ]
     },
     {
       'name': 'HTTPAuthentication',
       'type': 'group',
       'policies': [
         {
           'name': 'AuthSchemes',
           'type': 'string',
+          'supported_on': ['chrome.*:9-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 0},
             'example_value': 'basic,digest,ntlm,negotiate',
           }
         },
         {
           'name': 'DisableAuthNegotiateCnameLookup',
           'type': 'main',
+          'supported_on': ['chrome.*:9-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 0},
             'example_value': False,
           }
         },
         {
           'name': 'EnableAuthNegotiatePort',
           'type': 'main',
+          'supported_on': ['chrome.*:9-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 0},
             'example_value': False,
           }
         },
         {
           'name': 'AuthServerWhitelist',
           'type': 'string',
+          'supported_on': ['chrome.*:9-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 0},
             'example_value': '*example.com,foobar.com,*baz',
           }
         },
         {
           'name': 'AuthNegotiateDelegateWhitelist',
           'type': 'string',
+          'supported_on': ['chrome.*:9-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 0},
             'example_value': 'foobar.example.com',
           }
         },
         {
           'name': 'GSSAPILibraryName',
           'type': 'string',
+          'supported_on': ['chrome.linux:9-', 'chrome.mac:9-'],
           'annotations': {
-            'platforms': ['linux', 'mac'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 0},
             'example_value': 'libgssapi_krb5.so.2',
           }
         },
       ]
     },
     {
       'name': 'Extensions',
       'type': 'group',
       'policies': [{
         'name': 'ExtensionInstallBlacklist',
         'type': 'list',
+        'supported_on': ['chrome.*:8-'],
         'annotations': {
-          'platforms': ['linux', 'mac', 'win'],
-          'products': ['chrome'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['extension_id1', 'extension_id2']
         }
       },
       {
         'name': 'ExtensionInstallWhitelist',
         'type': 'list',
+        'supported_on': ['chrome.*:8-'],
         'annotations': {
-          'platforms': ['linux', 'mac', 'win'],
-          'products': ['chrome'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['extension_id1', 'extension_id2']
         }
       },
       {
-        'name': 'ExtensionInstallForcelist',
-        'type': 'list',
-        'annotations': {
-          'platforms': ['linux', 'mac', 'win'],
-          'products': ['chrome'],
+        'name': 'ExtensionInstallForcelist',
+        'type': 'list',
+        'supported_on': ['chrome.*:9-'],
+        'annotations': {
           'features': {'dynamic_refresh': 0},
           'example_value': [
             'lcncmkcnkcdbbanbjakcencbaoegdjlp;'
             'https://clients2.google.com/service/update2/crx'
-          ]
-        }
+          ]
+        }
       }]
     },
     {
       'name': 'ShowHomeButton',
       'type': 'main',
+      'supported_on': ['chrome.*:8-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
         'features': {'dynamic_refresh': 1},
         'example_value': True
       }
     },
     {
       'name': 'DeveloperToolsDisabled',
       'type': 'main',
+      'supported_on': ['chrome.*:9-'],
       'annotations': {
-        'platforms': ['linux', 'mac', 'win'],
-        'products': ['chrome'],
-        'features': {'dynamic_refresh': 1},
-        'example_value': False,
+        'features': {'dynamic_refresh': 1},
+        'example_value': False,
       }
     },
     {
       'name': 'RestoreOnStartupGroup',
       'type': 'group',
       'policies': [{
         'name': 'RestoreOnStartup',
         'type': 'enum',
         'items': [
           {'name': 'RestoreOnStartupIsNone', 'value': '0'},
           {'name': 'RestoreOnStartupIsLastSession', 'value': '1'},
           {'name': 'RestoreOnStartupIsURLs', 'value': '4'},
         ],
+        'supported_on': ['chrome.*:8-'],
         'annotations': {
-          'platforms': ['linux', 'mac', 'win'],
-          'products': ['chrome'],
           'features': {'dynamic_refresh': 1},
           'example_value': 4,
         }
       },{
         'name': 'RestoreOnStartupURLs',
         'type': 'list',
+        'supported_on': ['chrome.*:8-'],
         'annotations': {
-          'platforms': ['linux', 'mac', 'win'],
-          'products': ['chrome'],
           'features': {'dynamic_refresh': 1},
           'example_value': ['http://example.com', 'http://chromium.org'],
         }
       }]
     },
     {
       'name': 'DefaultSearchProvider',
       'type': 'group',
       'policies': [
         {
           'name': 'DefaultSearchProviderEnabled',
           'type': 'main',
+          'supported_on': ['chrome.*:8-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 1},
             'example_value': True,
           }
         },
         {
           'name': 'DefaultSearchProviderName',
           'type': 'string',
+          'supported_on': ['chrome.*:8-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 1},
             'example_value': 'My Intranet Search',
           }
         },
         {
           'name': 'DefaultSearchProviderKeyword',
           'type': 'string',
+          'supported_on': ['chrome.*:8-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 1},
             'example_value': 'mis',
           }
         },
         {
           'name': 'DefaultSearchProviderSearchURL',
           'type': 'string',
+          'supported_on': ['chrome.*:8-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 1},
             'example_value': 'http://search.my.company/search?q={searchTerms}',
           }
         },
         {
           'name': 'DefaultSearchProviderSuggestURL',
           'type': 'string',
+          'supported_on': ['chrome.*:8-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 1},
             'example_value': 'http://search.my.company/suggest?q={searchTerms}',
           }
         },
         {
           'name': 'DefaultSearchProviderIconURL',
           'type': 'string',
+          'supported_on': ['chrome.*:8-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 1},
             'example_value': 'http://search.my.company/favicon.ico',
           }
         },
         {
           'name': 'DefaultSearchProviderEncodings',
           'type': 'list',
+          'supported_on': ['chrome.*:8-'],
           'annotations': {
-            'platforms': ['linux', 'mac', 'win'],
-            'products': ['chrome'],
             'features': {'dynamic_refresh': 1},
             'example_value': ['UTF-8', 'UTF-16', 'GB2312', 'ISO-8859-1']
           }
         },
       ]
     },
     {
       'name': 'ChromeFrameRendererSettings',
       'type': 'group',
       'policies': [{
         'name': 'ChromeFrameRendererSettings',
         'type': 'enum',
         'items': [
             {'name': 'RenderInHost', 'value': '0'},
             {'name': 'RenderInChromeFrame', 'value': '1'},
         ],
+        'supported_on': ['chrome_frame:8-'],
         'annotations': {
-          'platforms': ['win'],
-          'products': ['chrome_frame'],
           'features': {'dynamic_refresh': 0},
           'example_value': 1,
         }
       }, {
         'name': 'RenderInChromeFrameList',
         'type': 'list',
+        'supported_on': ['chrome_frame:8-'],
         'annotations': {
-          'platforms': ['win'],
-          'products': ['chrome_frame'],
           'features': {'dynamic_refresh': 0},
           'example_value': ['http://www.example.com', 'http://www.example.edu'],
         }
       }, {
         'name': 'RenderInHostList',
         'type': 'list',
+        'supported_on': ['chrome_frame:8-'],
         'annotations': {
-          'platforms': ['win'],
-          'products': ['chrome_frame'],
           'features': {'dynamic_refresh': 0},
           'example_value': ['http://www.example.com', 'http://www.example.edu'],
         }
       }],
     },
     {
       'name': 'ChromeFrameContentTypes',
       'type': 'group',
       'policies': [{
         'name': 'ChromeFrameContentTypes',
         'type': 'list',
+        'supported_on': ['chrome_frame:8-'],
         'annotations': {
-          'platforms': ['win'],
-          'products': ['chrome_frame'],
           'features': {'dynamic_refresh': 0},
           'example_value': ['text/xml', 'application/xml'],
         }
       }],
     },
     {
       'name': 'ChromeOsLockOnIdleSuspend',
       'type': 'main',
+      'supported_on': ['chrome_os:0.9.79.0-'],
       'annotations': {
-        'platforms': ['chrome_os'],
-        'products': ['chrome_os'],
         'features': {'dynamic_refresh': 1},
         'example_value': True,
       }
     },
   ],
   'placeholders': [
     # Note: keys $1 and $3 are reserved for Chromium and Chromium Frame.
     # Key $6 is reserved for doc_writer.
     {
       'key': '$2',
       'value': 'http://www.chromium.org/developers/design-documents/network-settings#TOC-Command-line-options-for-proxy-sett'
     },
     {
       'key': '$4',
       'value': 'http://www.chromium.org/developers/how-tos/chrome-frame-getting-started'
     },
     {
       'key': '$5',
       'value': 'http://www.chromium.org/administrators/policy-templates'
     },
   ]
 }