Move customization options to a separate docs page

Author: Bruno Sutic

CHANGELOG.md

@@ -1,6 +1,7 @@
 # Changelog
 
 ### master
+- move customization options to a separate docs document
 
 ### v0.8.0, Apr 05, 2015
 - do not colorize `tree` output because a pager application might not handle it

README.md

@@ -56,45 +56,9 @@ Reload TMUX environment:
 
 You should now be able to use the plugin.
 
-### Options
+### Docs
 
-Customize `tmux-sidebar` by placing options in `.tmux.conf` and reloading Tmux
-environment.
-
-> How can I run some other command in the sidebar?
-
-    set -g @sidebar-tree-command 'ls -1'
-
-> Can I have the sidebar on the right?
-
-    set -g @sidebar-tree-position 'right'
-
-> I don't like the default 'prefix + Tab' key binding. Can I change it to be
-'prefix + e'?
-
-    set -g @sidebar-tree 'e'
-
-> How can I change the default 'prefix + Backspace' to be 'prefix + w'?
-
-    set -g @sidebar-tree-focus 'w'
-
-> I see the tree sidebar uses 'less' as a pager. I would like to use 'view'.
-
-    set -g @sidebar-tree-pager 'view -'
-
-> The default sidebar width is 40 columns. I want the sidebar to be wider by
-default!
-
-    set -g @sidebar-tree-width '60'
-
-> Can I colorize the ``tree`` directory listing in the sidebar?
-
-    set -g @sidebar-tree-command 'tree -C'
-
->  Bear in mind that the command used to page the directory listing
-(``@sidebar-tree-pager``, if set) must support color codes. If it does not,
-unusual characters - the color control codes - will be visible in the
-sidebar.
+- [customization options](docs/options.md)
 
 ### Other goodies
 

docs/options.md

@@ -0,0 +1,41 @@
+## Options
+
+Customize `tmux-sidebar` by placing options in `.tmux.conf` and reloading Tmux
+environment.
+
+> How can I run some other command in the sidebar?
+
+    set -g @sidebar-tree-command 'ls -1'
+
+> Can I have the sidebar on the right?
+
+    set -g @sidebar-tree-position 'right'
+
+> I don't like the default 'prefix + Tab' key binding. Can I change it to be
+'prefix + e'?
+
+    set -g @sidebar-tree 'e'
+
+> How can I change the default 'prefix + Backspace' to be 'prefix + w'?
+
+    set -g @sidebar-tree-focus 'w'
+
+> I see the tree sidebar uses 'less' as a pager. I would like to use 'view'.
+
+    set -g @sidebar-tree-pager 'view -'
+
+> The default sidebar width is 40 columns. I want the sidebar to be wider by
+default!
+
+    set -g @sidebar-tree-width '60'
+
+> Can I colorize the ``tree`` directory listing in the sidebar?
+
+    set -g @sidebar-tree-command 'tree -C'
+
+### Notes
+
+The command used to display the directory listing
+(`@sidebar-tree-pager`, if set) must support color codes. If it does not,
+unusual characters - the color control codes - will be visible in the sidebar.
+