A little more work on docs.

doc/2-interface/components.md

@@ -21,8 +21,7 @@ the following keyboard shortcuts work while on a text field:
 
 these work similar to text fields, but you may only input numbers.
 
-they also usually have `+` and `-` buttons which allow you to increase/decrease the value when clicked (and rapidly do so when holding).
-additionally, Ctrl-clicking these buttons may increase/decrease the value by a coarse amount.
+they often have `+` and `-` buttons which allow you to increase/decrease the value when clicked (and rapidly do so when holding). additionally, Ctrl-clicking these buttons may increase/decrease the value by a coarse amount.
 
 ## sliders
 
@@ -33,6 +32,18 @@ using the scroll wheel while holding Ctrl will change the slider's value by smal
 right-clicking or Ctrl-clicking on a slider (Command-click on macOS) will turn it into a number input field, allowing you to input precise values.
 once you click away it will become a slider again.
 
+## color selectors
+
+this will appear as a small colored square (swatch) anywhere a color may be selected. they may also have numeric entry to the left.
+
+left-click the swatch to pop up a large color panel.
+- click directly within the large square to select saturation and value, and to the rainbow bar on its right to select hue.
+- further to the right there may be "Current" and "Original" swatches. click the "Original" swatch to revert to that color.
+- below that are numeric entry boxes for RGBA (red, green, blue, alpha/opacity) and HSVA (hue, saturation, value, alpha/opacity) formats. click and drag on a number to raise or lower it. double-click to edit it as text. right-click to choose whether numbers are entered as integers between 0 and 255 or decimals between 0.0 and 1.0.
+- below that is a directly editable web-style hexadecimal RGBA color value in a standard text box.
+
+right-click the swatch or its numeric entry boxes to select the color format and numbers in use.
+
 ## windows
 
 ![window](window.png)