[Cleanup] Files.app: Misc style fixes in Javascript code.

chrome/browser/resources/file_manager/js/metadata/id3_parser.js

 // 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.
 
 importScripts('function_sequence.js');
 importScripts('function_parallel.js');
 
 function Id3Parser(parent) {
   MetadataParser.call(this, parent, 'id3', /\.(mp3)$/i);
 }
 
 Id3Parser.prototype = {__proto__: MetadataParser.prototype};
 
 /**
  * Reads synchsafe integer.
  * 'SynchSafe' term is taken from id3 documentation.
  *
- * @private
  * @param {ByteReader} reader - reader to use.
  * @param {int} length - bytes to read.
  * @return {int}  //TODO(JSDOC).
+ * @private
  */
 Id3Parser.readSynchSafe_ = function(reader, length) {
   var rv = 0;
 
   switch (length) {
     case 4:
       rv = reader.readScalar(1, false) << 21;
     case 3:
       rv |= reader.readScalar(1, false) << 14;
     case 2:
       rv |= reader.readScalar(1, false) << 7;
     case 1:
       rv |= reader.readScalar(1, false);
   }
 
   return rv;
 };
 
 /**
  * Reads 3bytes integer.
  *
- * @private
  * @param {ByteReader} reader - reader to use.
  * @return {int}  //TODO(JSDOC).
- * @return {int}
+ * @private
  */
 Id3Parser.readUInt24_ = function(reader) {
   return reader.readScalar(2, false) << 16 | reader.readScalar(1, false);
 };
 
 /**
  * Reads string from reader with specified encoding
  *
- * @private
  * @param {ByteReader} reader reader to use.
  * @param {int} encoding string encoding.
  * @param {int} size maximum string size. Actual result may be shorter.
  * @return {string}  // TODO(JSDOC).
+ * @private
  */
 Id3Parser.prototype.readString_ = function(reader, encoding, size) {
   switch (encoding) {
     case Id3Parser.v2.ENCODING.ISO_8859_1:
       return reader.readNullTerminatedString(size);
 
     case Id3Parser.v2.ENCODING.UTF_16:
       return reader.readNullTerminatedStringUTF16(true, size);
 
     case Id3Parser.v2.ENCODING.UTF_16BE:
       return reader.readNullTerminatedStringUTF16(false, size);
 
     case Id3Parser.v2.ENCODING.UTF_8:
       // TODO: implement UTF_8.
       this.log('UTF8 encoding not supported, used ISO_8859_1 instead');
       return reader.readNullTerminatedString(size);
 
     default: {
       this.log('Unsupported encoding in ID3 tag: ' + encoding);
       return '';
     }
   }
 };
 
 /**
  * Reads text frame from reader.
  *
- * @private
  * @param {ByteReader} reader reader to use.
  * @param {int} majorVersion major id3 version to use.
  * @param {Object} frame frame so store data at.
  * @param {int} end frame end position in reader.
+ * @private
  */
 Id3Parser.prototype.readTextFrame_ = function(reader,
                                               majorVersion,
                                               frame,
                                               end) {
   frame.encoding = reader.readScalar(1, false, end);
   frame.value = this.readString_(reader, frame.encoding, end - reader.tell());
 };
 
 /**
  * Reads user defined text frame from reader.
  *
- * @private
  * @param {ByteReader} reader reader to use.
  * @param {int} majorVersion major id3 version to use.
  * @param {Object} frame frame so store data at.
  * @param {int} end frame end position in reader.
+ * @private
  */
 Id3Parser.prototype.readUserDefinedTextFrame_ = function(reader,
                                                          majorVersion,
                                                          frame,
                                                          end) {
   frame.encoding = reader.readScalar(1, false, end);
 
   frame.description = this.readString_(
       reader,
       frame.encoding,
       end - reader.tell());
 
   frame.value = this.readString_(
       reader,
       frame.encoding,
       end - reader.tell());
 };
 
 /**
- * @private
  * @param {ByteReader} reader Reader to use.
  * @param {number} majorVersion Major id3 version to use.
  * @param {Object} frame Frame so store data at.
  * @param {number} end Frame end position in reader.
+ * @private
  */
 Id3Parser.prototype.readPIC_ = function(reader, majorVersion, frame, end) {
   frame.encoding = reader.readScalar(1, false, end);
   frame.format = reader.readNullTerminatedString(3, end - reader.tell());
   frame.pictureType = reader.readScalar(1, false, end);
   frame.description = this.readString_(reader,
                                        frame.encoding,
                                        end - reader.tell());
 
 
   if (frame.format == '-->') {
     frame.imageUrl = reader.readNullTerminatedString(end - reader.tell());
   } else {
     frame.imageUrl = reader.readImage(end - reader.tell());
   }
 };
 
 /**
- * @private
  * @param {ByteReader} reader Reader to use.
  * @param {number} majorVersion Major id3 version to use.
  * @param {Object} frame Frame so store data at.
  * @param {number} end Frame end position in reader.
+ * @private
  */
 Id3Parser.prototype.readAPIC_ = function(reader, majorVersion, frame, end) {
   this.vlog('Extracting picture');
   frame.encoding = reader.readScalar(1, false, end);
   frame.mime = reader.readNullTerminatedString(end - reader.tell());
   frame.pictureType = reader.readScalar(1, false, end);
   frame.description = this.readString_(
       reader,
       frame.encoding,
       end - reader.tell());
 
   if (frame.mime == '-->') {
     frame.imageUrl = reader.readNullTerminatedString(end - reader.tell());
   } else {
     frame.imageUrl = reader.readImage(end - reader.tell());
   }
 };
 
 /**
  * Reads string from reader with specified encoding
  *
- * @private
  * @param {ByteReader} reader  reader to use.
  * @param {number} majorVersion  //TODO(JSDOC).
  * @return {Object} frame read.
+ * @private
  */
 Id3Parser.prototype.readFrame_ = function(reader, majorVersion) {
   if (reader.eof())
     return null;
 
   var frame = {};
 
   reader.pushSeek(reader.tell(), ByteReader.SEEK_BEG);
 
   var position = reader.tell();
@@ skipping 113 matching lines @@
       'id3v2parser',
       [
         function readHead(file) {
           util.readFileBytes(file, 0, 10, this.nextStep, this.onError,
               this);
         },
 
         /**
          * Check if passed array of 10 bytes contains ID3 header.
          * @param {File} file File to check and continue reading if ID3
-         *     metadata found
+         *     metadata found.
          * @param {ByteReader} reader Reader to fill with stream bytes.
          */
         function checkId3v2(file, reader) {
           if (reader.readString(3) == 'ID3') {
             this.logger.vlog('id3v2 found');
             var id3v2 = metadata.id3v2 = {};
             id3v2.major = reader.readScalar(1, false);
             id3v2.minor = reader.readScalar(1, false);
             id3v2.flags = reader.readScalar(1, false);
             id3v2.size = Id3Parser.readSynchSafe_(reader, 4);
@@ skipping 373 matching lines @@
     TYER: 'ID3_YEAR',
     WCOP: 'ID3_COPYRIGHT',
     WOAF: 'ID3_OFFICIAL_AUDIO_FILE_WEBPAGE',
     WOAR: 'ID3_OFFICIAL_ARTIST',
     WOAS: 'ID3_OFFICIAL_AUDIO_SOURCE_WEBPAGE',
     WPUB: 'ID3_PUBLISHERS_OFFICIAL_WEBPAGE'
   }
 };
 
 MetadataDispatcher.registerParserClass(Id3Parser);