With that in mind, here's my suggestion: at https://www.autohotkey.com/docs/commands/Send.htm , where I often land from Google, make it clear where Send fits into typical syntax:
1) At the top, provide a usage example:
Abstract:
Code: Select all
Hotkey::Send Keys
Code: Select all
CapsLock::Send {Ctrl}
2) Add a caution like the one in this tutorial: https://www.autohotkey.com/docs/Tutorial.htm#s3
(This warning was helpful to me in two ways! a) I had made exactly that mistake: this was my first time using RWin instead of #. b) To me, a "hotkey" refers to the entire remapping (e.g. "I have a hotkey mapping CapsLock to Ctrl"); this caution also taught me that in AHK vocabulary, a "hotkey" is the bit on the left of the ::.)Caution: This table does not apply to hotkeys. Meaning, you do not wrap Ctrl or Enter (or any other key) inside curly brackets when making a hotkey.