Explain valid key events

[musicin3d]

Documentation does not explain how to define hotkeys for screen.key(...). The only hit that it gives is that you can provide a single letter (A), a name (escape), or a Ctl+key combo (C-c). But how do you respond to "shift+tab"?

I had to do some digging until I found the following...

program.js:401

var name = (key.ctrl ? 'C-' : '')
  + (key.meta ? 'M-' : '')
  + (key.shift && key.name ? 'S-' : '')
  + (key.name || ch);

Based on this, you can also listen for "M-a" or "S-tab". This might be a convention for some, but it's not universally known --especially meta (super?). Furthermore, it appears that you must order the modifiers a certain way if you want to combine them. For example, "C-S-tab" would be recognized, but what about "S-C-tab"?

In the very least, these features and expectations should probably be documented.