Files.app: Add missing JSdoc for member methods/variables #2.

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);
 }
@@ skipping 106 matching lines @@
       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.
  */
 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.
  */
 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());
@@ skipping 64 matching lines @@
         reader.tell() + frame.size);
   }
 
   reader.popSeek();
 
   reader.seek(frame.size + frame.headerSize, ByteReader.SEEK_CUR);
 
   return frame;
 };
 
+/**
+ * @param {File} file  //TODO(JSDOC).
+ * @param {Object} metadata  //TODO(JSDOC).
+ * @param {function(Object)} callback  //TODO(JSDOC).
+ * @param {function(etring)} onError  //TODO(JSDOC).
+ */
 Id3Parser.prototype.parse = function(file, metadata, callback, onError) {
   var self = this;
 
   this.log('Starting id3 parser for ' + file.name);
 
   var id3v1Parser = new FunctionSequence(
       'id3v1parser',
       [
         /**
          * Reads last 128 bytes of file in bytebuffer,
@@ skipping 440 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);