@@ 1,7 1,33 @@
 // SPDX-License-Identifier: Unlicense OR MIT
 
-// Package input exposes a unified interface to input sources. Subpackages
-// such as pointer and key provide the interfaces for specific input types.
+/*
+Package input exposes a unified interface for receiving input
+events.
+
+For example:
+
+	var queue input.Queue = ...
+
+	for e, ok := queue.Next(h); ok; e, ok = queue.Next(h) {
+		switch e.(type) {
+			...
+		}
+	}
+
+In general, handlers must be declared before events become
+available. Other packages such as pointer and key provide
+the means for declaring handlers for specific input types.
+
+The following example marks a handler ready for key input:
+
+	import gioui.org/ui/input
+	import gioui.org/ui/key
+
+	var ops ui.Ops
+	var h *Handler = ...
+	key.HandlerOp{Key: h}.Add(ops)
+
+*/
 package input
 
 // Queue maps an event handler key to the events