Readme update

Author: Bruno Sutic

README.md

@@ -62,29 +62,6 @@ Copying a highlighted match will take you "out" of copycat mode. Paste with
 Copying highlighted matches can be enhanced with
 [tmux yank](https://github.com/tmux-plugins/tmux-yank).
 
-### Limitations
-
-- This plugin tries hard to consistently enable "marketed" features. It uses some
-  hacks to go beyond the APIs Tmux provides. Because of this, it might have some
-  "rough edges" and there's nothing that can be done.
-
-  Examples: non-perfect file and url matching and selection. That said, usage
-  should be fine in +90% cases.
-
-- feel free to report search cases you think should work, but are not
-  (provide examples pls!). I'm open to the idea of adding more saved searches.
-
-- Tmux `vi` copy mode works faster than `emacs`. If you don't have a preference
-  yet and to speed up `tmux_copycat`, I recommend putting this in `.tmux.conf`
-  to set Tmux copy mode to `vi`:
-
-      set -g mode-keys vi
-
-- remapping `Escape` key in copy mode will break the plugin. If you have this
-  in your `.tmux.conf`, please consider removing it:
-
-      bind -t vi-copy Escape cancel
-
 ### Installation with [Tmux Plugin Manager](https://github.com/tmux-plugins/tpm) (recommended)
 
 Add plugin to the list of TPM plugins in `.tmux.conf`:
@@ -107,16 +84,17 @@ Add this line to the bottom of `.tmux.conf`:
 
     run-shell ~/clone/path/copycat.tmux
 
-Reload TMUX environment:
-
-    # type this in terminal
-    $ tmux source-file ~/.tmux.conf
-
-You should now be able to use the plugin.
+Reload TMUX environment with: `$ tmux source-file ~/.tmux.conf`. You should now
+be able to use the plugin.
 
 Optional (but recommended) install `gawk` via your package manager of choice
 for better UTF-8 character support.
 
+### Limitations
+
+This plugin has some known limitations. Please read about it
+[here](docs/limitations.md).
+
 ### Docs
 
 - Most of the behavior of tmux-copycat can be customized via tmux options.

docs/limitations.md

@@ -0,0 +1,23 @@
+# Limitations
+
+- This plugin tries hard to consistently enable "marketed" features. It uses some
+  hacks to go beyond the APIs Tmux provides. Because of this, it might have some
+  "rough edges" and there's nothing that can be done.
+
+  Examples: non-perfect file and url matching and selection. That said, usage
+  should be fine in +90% cases.
+
+- feel free to report search cases you think should work, but are not
+  (provide examples pls!). I'm open to the idea of adding more saved searches.
+
+- Tmux `vi` copy mode works faster than `emacs`. If you don't have a preference
+  yet and to speed up `tmux_copycat`, I recommend putting this in `.tmux.conf`
+  to set Tmux copy mode to `vi`:
+
+      set -g mode-keys vi
+
+- remapping `Escape` key in copy mode will break the plugin. If you have this
+  in your `.tmux.conf`, please consider removing it:
+
+      bind -t vi-copy Escape cancel
+