Move :tools macos to :os macos

modules/os/macos/README.org

@@ -0,0 +1,42 @@
+#+TITLE:   os/macos
+#+DATE:    February 19, 2017
+#+SINCE:   v1.3
+#+STARTUP: inlineimages nofold
+
+* Table of Contents :TOC_3:noexport:
+- [[#description][Description]]
+  - [[#module-flags][Module Flags]]
+  - [[#maintainers][Maintainers]]
+  - [[#plugins][Plugins]]
+- [[#features][Features]]
+  - [[#open-with-x]["Open with X"]]
+
+* Description
+This module provides extra functionality for macOS.
+
+** Module Flags
+This module provides no flags.
+
+** Maintainers
+This module has no dedicated maintainers
+
+** Plugins
++ [[https://github.com/emacsorphanage/osx-trash][osx-trash]]
++ [[https://github.com/purcell/ns-auto-titlebar][ns-auto-titlebar]]
+
+* Features
+** "Open with X"
+This module adds various macOS-specific launchers under the =SPC o= prefix (=C-c
+o= for users with Evil disabled).
+
+It also enables Keychain integration for =auth-source=. This is used by our [[file:../../../modules/app/irc/README.org][irc]]
+and [[file:../../../modules/tools/magit/README.org][magit]]-forge modules, for instance.
+
+To support GitHub Forge add an internet password like this to your keychain:
+| Field    | Value                   |
+|----------+-------------------------|
+| Name     | api.github.com          |
+| Kind     | Internet password       |
+| Account  | <username>^forge        |
+| Where    | https://api.github.com/ |
+| Password | <token>                 |