reflow comments in platform/audio

third_party/WebKit/Source/platform/audio/HRTFDatabase.h

 /*
  * Copyright (C) 2010 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  *
  * 1.  Redistributions of source code must retain the above copyright
  *     notice, this list of conditions and the following disclaimer.
  * 2.  Redistributions in binary form must reproduce the above copyright
@@ skipping 30 matching lines @@
 
 class HRTFKernel;
 
 class PLATFORM_EXPORT HRTFDatabase {
   USING_FAST_MALLOC(HRTFDatabase);
   WTF_MAKE_NONCOPYABLE(HRTFDatabase);
 
  public:
   static std::unique_ptr<HRTFDatabase> create(float sampleRate);
 
-  // getKernelsFromAzimuthElevation() returns a left and right ear kernel, and an interpolated left and right frame delay for the given azimuth and elevation.
+  // getKernelsFromAzimuthElevation() returns a left and right ear kernel, and
+  // an interpolated left and right frame delay for the given azimuth and
+  // elevation.
   // azimuthBlend must be in the range 0 -> 1.
-  // Valid values for azimuthIndex are 0 -> HRTFElevation::NumberOfTotalAzimuths - 1 (corresponding to angles of 0 -> 360).
+  // Valid values for azimuthIndex are 0 -> HRTFElevation::NumberOfTotalAzimuths
+  // - 1 (corresponding to angles of 0 -> 360).

[dcheng, 2016/10/03 01:21:04]

Nit: this expression is a bit hard to parse correctly split up like this, don't
have a good suggestion though

[Nico, 2016/10/03 02:15:24]

Done.

   // Valid values for elevationAngle are MinElevation -> MaxElevation.
   void getKernelsFromAzimuthElevation(double azimuthBlend,
                                       unsigned azimuthIndex,
                                       double elevationAngle,
                                       HRTFKernel*& kernelL,
                                       HRTFKernel*& kernelR,
                                       double& frameDelayL,
                                       double& frameDelayR);
 
   // Returns the number of different azimuth angles.
   static unsigned numberOfAzimuths() {
     return HRTFElevation::NumberOfTotalAzimuths;
   }
 
   float sampleRate() const { return m_sampleRate; }
 
   // Number of elevations loaded from resource.
   static const unsigned NumberOfRawElevations;
 
  private:
   explicit HRTFDatabase(float sampleRate);
 
   // Minimum and maximum elevation angles (inclusive) for a HRTFDatabase.
   static const int MinElevation;
   static const int MaxElevation;
   static const unsigned RawElevationAngleSpacing;
 
-  // Interpolates by this factor to get the total number of elevations from every elevation loaded from resource.
+  // Interpolates by this factor to get the total number of elevations from
+  // every elevation loaded from resource.
   static const unsigned InterpolationFactor;
 
   // Total number of elevations after interpolation.
   static const unsigned NumberOfTotalElevations;
 
   // Returns the index for the correct HRTFElevation given the elevation angle.
   static unsigned indexFromElevationAngle(double);
 
   Vector<std::unique_ptr<HRTFElevation>> m_elevations;
   float m_sampleRate;
 };
 
 }  // namespace blink
 
 #endif  // HRTFDatabase_h