Annotates functions returning retained objects.

ios/public/provider/chrome/browser/geolocation_updater_provider.h

 // Copyright 2015 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.
 
 #ifndef IOS_PUBLIC_PROVIDER_CHROME_BROWSER_GEOLOCATION_UPDATER_H
 #define IOS_PUBLIC_PROVIDER_CHROME_BROWSER_GEOLOCATION_UPDATER_H
 
 #import <CoreLocation/CoreLocation.h>
 #import <Foundation/Foundation.h>
 
@@ skipping 39 matching lines @@
 namespace ios {
 
 class GeolocationUpdaterProvider {
  public:
   GeolocationUpdaterProvider();
   virtual ~GeolocationUpdaterProvider();
 
   // Creates a new GeolocationUpdater.
   // The returned object is retained and it is the responsability of the caller
   // to release it.
-  virtual id<GeolocationUpdater> CreateGeolocationUpdater(bool enabled);
+  virtual id<GeolocationUpdater> CreateGeolocationUpdater(bool enabled)
+      NS_RETURNS_RETAINED;
 
   // Notification names:
 
   // Name of NSNotificationCenter notification posted on user location update.
   // Passes a |CLLocation| for the new location in the userInfo dictionary with
   // the key returned by GetUpdateNewLocationKey().
   virtual NSString* GetUpdateNotificationName();
   // Name of NSNotificationCenter notification posted on when the location
   // manager's stops.
   virtual NSString* GetStopNotificationName();
   // Name of NSNotificationCenter notification posted when the location
   // manager's authorization status changes. For example when the user turns
   // off Locations Services in Settings. The new status is passed as a
   // |NSNumber| representing the |CLAuthorizationStatus| enum value.
   virtual NSString* GetAuthorizationChangeNotificationName();
 
   // Notification keys:
 
   // Key used in the userInfo dictionaries of this class' notifications.
   // Contains a |CLLocation *| and is used in the update notification.
   virtual NSString* GetUpdateNewLocationKey();
 
  private:
   DISALLOW_COPY_AND_ASSIGN(GeolocationUpdaterProvider);
 };
 
 }  // namespace ios
 
 #endif  // IOS_PUBLIC_PROVIDER_CHROME_BROWSER_GEOLOCATION_UPDATER_H