Add, expand, fix jsdocs, comments

JitsiConferenceEvents.js

@@ -4,11 +4,17 @@
  */
 var JitsiConferenceEvents = {
     /**
-     * A new media track was added to the conference.
+     * A new media track was added to the conference. The event provides the
+     * following parameters to its listeners:
+     *
+     * @param {JitsiTrack} track the added JitsiTrack
      */
     TRACK_ADDED: "conference.trackAdded",
     /**
-     * The media track was removed from the conference.
+     * The media track was removed from the conference. The event provides the
+     * following parameters to its listeners:
+     *
+     * @param {JitsiTrack} track the removed JitsiTrack
      */
     TRACK_REMOVED: "conference.trackRemoved",
     /**

modules/RTC/JitsiLocalTrack.js

@@ -296,7 +296,8 @@ JitsiLocalTrack.prototype.getSSRC = function () {
 };
 
 /**
- * Return true;
+ * Returns <tt>true</tt>.
+ * @returns {boolean} <tt>true</tt>
  */
 JitsiLocalTrack.prototype.isLocal = function () {
     return true;

modules/RTC/JitsiRemoteTrack.js

@@ -67,7 +67,8 @@ JitsiRemoteTrack.prototype.isLocal = function () {
 };
 
 /**
- * Return false;
+ * Returns the synchronization source identifier (SSRC) of this remote track.
+ * @returns {string} the SSRC of this remote track
  */
 JitsiRemoteTrack.prototype.getSSRC = function () {
     return this.ssrc;

modules/RTC/RTCUtils.js

@@ -637,7 +637,7 @@ var RTCUtils = {
                     return element;
                 });
                 this.getStreamID = function (stream) {
-                    // streams from FF endpoints have the characters '{' and '}'
+                    // Streams from FF endpoints have the characters '{' and '}'
                     // that make jQuery choke.
                     return SDPUtil.filter_special_chars(stream.id);
                 };