Adds jsdoc to previous commit

interface_config.js

@@ -20,7 +20,11 @@ var interfaceConfig = {
         'recording', 'security', 'invite', 'chat', 'prezi', 'etherpad',
         'fullscreen', 'sip', 'dialpad', 'settings', 'hangup', 'filmstrip',
         'contacts'],
-    VIDEO_LAYOUT_FIT: 'both', // height, width, both
+    // Determines how the video would fit the screen. 'both' would fit the whole
+    // screen, 'height' would fit the original video height to the height of the
+    // screen, 'width' would fit the original video width to the width of the
+    // screen respecting ratio.
+    VIDEO_LAYOUT_FIT: 'both',
     /**
      * Whether to only show the filmstrip (and hide the toolbar).
      */

modules/UI/videolayout/LargeVideo.js

@@ -180,9 +180,14 @@ function getDesktopVideoPosition(videoWidth,
 
 
 /**
- * Returns an array of the video dimensions, so that it covers the screen.
- * It leaves no empty areas, but some parts of the video might not be visible.
+ * Returns an array of the video dimensions. It respects the
+ * VIDEO_LAYOUT_FIT config, to fit the video to the screen, by hiding some parts
+ * of it, or to fit it to the height or width.
  *
+ * @param videoWidth the original video width
+ * @param videoHeight the original video height
+ * @param videoSpaceWidth the width of the video space
+ * @param videoSpaceHeight the height of the video space
  * @return an array with 2 elements, the video width and the video height
  */
 function getCameraVideoSize(videoWidth,