diff --git a/source/clog-base.lisp b/source/clog-base.lisp
index ce98f66..c469bc4 100644
--- a/source/clog-base.lisp
+++ b/source/clog-base.lisp
@@ -1053,8 +1053,8 @@ ON-TOUCH-CANCEL-HANDLER is nil unbind the event."))
 
 (defgeneric set-on-character (clog-obj on-character-handler &key one-time)
   (:documentation "Set the ON-CHARACTER-HANDLER for CLOG-OBJ. If
-ON-CHARACTER-HANDLER is nil unbind the event. Setting this event
-will replace a on-key-down"))
+ON-CHARACTER-HANDLER is nil unbind the event. Setting this event to
+nil will unbind on-key-press also."))
 
 (defmethod set-on-character ((obj clog-obj) handler &key (one-time nil))
   (set-event obj "keypress"
diff --git a/source/clog-docs.lisp b/source/clog-docs.lisp
index b325a31..281f0ef 100644
--- a/source/clog-docs.lisp
+++ b/source/clog-docs.lisp
@@ -234,8 +234,9 @@ Events in clog-base
      :meta-key       t or nil if meta-key held down
 
      :event-type :keyboard
-     :key-code   A key code sometimes called a scan code for the key pressed
-     :char-code  UTF-8 representation for key pressed when possible
+     :key        String of key pressed, with out modifiers like ctrl characters
+     :key-code   The utf-16 value of :key
+     :char-code  UTF-8 representation for key pressed when possible - deprecated
      :alt-key    t or nil if alt-key held down
      :ctrl-key   t or nil if ctrl-key held down
      :shift-key  t or nil if shift-key held down