- This function should only be used by a keymap preferences editor. - Once you have set the keymap, you should NEVER deallocate it, as other apps might have got pointers to it via AskKeyMapDefault(). - You should use the keymap.resource to check if the keymap has allready been added. If not, then remember to arbitrate before adding it to the keymap.resource list of keymaps.
BUGS
When adding the keymap to the keymap.resource one must use Forbid()/Permit() to arbitrate. Ideally one should use semaphores, but the keymap.resource contains no semaphore for this purpose.