spacemacs/contrib/osx/README.md

57 lines
1.6 KiB
Markdown
Raw Normal View History

2014-12-12 17:31:55 +00:00
# OSX contribution layer for Spacemacs
2014-12-24 06:03:49 +00:00
![applogo](img/apple.png)![osxlogo](img/osx.png)
<!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc/generate-toc again -->
**Table of Contents**
- [OSX contribution layer for Spacemacs](#osx-contribution-layer-for-spacemacs)
- [Description](#description)
- [Philosophy](#philosophy)
- [Install](#install)
- [Key Bindings](#key-bindings)
- [Future Work](#future-work)
<!-- markdown-toc end -->
2014-12-12 17:31:55 +00:00
## Description
Spacemacs is not just emacs+vim. It can have OSX keybindings too!
This layer globally defines common OSX keybindings. ⌘ is set to
`super` and ⌥ is set to `meta`. Aside from that, there's nothing
much, really.
## Philosophy
While this layer enables common OSX bindings, it does not implement
OSX navigation keybindings. Spacemacs is meant to be used with evil,
and we encourage you to do so :)
## Install
To use this configuration layer, add it to your `~/.spacemacs`
2014-12-24 04:01:49 +00:00
```elisp
2014-12-12 17:31:55 +00:00
(setq-default dotspacemacs-configuration-layers '(osx)
;; List of contribution to load.
2014-12-12 17:31:55 +00:00
)
```
## Key Bindings
Key Binding | Description
------------------|------------------------------------------------------------
<kbd>⌘ q</kbd> | Quit
<kbd>⌘ v</kbd> | Paste
<kbd>⌘ c</kbd> | Copy
<kbd>⌘ x</kbd> | Cut
<kbd>⌘ w</kbd> | Close window
<kbd>⌘ z</kbd> | Undo
<kbd>⌘ Z</kbd> | Redo
<kbd>⌃ ⌘ f</kbd> | Toggle fullscreen
2014-12-12 17:31:55 +00:00
## Future Work
- Allow user to choose from either `hyper` or `super` as ⌘. This is an option that is supported cross-platform.
- Configurable option to keep the OSX and spacemacs clipboards separate