[fidldoc] Updating fidl reference docs
diff --git a/sdk/fidl/fuchsia.ui.pointerinjector/README.md b/sdk/fidl/fuchsia.ui.pointerinjector/README.md
index fa534e8..942fd52 100644
--- a/sdk/fidl/fuchsia.ui.pointerinjector/README.md
+++ b/sdk/fidl/fuchsia.ui.pointerinjector/README.md
@@ -128,7 +128,7 @@
### DeviceType {#DeviceType}
Type: <code>uint32</code>
-*Defined in [fuchsia.ui.pointerinjector/config.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#57)*
+*Defined in [fuchsia.ui.pointerinjector/config.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#67)*
<p>A characterization of a device that issues pointer event streams.</p>
@@ -139,12 +139,17 @@
<td><code>1</code></td>
<td><p>A device intended for manipulation by direct contact over its surface.</p>
</td>
+ </tr><tr id="DeviceType.MOUSE">
+ <td><code>MOUSE</code></td>
+ <td><code>2</code></td>
+ <td><p>A device intended for manipulation by precise movement over a surface.</p>
+</td>
</tr></table>
### DispatchPolicy {#DispatchPolicy}
Type: <code>uint32</code>
-*Defined in [fuchsia.ui.pointerinjector/config.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#149)*
+*Defined in [fuchsia.ui.pointerinjector/config.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#162)*
<p>A specification of the UI clients that may have injected events dispatched
to them in an |Target|. One is specified in |Config|.</p>
@@ -202,12 +207,24 @@
Note: Each client will have its own copy of the viewport, placed
accordingly in its own coordinate system.</p>
</td>
+ </tr><tr id="DispatchPolicy.MOUSE_HOVER_AND_LATCH_IN_TARGET">
+ <td><code>MOUSE_HOVER_AND_LATCH_IN_TARGET</code></td>
+ <td><code>3</code></td>
+ <td><p>Clients in the |Target|'s view tree receive hover events when a cursor
+is positioned over it, unless the mouse is latched to a specific client.
+A mouse initiates a latch via button down, and until the release of that
+latch, mouse events are delivered to that latched client; other clients
+do not receive hover events in the latch duration.</p>
+<p>Note: It's possible for no client to latch, if the hit test fails to
+hit any surface in any sub-view of |Target|.
+Note: Each client will have its own copy of the viewport, placed</p>
+</td>
</tr></table>
### EventPhase {#EventPhase}
Type: <code>uint32</code>
-*Defined in [fuchsia.ui.pointerinjector/event.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/event.fidl#13)*
+*Defined in [fuchsia.ui.pointerinjector/event.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/event.fidl#14)*
<p>The possible states of a pointer event stream's state machine.</p>
<p>A typical pointer will move through this state machine:
@@ -244,7 +261,7 @@
### Config {#Config}
-*Defined in [fuchsia.ui.pointerinjector/config.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#24)*
+*Defined in [fuchsia.ui.pointerinjector/config.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#25)*
<p>A specification for an injector |Device|.</p>
<p>All fields required.</p>
@@ -309,12 +326,36 @@
have injected events dispatched to it, regardless of other factors, such
as surface occlusion by clients inside and outside of |target|.</p>
</td>
+ </tr><tr id="Config.scroll_v_range">
+ <td>7</td>
+ <td><code>scroll_v_range</code></td>
+ <td>
+ <code><a class='link' href='../fuchsia.input.report/'>fuchsia.input.report</a>/<a class='link' href='../fuchsia.input.report/#Axis'>Axis</a></code>
+ </td>
+ <td><p>Range of vertical scroll values issued by the device.</p>
+</td>
+ </tr><tr id="Config.scroll_h_range">
+ <td>8</td>
+ <td><code>scroll_h_range</code></td>
+ <td>
+ <code><a class='link' href='../fuchsia.input.report/'>fuchsia.input.report</a>/<a class='link' href='../fuchsia.input.report/#Axis'>Axis</a></code>
+ </td>
+ <td><p>Range of horizontal scroll values issued by the device.</p>
+</td>
+ </tr><tr id="Config.buttons">
+ <td>9</td>
+ <td><code>buttons</code></td>
+ <td>
+ <code>vector<uint8>[32]</code>
+ </td>
+ <td><p>Mouse button identifiers issued by the device.</p>
+</td>
</tr></table>
### Event {#Event}
-*Defined in [fuchsia.ui.pointerinjector/event.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/event.fidl#55)*
+*Defined in [fuchsia.ui.pointerinjector/event.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/event.fidl#64)*
@@ -354,8 +395,7 @@
*Defined in [fuchsia.ui.pointerinjector/event.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/event.fidl#29)*
-<p>A description of each sampled data point for a pointer device.
-All fields are required.</p>
+<p>A description of each sampled data point for a pointer device.</p>
<table>
@@ -385,12 +425,36 @@
</td>
<td><p>The position of this event, in the viewport's coordinate system.</p>
</td>
+ </tr><tr id="PointerSample.scroll_v">
+ <td>4</td>
+ <td><code>scroll_v</code></td>
+ <td>
+ <code>int64</code>
+ </td>
+ <td><p>Relative vertical scrolling displacement.</p>
+</td>
+ </tr><tr id="PointerSample.scroll_h">
+ <td>5</td>
+ <td><code>scroll_h</code></td>
+ <td>
+ <code>int64</code>
+ </td>
+ <td><p>Relative horizontal scrolling displacement.</p>
+</td>
+ </tr><tr id="PointerSample.pressed_buttons">
+ <td>6</td>
+ <td><code>pressed_buttons</code></td>
+ <td>
+ <code>vector<uint8>[32]</code>
+ </td>
+ <td><p>Identifiers of currently pressed buttons.</p>
+</td>
</tr></table>
### Viewport {#Viewport}
-*Defined in [fuchsia.ui.pointerinjector/config.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#115)*
+*Defined in [fuchsia.ui.pointerinjector/config.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#128)*
<p>A rectangular region that directs injected events into a target.</p>
<p>The viewport relates a pointer's position across multiple independent
@@ -402,7 +466,7 @@
viewport coordinate system. Together, they define the viewport's placement
in the context coordinate system.</p>
<p>The viewport coordinate system is used to convey a pointer's coordinates in
-a scale-invariant way to dispatch clients, so that gestures can be
+a scale-invariant way to dispatch clients, so that pointer movement can be
interpreted correctly under effects like magnification. The context defines
the viewport's minimal and maximal extents in the viewport coordinate
system.</p>
@@ -454,7 +518,7 @@
## **UNIONS**
### Context {#Context}
-*Defined in [fuchsia.ui.pointerinjector/config.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#69)*
+*Defined in [fuchsia.ui.pointerinjector/config.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#82)*
<p>The region from which injection is attempted for injected events. As the
context, it serves two purposes:
@@ -479,7 +543,7 @@
</tr></table>
### Data {#Data}
-*Defined in [fuchsia.ui.pointerinjector/event.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/event.fidl#43)*
+*Defined in [fuchsia.ui.pointerinjector/event.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/event.fidl#52)*
<p>A selection of FIFO data sent over the channel.
Each data may have a different issuance policy.</p>
@@ -509,7 +573,7 @@
</tr></table>
### Target {#Target}
-*Defined in [fuchsia.ui.pointerinjector/config.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#78)*
+*Defined in [fuchsia.ui.pointerinjector/config.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#91)*
<p>The region in which dispatch is attempted for injected events.
The particular dispatch policy is specified in |Config|.</p>
@@ -552,7 +616,7 @@
<table>
<tr><th>Name</th><th>Value</th><th>Description</th></tr><tr id="Extents">
- <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#15">Extents</a></td>
+ <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#16">Extents</a></td>
<td>
<code>array</code>[<code>2</code>]</td>
<td><p>A floating-point pair of points, representing minimal and maximal extents.</p>
@@ -561,7 +625,7 @@
</ul>
</td>
</tr><tr id="Mat3">
- <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#19">Mat3</a></td>
+ <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#20">Mat3</a></td>
<td>
<code>array</code>[<code>9</code>]</td>
<td><p>A floating-point 3x3 matrix.</p>
@@ -570,7 +634,7 @@
</ul>
</td>
</tr><tr id="Point2">
- <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#11">Point2</a></td>
+ <td><a href="https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.pointerinjector/config.fidl#12">Point2</a></td>
<td>
<code>array</code>[<code>2</code>]</td>
<td><p>A floating-point two-dimensional point.</p>
