reflow comments in public/platform/

third_party/WebKit/public/platform/Platform.h

 /*
  * Copyright (C) 2012 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 310 matching lines @@
 
   // Process -------------------------------------------------------------
 
   // Returns a unique identifier for a process. This may not necessarily be
   // the process's process ID.
   virtual uint32_t getUniqueIdForProcess() { return 0; }
 
   // Message Ports -------------------------------------------------------
 
   // Creates a Message Port Channel pair. This can be called on any thread.
-  // The returned objects should only be used on the thread they were created on.
+  // The returned objects should only be used on the thread they were created
+  // on.
   virtual void createMessageChannel(WebMessagePortChannel** channel1,
                                     WebMessagePortChannel** channel2) {
     *channel1 = 0;
     *channel2 = 0;
   }
 
   // Network -------------------------------------------------------------
 
   // Returns a new WebURLLoader instance.
   virtual WebURLLoader* createURLLoader() { return nullptr; }
 
   // May return null.
   virtual WebPrescientNetworking* prescientNetworking() { return nullptr; }
 
   // Returns the User-Agent string.
   virtual WebString userAgent() { return WebString(); }
 
   // A suggestion to cache this metadata in association with this URL.
   virtual void cacheMetadata(const WebURL&,
                              int64_t responseTime,
                              const char* data,
                              size_t dataSize) {}
 
-  // A suggestion to cache this metadata in association with this URL which resource is in CacheStorage.
+  // A suggestion to cache this metadata in association with this URL which
+  // resource is in CacheStorage.
   virtual void cacheMetadataInCacheStorage(
       const WebURL&,
       int64_t responseTime,
       const char* data,
       size_t dataSize,
       const blink::WebSecurityOrigin& cacheStorageOrigin,
       const WebString& cacheStorageCacheName) {}
 
-  // Returns the decoded data url if url had a supported mimetype and parsing was successful.
+  // Returns the decoded data url if url had a supported mimetype and parsing
+  // was successful.
   virtual WebData parseDataURL(const WebURL&,
                                WebString& mimetype,
                                WebString& charset) {
     return WebData();
   }
 
   virtual WebURLError cancelledError(const WebURL&) const {
     return WebURLError();
   }
 
@@ skipping 47 matching lines @@
 
   // Returns a blame context for attributing top-level work which does not
   // belong to a particular frame scope.
   virtual BlameContext* topLevelBlameContext() { return nullptr; }
 
   // Resources -----------------------------------------------------------
 
   // Returns a blob of data corresponding to the named resource.
   virtual WebData loadResource(const char* name) { return WebData(); }
 
-  // Decodes the in-memory audio file data and returns the linear PCM audio data in the destinationBus.
-  // A sample-rate conversion to sampleRate will occur if the file data is at a different sample-rate.
+  // Decodes the in-memory audio file data and returns the linear PCM audio data
+  // in the destinationBus.  A sample-rate conversion to sampleRate will occur
+  // if the file data is at a different sample-rate.
   // Returns true on success.
   virtual bool loadAudioResource(WebAudioBus* destinationBus,
                                  const char* audioFileData,
                                  size_t dataSize) {
     return false;
   }
 
   // Scrollbar ----------------------------------------------------------
 
   // Must return non-null.
   virtual WebScrollbarBehavior* scrollbarBehavior() { return nullptr; }
 
   // Sudden Termination --------------------------------------------------
 
   // Disable/Enable sudden termination on a process level. When possible, it
   // is preferable to disable sudden termination on a per-frame level via
   // WebFrameClient::suddenTerminationDisablerChanged.
   virtual void suddenTerminationChanged(bool enabled) {}
 
   // System --------------------------------------------------------------
 
   // Returns a value such as "en-US".
   virtual WebString defaultLocale() { return WebString(); }
 
-  // Returns an interface to the main thread. Can be null if blink was initialized on a thread without a message loop.
+  // Returns an interface to the main thread. Can be null if blink was
+  // initialized on a thread without a message loop.
   WebThread* mainThread() const;
 
   // Returns an interface to the compositor thread. This can be null if the
   // renderer was created with threaded rendering desabled.
   virtual WebThread* compositorThread() const { return 0; }
 
   // Testing -------------------------------------------------------------
 
-  // Gets a pointer to URLLoaderMockFactory for testing. Will not be available in production builds.
+  // Gets a pointer to URLLoaderMockFactory for testing. Will not be available
+  // in production builds.
   virtual WebURLLoaderMockFactory* getURLLoaderMockFactory() { return nullptr; }
 
-  // Record to a RAPPOR privacy-preserving metric, see: https://www.chromium.org/developers/design-documents/rappor.
-  // recordRappor records a sample string, while recordRapporURL records the eTLD+1 of a url.
+  // Record to a RAPPOR privacy-preserving metric, see:
+  // https://www.chromium.org/developers/design-documents/rappor.
+  // recordRappor records a sample string, while recordRapporURL records the
+  // eTLD+1 of a url.
   virtual void recordRappor(const char* metric, const WebString& sample) {}
   virtual void recordRapporURL(const char* metric, const blink::WebURL& url) {}
 
   // Record a UMA sequence action.  The UserMetricsAction construction must
   // be on a single line for extract_actions.py to find it.  Please see
   // that script for more details.  Intended use is:
   // recordAction(UserMetricsAction("MyAction"))
   virtual void recordAction(const UserMetricsAction&) {}
 
   typedef uint64_t WebMemoryAllocatorDumpGuid;
@@ skipping 60 matching lines @@
   virtual WebGestureCurve* createFlingAnimationCurve(
       WebGestureDevice deviceSource,
       const WebFloatPoint& velocity,
       const WebSize& cumulativeScroll) {
     return nullptr;
   }
 
   // WebRTC ----------------------------------------------------------
 
   // Creates a WebRTCPeerConnectionHandler for RTCPeerConnection.
-  // May return null if WebRTC functionality is not avaliable or if it's out of resources.
+  // May return null if WebRTC functionality is not avaliable or if it's out of
+  // resources.
   virtual WebRTCPeerConnectionHandler* createRTCPeerConnectionHandler(
       WebRTCPeerConnectionHandlerClient*) {
     return nullptr;
   }
 
   // Creates a WebMediaRecorderHandler to record MediaStreams.
   // May return null if the functionality is not available or out of resources.
   virtual WebMediaRecorderHandler* createMediaRecorderHandler() {
     return nullptr;
   }
 
-  // May return null if WebRTC functionality is not available or out of resources.
+  // May return null if WebRTC functionality is not available or out of
+  // resources.
   virtual WebRTCCertificateGenerator* createRTCCertificateGenerator() {
     return nullptr;
   }
 
-  // May return null if WebRTC functionality is not available or out of resources.
+  // May return null if WebRTC functionality is not available or out of
+  // resources.
   virtual WebMediaStreamCenter* createMediaStreamCenter(
       WebMediaStreamCenterClient*) {
     return nullptr;
   }
 
   // Creates a WebCanvasCaptureHandler to capture Canvas output.
   virtual WebCanvasCaptureHandler*
   createCanvasCaptureHandler(const WebSize&, double, WebMediaStreamTrack*) {
     return nullptr;
   }
@@ skipping 35 matching lines @@
   // type and notify the given listener (if not null) when there is an update.
   virtual void startListening(WebPlatformEventType type,
                               WebPlatformEventListener* listener) {}
 
   // Request the platform to stop listening to the specified event and no
   // longer notify the listener, if any.
   virtual void stopListening(WebPlatformEventType type) {}
 
   // This method converts from the supplied DOM code enum to the
   // embedder's DOM code value for the key pressed. |domCode| values are
-  // based on the value defined in ui/events/keycodes/dom4/keycode_converter_data.h.
+  // based on the value defined in
+  // ui/events/keycodes/dom4/keycode_converter_data.h.
   // Returns null string, if DOM code value is not found.
   virtual WebString domCodeStringFromEnum(int domCode) { return WebString(); }
 
   // This method converts from the suppled DOM code value to the
   // embedder's DOM code enum for the key pressed. |codeString| is defined in
   // ui/events/keycodes/dom4/keycode_converter_data.h.
   // Returns 0, if DOM code enum is not found.
   virtual int domEnumFromCodeString(const WebString& codeString) { return 0; }
 
   // This method converts from the supplied DOM |key| enum to the
-  // corresponding DOM |key| string value for the key pressed. |domKey| values are
-  // based on the value defined in ui/events/keycodes/dom3/dom_key_data.h.
+  // corresponding DOM |key| string value for the key pressed. |domKey| values
+  // are based on the value defined in ui/events/keycodes/dom3/dom_key_data.h.
   // Returns empty string, if DOM key value is not found.
   virtual WebString domKeyStringFromEnum(int domKey) { return WebString(); }
 
   // This method converts from the suppled DOM |key| value to the
   // embedder's DOM |key| enum for the key pressed. |keyString| is defined in
   // ui/events/keycodes/dom3/dom_key_data.h.
   // Returns 0 if DOM key enum is not found.
   virtual int domKeyEnumFromString(const WebString& keyString) { return 0; }
 
   // Quota -----------------------------------------------------------
@@ skipping 12 matching lines @@
   virtual WebDatabaseObserver* databaseObserver() { return nullptr; }
 
   // Web Notifications --------------------------------------------------
 
   virtual WebNotificationManager* notificationManager() { return nullptr; }
 
   // Push API------------------------------------------------------------
 
   virtual WebPushProvider* pushProvider() { return nullptr; }
 
-  // Background Sync API------------------------------------------------------------
+  // Background Sync API-------------------------------------------------
 
   virtual WebSyncProvider* backgroundSyncProvider() { return nullptr; }
 
   // Experimental Framework ----------------------------------------------
 
   virtual WebTrialTokenValidator* trialTokenValidator() { return nullptr; }
 
  protected:
   Platform();
   virtual ~Platform() {}
 
   WebThread* m_mainThread;
 };
 
 }  // namespace blink
 
 #endif