Formatting changes

ppapi/c/pp_input_event.h

 /* Copyright (c) 2011 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.
  */
 #ifndef PPAPI_C_PP_INPUT_EVENT_H_
 #define PPAPI_C_PP_INPUT_EVENT_H_
 
 /**
  * @file
  * This file defines the API used to handle mouse and keyboard input events.
@@ skipping 220 matching lines @@
  * events.
  */
 struct PP_InputEvent_Wheel {
   /**
    * This value represents a combination of the <code>EVENT_MODIFIER</code>
    * flags.
    */
   uint32_t modifier;
 
   /**
-   * Indicates the amount vertically and horizontally the user has requested
-   * to scroll by with their mouse wheel. A scroll down or to the right (where
-   * the content moves up or left) is represented as positive values, and
-   * a scroll up or to the left (where the content moves down or right) is
-   * represented as negative values.
+   * This value indicates the amount vertically and horizontally the user has

[der Springer, 2011/08/09 20:40:40]

Horizontal only.  And this sentence is pretty awkward.  Maybe: "The mouse
wheel's horizontal scroll amount."

[jond, 2011/08/10 21:05:59]

Done.

+   * requested to scroll by with their mouse wheel. A scroll down or to the
+   * right (where the content moves up or left) is represented as positive
+   * values, and a scroll up or to the left (where the content moves down or

[der Springer, 2011/08/09 20:40:40]

Remove references to "up/down" in this section.

[jond, 2011/08/10 21:05:59]

Done.

+   * right) is represented as negative values.
    *
    * The units are either in pixels (when scroll_by_page is false) or pages
    * (when scroll_by_page is true). For example, delta_y = -3 means scroll up 3
    * pixels when scroll_by_page is false, and scroll up 3 pages when
    * scroll_by_page is true.
    *
    * This amount is system dependent and will take into account the user's
    * preferred scroll sensitivity and potentially also nonlinear acceleration
    * based on the speed of the scrolling.
    *
    * Devices will be of varying resolution. Some mice with large detents will
    * only generate integer scroll amounts. But fractional values are also
    * possible, for example, on some trackpads and newer mice that don't have
    * "clicks".
    */
   float delta_x;
 
-  /** This value represents */
+  /**
+   * This value indicates the amount vertically and horizontally the user has

[der Springer, 2011/08/09 20:40:40]

Vertical only.  Also, this sentence is awkward (see above);.

[jond, 2011/08/10 21:05:59]

Done.

+   * requested to scroll by with their mouse wheel. A scroll down or to the
+   * right (where the content moves up or left) is represented as positive

[der Springer, 2011/08/09 20:40:40]

Remove references to "left/right" in this section.

[jond, 2011/08/10 21:05:59]

Done.

+   * values, and a scroll up or to the left (where the content moves down or
+   * right) is represented as negative values.
+   *
+   * The units are either in pixels (when scroll_by_page is false) or pages
+   * (when scroll_by_page is true). For example, delta_y = -3 means scroll up 3
+   * pixels when scroll_by_page is false, and scroll up 3 pages when
+   * scroll_by_page is true.
+   *
+   * This amount is system dependent and will take into account the user's
+   * preferred scroll sensitivity and potentially also nonlinear acceleration
+   * based on the speed of the scrolling.
+   *
+   * Devices will be of varying resolution. Some mice with large detents will
+   * only generate integer scroll amounts. But fractional values are also
+   * possible, for example, on some trackpads and newer mice that don't have
+   * "clicks".
+   */
   float delta_y;
 
   /**
    * The number of "clicks" of the scroll wheel that have produced the
    * event. The value may have system-specific acceleration applied to it,
    * depending on the device. The positive and negative meanings are the same
    * as for <code>delta_x</code> and <code>delta_y</code>.
    *
    * If you are scrolling, you probably want to use the delta values above.
    * These tick events can be useful if you aren't doing actual scrolling and
@@ skipping 63 matching lines @@
      */
     char padding[64];
   } u;
 };
 PP_COMPILE_ASSERT_STRUCT_SIZE_IN_BYTES(PP_InputEvent, 80);
 /**
  * @}
  */
 
 #endif  /* PPAPI_C_PP_INPUT_EVENT_H_ */