Mac OS X Porting - Keyboard Shortcuts

Contributors

• Ismael Merzaq: Ismael
• Mox Soini: Mox
• Eric Bachard: ericb

Introduction

For most of the keyboard shortcuts in OpenOffice.org, the Mac OS X port will follow the other OpenOffice.org platforms, to maintain consistency and allow people to use several platforms without much re-learning.

However, there are some special cases that require Mac OS X port to make exceptions in shortcuts, compared to the other platforms:

• Mac OS X System has global keyboard shortcuts that override existing OpenOffice.org shortcuts
• Apple Human Interface Guidelines (AHIG) requires that all Mac OS X applications define certain common set of shortcuts. That common set might cause a change for shortcut to have different functionality.

  Example:
  
  When the user press F9 in OpenOffice.org (native version or X11 version), the fields are not refreshed, 
  because the Mac OS X function Exposé is launched and catches the key accelerator (to refresh the fields, go to
  Tools>Refresh>Fields in the menu.
  
  What we have to do is to change the conflicting key accelerators for OpenOffice.org.

Mac OS X Shortcuts (under construction)

Introduction

This new section marked with under construction will contain as many as possible shortcuts available on Mac OS X. All these shortcuts are Apple HIG compliant and we should check them in OO.o and fix them if they do not work as expected.

Sections

Please, split shortcuts to smaller sections to make it easily editable. It's a pain to edit one long table. Thanks.

How to edit

Copy complete specification of shortcuts from Apple HIG to this wiki page and add red comments if something's wrong. If we use this way, we can have idea how it should work, how it works and what to fix.

Common shortcuts

This section contains common shortcuts for all OpenOffice.org applications.

Moving the insertion point with the arrow keys

Moving the insertion point
Status	Key	Moves insertion point
OK	Right Arrow	One character to the right
OK	Left Arrow	One character to the left
OK	Up Arrow	To the line above, to the nearest character boundary at the same horizontal location
OK	Down Arrow	To the line below, to the nearest character boundary at the same horizontal location
EE	Option–Right Arrow	To the end of current word, then to the end of the next word It moves to the beginning of next word, then to the beginning of the next word
OK	Option–Left Arrow	To the beginning of the current word, then to the beginning of the previous word
OK	Option–Up Arrow	To the beginning of the current paragraph, then to the beginning of the previous paragraph
EE	Option–Down Arrow	To the end of the current paragraph, then to the end of the next paragraph (not to the blank line after the paragraph, if there is one) Blank line is not skipped
EE	Command–Right Arrow	To the next semantic unit, typically the end of the current line, then the end of the next line Doesn't work for next lines. It jumps to the end of the current line, but not to the ends of next lines.
EE	Command–Left Arrow	To the previous semantic unit, typically the beginning of the current line, then the previous unit Doesn't work for previous lines. It jumps to the beginning of the current line, but not to the beginnings of previous lines.
OK	Command–Up Arrow	Upward in the next semantic unit, typically the beginning of the document
OK	Command–Down Arrow	Downward in the next semantic unit, typically the end of the document

Exception: For non-Roman script systems, Command–Left Arrow and Command–Right Arrow are reserved for changing the direction of keyboard input.

Application specific shortcuts

TODO - Application specific shortcuts only.

Shortcuts intercepted by Mac OS X

TODO - List of shortcuts they are intercepted by Mac OS X (F9 Expose) and they don't work in OO.o.

Mac OS X Shortcuts

The following table describes the differences in keyboard shortcuts and the reasons for the changes. For detailed information, see: Apple Human Interface Guidelines, AHIG for key accelerators and menus and for menu examples

OpenOffice.org Mac OS X shortcuts

Generic OpenOffice.org
Functionality	Ideal OpenOffice.org	OpenOffice.org Aqua	Reason
Main command key	Command (CMD) the "Apple" key	Command (CMD) the "Apple" key (implementation in progress)	In Mac OS X, the Command -modifier is the logical equivalent of Control modifier in Windows and Linux
Function keys	F1 - F12	-	Function keys in Mac OS X have system-wide functionality (like F9 for Exposé)
Spotlight search	CMD-Space	-	This shortcut is used system-wide in Mac OS X
Apple reserved	CMD-Shift-Space	-	This shortcut is used system-wide in Mac OS X (see Apple shortcut documentation)
Preferences... access to settings	CMD-, i.e. comma	CMD-, same shortcut	AHIG, system-wide standard. Mac OS X: Preferences... in (System-wide) Application menu, i.e. the "Apple-menu" OOo: Tools > Options
Help	CMD-? i.e. question mark	F1	AHIG, system-wide standard
Undo	CMD-Z	CMD-Z	AHIG, system-wide standard
Redo	CMD-SHIFT-Z	CMD-Y	AHIG, system-wide standard
Spellcheck	CMD-; i.e. semicolon	F7	AHIG, system-wide standard. Mac OS X: Edit > Spellcheck
Non-breaking space	Option-Space	CTRL-Space	conflicts with Mac OS X System. See also Wikipedia:Non-breaking space
Close	CMD-W Close in File -menu	CTRL-F4 and CTRL-W	AHIG, system-wide standard. OOo: window > Close window with the key accelerator and File > Close without key accelerator.
Minimize minimize window	CMD-M Minimize in Window -menu	??	AHIG, system-wide standard.
Hide hide window	CMD-H Hides the Window	CMD-H Hides the Window	AHIG, system-wide standard.
Copy copy	CMD-C Copy	CMD-C Copy	AHIG, system-wide standard.
Paste paste	CMD-V paste	CMD-V paste	AHIG, system-wide standard.
Paste and Match style	CMD-SHIFT-OPTION-V Paste and Match style in Edit -menu	- Paste Special -> Unformatted text in Edit -menu	There is no direct command in OOo. CTRL-SHIFT-V activates the paste special dialog. However, the "Paste and Match style" should have shortcut as the text is more intuitive and is very handy when copy-pasting between different documents.
Open open'	CMD-O Open	CMD-O Open	AHIG, system-wide standard.
Print print	CMD-P print	CMD-P print	AHIG, system-wide standard.
Save	CMD-S save	CMD-S save	AHIG, system-wide standard.
Save As	CMD-SHIFT-S	-	AHIG, system-wide standard.
Left-align	CMD-{ i.e. left bracket	CTRL-l	AHIG, system-wide standard
Right-align	CMD-} i.e. right bracket	CTRL-r	AHIG, system-wide standard
Align to center	CMD-| i.e. pipe	CTRL-e	AHIG, system-wide standard
Decrease size of the selected item	CMD--	??	AHIG, system-wide standard. Apple Pages: Format > Font > Smaller Equivalent of the Smaller command in OpenOffice.org
Increase size of the selected item	CMD-+	??	AHIG, system-wide standard. Apple Pages: Format > Font > Bigger Equivalent of the ?? command in OpenOffice.org
Conditional hyphen	??	CTRL--	conflicts with AHIG
OpenOffice.org Writer
Functionality	OpenOffice.org Mac OS X	OpenOffice.org	Reason
Refresh fields	??	F9	Conflicts with Mac OS X system. OOo: Tools > Refresh > Fields
Style dialog	CMD-SHIFT-T	F11	Conflicts with Mac OS X system. Apple Pages: View > Show Styles Drawer
Default format in Format -menu	-	CTRL-SHIFT-Space	Conflicts with Apple reserved shortcut, see Apple shortcut documentation Apple Pages: Format > Reapply Defaults to Selection OOo: Format > Default format
OpenOffice.org Calc
Functionality	OpenOffice.org Mac OS X	OpenOffice.org	Reason
Recalculate the cell content	??	F9	Conflicts with Mac OS X system. OOo: Tools > Cell content > Recalculate
Group (data)	??	F12	Conflicts with Mac OS X system. OOo: Data > Plan > Group