From ca0cbc2f01dbe7d916453370a033f8fc2dec811e Mon Sep 17 00:00:00 2001
From: jgrogan <james.grogan@ichec.ie>
Date: Fri, 31 May 2024 17:00:55 +0100
Subject: [PATCH] Split some sections into their own pages.

---
 README.md          | 85 ++++------------------------------------------
 doc/emacs_notes.md | 33 ++++++++++++++++++
 doc/mac.md         | 47 +++++++++++++++++++++++++
 3 files changed, 86 insertions(+), 79 deletions(-)
 create mode 100644 doc/emacs_notes.md
 create mode 100644 doc/mac.md

diff --git a/README.md b/README.md
index 89b6695..bc510ec 100644
--- a/README.md
+++ b/README.md
@@ -1,86 +1,13 @@
-This repo has some scripts and small notes for setting up development ennvironments
+This repo has some scripts and small notes for setting up development and deployment environments on different platforms.
 
-# Mac
+* [Mac Development](./doc/mac.md)
+* [Emacs](./doc/emacs_notes.md)
+* [VM Notes](./doc/vm_notes.md)
 
-## Multimedia
-
-* [mplayer](http://www.mplayerhq.hu/design7/news.html)
-
-``` shell
-brew install mplayer
-```
-
-## [Gnu Stow](https://www.gnu.org/software/stow/)
-
-Gnu Stow is a symlink manager that can be used to manager program configuration files or 'dotfiles'.
-
-``` shell
-brew install stow
-```
-
-## [Amethyst](https://ianyh.com/amethyst/)
-
-Tiling window manager that doesn't need too heavy permissions.
-
-## Keyboard Shortcuts
-
-### Desktop
-
-* `CMD-m`: Minimize focused app.
-* `CMD-q`: Kill the focused app.
-* `CMD-TAB`: Iterate apps in dock with arrows. Hold `OPT` when releasing to open.
-* `CTRL-CMD-q`: Lock Screen
-
-### Amethys
-
-* `OPT-SHIFT-k`: Move focus ccw (j for cw)
-* `OPT-SHIFT-p`: Move focus to ccw screen (n for cw) 
-* `CTRL-OPT-SHIFT-h`: Swap screens ccw (l for c)
-
-### Safari
-
-* Arrow keys: Scroll
-* `OPT-Arrow`: Fast scroll
-* `SHIFT-CMD-]`: Next or previous tab
-* `CMD-t`: New tab
-* `CMD-w`: Close active tab
-* `CMD-[`: Previous or next page
-* `CTRL-CMD-1`: Toggle bookmark view
-
-### Emacs
-
-#### Base
-
-* `C-x C-s`: Save current file.
-* `C-x C-f`: Find or open file.
-
-#### Markdown
-
-[Module Reference](http://www.mplayerhq.hu/design7/news.html)
-
-* `C-c C-s 1`: Insert level one heading with hash delimiter.
-
-#### Evil
-
-[Reference card](https://michaelgoerz.net/refcards/vimqrc.pdf)
-
-* `CTRL- {D, U, F, B}`: Scroll down/up by half or full page
-* `zt zz zb`: Scroll current line to top, centre, bottom
-* `{ }`: Move to beginning or end of paragraph
-* `h l j k`: Character left, right, up, down
-
-#### Magit
-
-[Reference card](https://magit.vc/manual/magit-refcard.pdf)
-
-* `CTRL-x g`: Status buffer
-* `S`: Stage all changes
-* `c`: Start a commit
-  * `C-c C-c`: Finish a commit
-* `P`: Start a push
-  * `u`: Push to origin 
+There is another repo just for dotfiles that may be of interest also: https://codeberg.org/jmsgrogan/dotfiles
 
 # Copyright
 
 The contents of this repo are Copyright James Grogan 2024. Software is licensed under the AGPL. See the included LICENSE file for details.
 
+Documentation and images can be re-used under a Creative Commons CC BY-SA license: https://creativecommons.org/licenses/by-sa/4.0/
diff --git a/doc/emacs_notes.md b/doc/emacs_notes.md
new file mode 100644
index 0000000..55a65dd
--- /dev/null
+++ b/doc/emacs_notes.md
@@ -0,0 +1,33 @@
+# Emacs
+
+## Base
+
+* `C-x C-s`: Save current file.
+* `C-x C-f`: Find or open file.
+
+## Markdown
+
+[Module Reference](http://www.mplayerhq.hu/design7/news.html)
+
+* `C-c C-s 1`: Insert level one heading with hash delimiter.
+
+## Evil
+
+[Reference card](https://michaelgoerz.net/refcards/vimqrc.pdf)
+
+* `CTRL- {D, U, F, B}`: Scroll down/up by half or full page
+* `zt zz zb`: Scroll current line to top, centre, bottom
+* `{ }`: Move to beginning or end of paragraph
+* `h l j k`: Character left, right, up, down
+
+## Magit
+
+[Reference card](https://magit.vc/manual/magit-refcard.pdf)
+
+* `CTRL-x g`: Status buffer
+* `S`: Stage all changes
+* `c`: Start a commit
+  * `C-c C-c`: Finish a commit
+* `P`: Start a push
+  * `u`: Push to origin 
+
diff --git a/doc/mac.md b/doc/mac.md
new file mode 100644
index 0000000..d124394
--- /dev/null
+++ b/doc/mac.md
@@ -0,0 +1,47 @@
+# Applications
+
+## Multimedia
+
+* [mplayer](http://www.mplayerhq.hu/design7/news.html)
+
+``` shell
+brew install mplayer
+```
+
+## [Gnu Stow](https://www.gnu.org/software/stow/)
+
+Gnu Stow is a symlink manager that can be used to manager program configuration files or 'dotfiles'.
+
+``` shell
+brew install stow
+```
+
+## [Amethyst](https://ianyh.com/amethyst/)
+
+Tiling window manager that doesn't need too heavy permissions.
+
+# Keyboard Shortcuts
+
+## Desktop
+
+* `CMD-m`: Minimize focused app.
+* `CMD-q`: Kill the focused app.
+* `CMD-TAB`: Iterate apps in dock with arrows. Hold `OPT` when releasing to open.
+* `CTRL-CMD-q`: Lock Screen
+
+## Amethyst
+
+* `OPT-SHIFT-k`: Move focus ccw (j for cw)
+* `OPT-SHIFT-p`: Move focus to ccw screen (n for cw) 
+* `CTRL-OPT-SHIFT-h`: Swap screens ccw (l for c)
+
+## Safari
+
+* Arrow keys: Scroll
+* `OPT-Arrow`: Fast scroll
+* `SHIFT-CMD-]`: Next or previous tab
+* `CMD-t`: New tab
+* `CMD-w`: Close active tab
+* `CMD-[`: Previous or next page
+* `CTRL-CMD-1`: Toggle bookmark view
+