This function is the inverse of @code{keymap-set}, it unsets the
binding for @var{key} in @var{keymap}, which is the same as setting
the binding to @code{nil}. In order to instead remove the binding
-completely, specify @var{remove} as non-nil. This only makes a
-difference if @var{keymap} has a parent keymap. When unsetting a key
+completely, specify @var{remove} as non-@code{nil}. This only makes a
+difference if @var{keymap} has a parent keymap: if you just unset a key
in a child map, it will still shadow the same key in the parent
-keymap. Removing the binding will allow the key in the parent keymap
+keymap; using @var{remove} instead will allow the key in the parent keymap
to be used.
@end defun