doc string for string-key-binding unclear

[Drew Adams]

The doc string says: "Value is the binding of KEY in a string.
If KEY is an event on a string, and that string has a `local-map'
or `keymap' property, return the binding of KEY in the string's keymap."

I don't understand what "an event on a string" means - a fish on a
string I understand, but not an event. Please clarify what this
function does.

I note, too, that the only places where this function is used always
use this idiom: (or (string-key-binding key) (key-binding key t))
where the `t' is sometimes absent. This brings to mind the question
whether `string-key-binding' should in fact be a separate function,
or should just have its functionality rolled into `key-binding'.


In GNU Emacs 22.0.50.1 (i386-msvc-nt5.1.2600)
 of 2006-07-19 on BOS-CTHEWLAP2
X server distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-msvc (12.00)'