[fidldoc] Updating fidldocs
diff --git a/sdk/fidl/fuchsia.ui.brightness/README.md b/sdk/fidl/fuchsia.ui.brightness/README.md
index dae6b46..e1a986c 100644
--- a/sdk/fidl/fuchsia.ui.brightness/README.md
+++ b/sdk/fidl/fuchsia.ui.brightness/README.md
@@ -25,8 +25,7 @@
### WatchAutoBrightness {#WatchAutoBrightness}
<p>Requests the current auto-brightness mode.
-This call implements the Hanging Get protocol as detailed in
-https://fuchsia.dev/fuchsia-src/development/api/fidl.md#delay-responses-using-hanging-gets</p>
+This call implements the Hanging Get protocol.</p>
#### Request
<table>
@@ -48,7 +47,8 @@
<p>Turns auto-brightness mode off.
Used by e.g. Settings to set manual brightness using a slider
-Value is in the range 0.0 to 1.0 representing min to max.</p>
+Value is in the range 0.0 to 1.0 representing min to max and
+will be clamped if out of range.</p>
#### Request
<table>
@@ -65,10 +65,9 @@
### WatchCurrentBrightness {#WatchCurrentBrightness}
<p>Gets the current brightness in the range 0.0 to 1.0.
-This result is valid for both manual and auto-brightness modes and is typically used
-to show the current brightness on a slider.
-This call implements the Hanging Get protocol as detailed in
-https://fuchsia.dev/fuchsia-src/development/api/fidl.md#delay-responses-using-hanging-gets</p>
+This result is valid for both manual and auto-brightness modes
+and is typically used to show the current brightness on a slider.
+This call implements the Hanging Get protocol.</p>
#### Request
<table>
@@ -86,17 +85,17 @@
</td>
</tr></table>
-### SetAutoBrightnessOffset {#SetAutoBrightnessOffset}
+### SetAutoBrightnessAdjustment {#SetAutoBrightnessAdjustment}
-<p>Sets the brightness offset.
-This will change the built-in brightness curve by the factor of the offset.
-The offset is in the range of -1.0 to 1.0.</p>
+<p>Sets the brightness adjustment.
+This will change the brightness curve by the factor of the adjustment.
+The adjustment is in the range of -1.0 to 1.0.</p>
#### Request
<table>
<tr><th>Name</th><th>Type</th></tr>
<tr>
- <td><code>offset</code></td>
+ <td><code>adjustment</code></td>
<td>
<code>float32</code>
</td>
@@ -104,11 +103,10 @@
-### WatchAutoBrightnessOffset {#WatchAutoBrightnessOffset}
+### WatchAutoBrightnessAdjustment {#WatchAutoBrightnessAdjustment}
-<p>Gets the current auto brightness offset.
-This call implements the Hanging Get protocol as detailed in
-https://fuchsia.dev/fuchsia-src/development/api/fidl.md#delay-responses-using-hanging-gets</p>
+<p>Gets the current auto brightness adjustment.
+This call implements the Hanging Get protocol.</p>
#### Request
<table>
@@ -120,7 +118,7 @@
<table>
<tr><th>Name</th><th>Type</th></tr>
<tr>
- <td><code>offset</code></td>
+ <td><code>adjustment</code></td>
<td>
<code>float32</code>
</td>
@@ -129,7 +127,9 @@
### SetBrightnessTable {#SetBrightnessTable}
<p>Sets the brightness curve as a set of points.
-This will override the built-in brightness curve.</p>
+This will override the built-in brightness curve.
+The default brightness curve will be used if the table is empty.
+The connection will be closed if table errors are detected.</p>
#### Request
<table>
@@ -172,6 +172,7 @@
### CalculateColorTint {#CalculateColorTint}
+<p>Given a light sensor reading returns tint values and brightness settings.</p>
#### Request
<table>
@@ -199,11 +200,12 @@
## **STRUCTS**
### BrightnessPoint {#BrightnessPoint}
-*Defined in [fuchsia.ui.brightness/brightness.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.brightness/brightness.fidl#51)*
+*Defined in [fuchsia.ui.brightness/brightness.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.brightness/brightness.fidl#52)*
-<p>A tuple representing a point on the auto-brightness curve</p>
+<p>A tuple representing a point on the auto-brightness curve
+Ambient_lux and nits must be positive values.</p>
<table>
@@ -225,12 +227,12 @@
</table>
### BrightnessTable {#BrightnessTable}
-*Defined in [fuchsia.ui.brightness/brightness.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.brightness/brightness.fidl#58)*
+*Defined in [fuchsia.ui.brightness/brightness.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.brightness/brightness.fidl#59)*
<p>A set of points defining the auto-brightness curve.
-They should be ordered in increasing ambient_lux</p>
+The ambient_lux values must be monotonically increasing.</p>
<table>
@@ -277,6 +279,8 @@
*Defined in [fuchsia.ui.brightness/color_tint.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.brightness/color_tint.fidl#17)*
+<p>Values for a generic sensor.
+Not all entries may be given by a particular sensor.</p>
<table>
@@ -287,7 +291,9 @@
<td>
<code>float32</code>
</td>
- <td></td>
+ <td><p>Raw red, green, blue and clear values given by the sensor.
+They have no units.</p>
+</td>
</tr><tr>
<td>2</td>
<td><code>green</code></td>
@@ -315,14 +321,18 @@
<td>
<code><a class='link' href='#kelvin'>kelvin</a></code>
</td>
- <td></td>
+ <td><p>The color temperature is measured in degrees Kelvin.</p>
+</td>
</tr><tr>
<td>6</td>
<td><code>lux</code></td>
<td>
<code>float32</code>
</td>
- <td></td>
+ <td><p>The lux is the measured brightness that the sensor is seeing.
+This will be a calibrated value for each type of sensor and
+each device it is built into.</p>
+</td>
</tr></table>
### TargetColorTint {#TargetColorTint}
@@ -330,6 +340,10 @@
*Defined in [fuchsia.ui.brightness/color_tint.fidl](https://fuchsia.googlesource.com/fuchsia/+/master/sdk/fidl/fuchsia.ui.brightness/color_tint.fidl#36)*
+<p>Values for adjusting screen colors based on the raw sensor information.
+Not all entries may be populated by a particular algorithm.
+Either the RGB values or the color temperature may be used
+they are interchangeable.</p>
<table>
@@ -340,7 +354,9 @@
<td>
<code>float32</code>
</td>
- <td></td>
+ <td><p>Red, green and blue are numbers between 0.0 to 1.0 inclusive, they give
+the tint.</p>
+</td>
</tr><tr>
<td>2</td>
<td><code>green</code></td>
@@ -361,28 +377,32 @@
<td>
<code>float32</code>
</td>
- <td></td>
+ <td><p>The derived brightness from the R, G, B and clear sensor readings.</p>
+</td>
</tr><tr>
<td>5</td>
<td><code>color_temperature</code></td>
<td>
<code><a class='link' href='#kelvin'>kelvin</a></code>
</td>
- <td></td>
+ <td><p>The derived color temperature matching the red, green and blue values.</p>
+</td>
</tr><tr>
<td>6</td>
<td><code>brightness_with_color_match</code></td>
<td>
<code>float32</code>
</td>
- <td></td>
+ <td><p>Brightness in range 0.0 - 1.0 inclusive if color tinting is used.</p>
+</td>
</tr><tr>
<td>7</td>
<td><code>brightness_without_color_match</code></td>
<td>
<code>float32</code>
</td>
- <td></td>
+ <td><p>Brightness in range 0.0 - 1.0 inclusive if color tinting is not used.</p>
+</td>
</tr></table>
