@@ 1,5 1,12 @@ // SPDX-License-Identifier: Unlicense OR MIT
  
+ /*
+ Package key implements key and text input handling.
+ 
+ The HandlerOp operations is used for declaring key
+ input handlers. Use the Queue interface from package
+ input to receive events.
+ */
  package key
  
  import (


@@ 8,13 15,21 @@ "gioui.org/ui/internal/opconst"
  )
  
+ // HandlerOp declares a handler ready for key events.
+ // Key events are in general only delivered to the
+ // focused key handler. Set the Focus flag to request
+ // the focus.
  type HandlerOp struct {
  	Key   input.Key
  	Focus bool
  }
  
+ // HideInputOp request that any on screen text input
+ // be hidden.
  type HideInputOp struct{}
  
+ // FocusEvent is sent when a handler gains or looses
+ // focus.
  type FocusEvent struct {
  	Focus bool
  }