macOS keyboard shortcut documentation note

[johnblommers]

With one exception noted below, of the documented keyboard shortcuts that use the Ctrl key, Macintosh users should replace Ctrl with Command.

Exception: Commandh does not open the search and display bar because it is intercepted by the system to hide the foremost app, so pressing these two keys hides novelWriter.

[vkbo]

Not a mac user, so don't know. Are you saying that macOS replaces they key shortcut? So, it's only a matter of making the note in the manual?

[johnblommers]

Yes just make a note in the manual. macOS users will get it.

macOS has always used the Command key ⌘ instead of the Ctrl key for common keyboard shortcuts. So ⌘ c is copy, ⌘ v is paste and ⌘ x is cut.

⌘ h hides the current app.

On macOS, when you view a menu, its shortcut is typically displayed next to it. For novelWriter all of the keyboard shortcuts display with a ⌘ symbol instead of a Ctrl symbol.

[vkbo]

Yeah, that makes sense as I use the Qt intrinsic settings for keyboard shortcuts, so it probably does the translation for the app. What is the common keyboard shortcut for replace on a mac then?

I do have a logical flag for Windows, Linux and Darwin, so I can easily wrap the assignment of a keyboard shortcut in an if statement for this one.

[johnblommers]

The short answer is that the replace key on macOS should be ⌘=

TL;DR

What is the common keyboard shortcut for replace on macOS? This question actually required me to take a look because it's not a common paradigm in my bubble.

TextEdit is probably typical. Here are the edit keyboard shortcuts it offers:
⌘F Find ...
⌥⌘F Find and Replace...
⌘G Find Next
⇧⌘G Find Previous

novelWriter's edit menu keyboard shortcuts on macOS are:
⌘F Find
none for Replace
F3 Find Next
⇧F3 Find Previous
⇧⌘1 Replace Next

Of course macOS has special names for some of these keys:
⌘ Command
⇧ Shift
⌥ Option, the same physical key as Alt

Saving the best for last, the famous BBEdit programmer's editor is probably our best example. Rather than develop blindness and carpel tunnel syndrome let me post a screenshot of the BBEdit edit menu:

[vkbo]

Thanks for the feedback. I'll add the shortcut for find next and find previous under an if darwin statement. As for the replace and find next, I don't think there's a standard anywhere. I used the key combination from VSCode.

Checking with my office mate, the command = shortcut in all applications we tested changed font size, so not sure that is the correct one.

[vkbo]

@johnblommers, I think this issue can be closed now?

[vkbo]

Since a few changes have been made here, and I'm not aware of any further issues, I'm closing this.