Add deprecated annotation for events in API documentation.

chrome/common/extensions/docs/server2/api_data_source.py

 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 import copy
 import json
 import logging
 import os
 from collections import defaultdict, Mapping
 
@@ skipping 185 matching lines @@
       'description': self._FormatDescription(event.description),
       'filters': [self._GenerateProperty(f) for f in event.filters],
       'conditions': [self._GetLink(condition)
                      for condition in event.conditions],
       'actions': [self._GetLink(action) for action in event.actions],
       'supportsRules': event.supports_rules,
       'supportsListeners': event.supports_listeners,
       'properties': [],
       'id': _CreateId(event, 'event')
     }
+    if (event.deprecated is not None):

[not at google - send to devlin, 2013/10/31 20:23:13]

no need for parens

[dhnishi (use Chromium), 2013/10/31 21:29:23]

Done.

+      event_dict['deprecated'] = self._FormatDescription(
+          event.deprecated)
     if (event.parent is not None and
         not isinstance(event.parent, model.Namespace)):
       event_dict['parentName'] = event.parent.simple_name
     # For the addRules method we can use the common definition, because addRules
     # has the same signature for every event.
     if event.supports_rules:
       event_dict['addRulesFunction'] = self._add_rules_schema_function()
     # We need to create the method description for addListener based on the
     # information stored in |event|.
     if event.supports_listeners:
@@ skipping 433 matching lines @@
 
     if self._disable_refs:
       cache, ext = (
           (self._idl_cache_no_refs, '.idl') if (unix_name in idl_names) else
           (self._json_cache_no_refs, '.json'))
     else:
       cache, ext = ((self._idl_cache, '.idl') if (unix_name in idl_names) else
                     (self._json_cache, '.json'))
     return self._GenerateHandlebarContext(
         cache.GetFromFile('%s/%s%s' % (self._base_path, unix_name, ext)).Get())