fix comment length

webrtc/rtc_tools/video_analysis.py

 #!/usr/bin/env python
 # Copyright (c) 2017 The WebRTC project authors. All Rights Reserved.
 #
 # Use of this source code is governed by a BSD-style license
 # that can be found in the LICENSE file in the root of the source
 # tree. An additional intellectual property rights grant can be found
 # in the file PATENTS.  All contributing project authors may
 # be found in the AUTHORS file in the root of the source tree.
 
 import glob
@@ skipping 390 matching lines @@
 
     # Need to return these so they can be used by other parts.
     cropped_recordings = {
       'cropped_test_file' : cropped_test_file,
       'cropped_ref_file' : cropped_ref_file
     }
     return cropped_recordings
 
 
 def CompareVideos(options, cropped_ref_file, cropped_test_file):
-  """Runs the compare_video.py script from src/webrtc/rtc_tools using the file path.
+  """Runs the compare_video.py script from src/webrtc/rtc_tools using the file

[mbonadei, 2017/06/30 11:58:15]

I think this violates coding standards. It should stay on one line 
and if there are too many things to explain then it should go in the
section before "Args:".

Something like:

"""Runs the compare_video.py script from src/webrtc/rtc_tools using the path.

  ...

  Args:
"""

[kjellander_webrtc, 2017/06/30 12:05:16]

Yepp, first line should fit on one line.
Anything else should be in the next paragraph. Nittypicky, yes.

+  path.
 
   Uses the path from recording_result and writes the output to a file named
   <options.app_name + '_' + CURRENT_TIME + '_result.txt> in the reference video
   recording folder taken from recording_result.
 
   Args:
     options(object): Contains all the provided command line options.
     cropped_ref_file(string): Path to cropped reference video file.
     cropped_test_file(string): Path to cropped test video file.
 
@@ skipping 79 matching lines @@
   if options.compare_videos_script:
     CompareVideos(options, recording_result['cropped_ref_file'],
                   recording_result['cropped_test_file'])
   else:
     print ('Skipping compare videos step due to compare_videos flag were not '
            'passed.')
 
 
 if __name__ == '__main__':
   sys.exit(main())