reflow comments in core/events,core/fileapi

third_party/WebKit/Source/core/fileapi/File.h

 /*
  * Copyright (C) 2008 Apple 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:
  * 1. Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in the
@@ skipping 27 matching lines @@
 class ExceptionState;
 class ExecutionContext;
 class FilePropertyBag;
 class FileMetadata;
 class KURL;
 
 class CORE_EXPORT File final : public Blob {
   DEFINE_WRAPPERTYPEINFO();
 
  public:
-  // AllContentTypes should only be used when the full path/name are trusted; otherwise, it could
-  // allow arbitrary pages to determine what applications an user has installed.
+  // AllContentTypes should only be used when the full path/name are trusted;
+  // otherwise, it could allow arbitrary pages to determine what applications an
+  // user has installed.
   enum ContentTypeLookupPolicy {
     WellKnownContentTypes,
     AllContentTypes,
   };
 
   // The user should not be able to browse to some files, such as the ones
   // generated by the Filesystem API.
   enum UserVisibility { IsUserVisible, IsNotUserVisible };
 
   // Constructor in File.idl
@@ skipping 34 matching lines @@
       uint64_t size,
       double lastModified,
       PassRefPtr<BlobDataHandle> blobDataHandle) {
     return new File(path, name, String(), IsNotUserVisible, true, size,
                     lastModified, std::move(blobDataHandle));
   }
 
   static File* createWithRelativePath(const String& path,
                                       const String& relativePath);
 
-  // If filesystem files live in the remote filesystem, the port might pass the valid metadata (whose length field is non-negative) and cache in the File object.
+  // If filesystem files live in the remote filesystem, the port might pass the
+  // valid metadata (whose length field is non-negative) and cache in the File
+  // object.
   //
-  // Otherwise calling size(), lastModifiedTime() and slice() will synchronously query the file metadata.
+  // Otherwise calling size(), lastModifiedTime() and slice() will synchronously
+  // query the file metadata.
   static File* createForFileSystemFile(const String& name,
                                        const FileMetadata& metadata,
                                        UserVisibility userVisibility) {
     return new File(name, metadata, userVisibility);
   }
 
   static File* createForFileSystemFile(const KURL& url,
                                        const FileMetadata& metadata,
                                        UserVisibility userVisibility) {
     return new File(url, metadata, userVisibility);
   }
 
   KURL fileSystemURL() const {
     ASSERT(hasValidFileSystemURL());
     return m_fileSystemURL;
   }
 
-  // Create a file with a name exposed to the author (via File.name and associated DOM properties) that differs from the one provided in the path.
+  // Create a file with a name exposed to the author (via File.name and
+  // associated DOM properties) that differs from the one provided in the path.
   static File* createForUserProvidedFile(const String& path,
                                          const String& displayName) {
     if (displayName.isEmpty())
       return new File(path, File::AllContentTypes, File::IsUserVisible);
     return new File(path, displayName, File::AllContentTypes,
                     File::IsUserVisible);
   }
 
   static File* createForFileSystemFile(
       const String& path,
@@ skipping 27 matching lines @@
   // Getter for the lastModified IDL attribute,
   // http://dev.w3.org/2006/webapi/FileAPI/#file-attrs
   long long lastModified() const;
 
   // Getter for the lastModifiedDate IDL attribute,
   // http://www.w3.org/TR/FileAPI/#dfn-lastModifiedDate
   double lastModifiedDate() const;
 
   UserVisibility getUserVisibility() const { return m_userVisibility; }
 
-  // Returns the relative path of this file in the context of a directory selection.
+  // Returns the relative path of this file in the context of a directory
+  // selection.
   const String& webkitRelativePath() const { return m_relativePath; }
 
-  // Note that this involves synchronous file operation. Think twice before calling this function.
+  // Note that this involves synchronous file operation. Think twice before
+  // calling this function.
   void captureSnapshot(long long& snapshotSize,
                        double& snapshotModificationTimeMS) const;
 
-  // Returns true if this has a valid snapshot metadata (i.e. m_snapshotSize >= 0).
+  // Returns true if this has a valid snapshot metadata
+  // (i.e. m_snapshotSize >= 0).
   bool hasValidSnapshotMetadata() const { return m_snapshotSize >= 0; }
 
-  // Returns true if the sources (file path, file system URL, or blob handler) of the file objects are same or not.
+  // Returns true if the sources (file path, file system URL, or blob handler)
+  // of the file objects are same or not.
   bool hasSameSource(const File& other) const;
 
  private:
   File(const String& path, ContentTypeLookupPolicy, UserVisibility);
   File(const String& path,
        const String& name,
        ContentTypeLookupPolicy,
        UserVisibility);
   File(const String& path,
        const String& name,
@@ skipping 23 matching lines @@
   bool hasValidFilePath() const { return hasBackingFile() || m_path.isEmpty(); }
 #endif
 
   bool m_hasBackingFile;
   UserVisibility m_userVisibility;
   String m_path;
   String m_name;
 
   KURL m_fileSystemURL;
 
-  // If m_snapshotSize is negative (initialized to -1 by default), the snapshot metadata is invalid and we retrieve the latest metadata synchronously in size(), lastModifiedTime() and slice().
+  // If m_snapshotSize is negative (initialized to -1 by default), the snapshot
+  // metadata is invalid and we retrieve the latest metadata synchronously in
+  // size(), lastModifiedTime() and slice().
   // Otherwise, the snapshot metadata are used directly in those methods.
   long long m_snapshotSize;
   const double m_snapshotModificationTimeMS;
 
   String m_relativePath;
 };
 
 DEFINE_TYPE_CASTS(File, Blob, blob, blob->isFile(), blob.isFile());
 
 }  // namespace blink
 
 #endif  // File_h