Move all the docs to `docs/` dir

This commit is contained in:
Bruno Sutic 2015-07-10 17:10:37 +02:00
parent 27facedfd5
commit d57df1108d
No known key found for this signature in database
GPG Key ID: 66D96E4F2F7EF26C
5 changed files with 50 additions and 2 deletions

View File

@ -2,6 +2,7 @@
### master
- refactor `shared_set_tpm_path_constant` function
- move all instructions to `docs/` dir
### v2.0.0, 2015-07-07
- enable overriding default key bindings

View File

@ -73,8 +73,9 @@ More advanced features and instructions, regular users probably do not need
this:
- [How to create a plugin](docs/how_to_create_plugin.md). It's easy.
- [Installing plugins via the command line](https://github.com/tmux-plugins/tpm/wiki/Installing-plugins-via-the-command-line-only)
- [Changing plugins install dir](https://github.com/tmux-plugins/tpm/wiki/Changing-plugins-install-dir)
- [Installing plugins via the command line](docs/installing_plugins_via_cmd_line.md)
- [Changing plugins install dir](docs/changing_plugins_install_dir.md)
- [Automatic TPM installation](docs/automatic_tpm_installation.md)
### Tests

View File

@ -0,0 +1,12 @@
# Automatic tpm installation
One of the first things we do on a new machine is cloning our dotfiles. Not everything comes with them though, so for example `tpm` most likely won't be installed.
If you wanna install `tpm` automatically when tmux is started, put the following snippet in `.tmux.conf` before the final `run '~/.tmux/plugins/tpm/tpm'`:
```
if "test ! -d ~/.tmux/plugins/tpm" \
"run 'git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm'"
```
This useful tip was submitted by @acr4.

View File

@ -0,0 +1,14 @@
# Changing plugins install dir
By default, TPM installs plugins to `~/.tmux/plugins/`.
You can change the install path by putting this in `.tmux.conf`:
set-environment -g TMUX_PLUGIN_MANAGER_PATH '/some/other/path/'
Tmux plugin manager initialization in `.tmux.conf` should also be updated:
# initializes TMUX plugin manager in a new path
run /some/other/path/tpm/tpm
Please make sure that the `run` line is at the very bottom of `.tmux.conf`.

View File

@ -0,0 +1,20 @@
# Installing plugins via the command line only
### From inside tmux
When you have `tmux` running, plugins can be installed with the following command:
~/.tmux/plugins/tpm/scripts/install_plugins.sh
This is the equivalent of pressing `prefix + I`.
### From outside tmux
To install the plugins when `tmux` is not even started (for example in a provisioning script):
# start tmux and create a session but don't attach to it
tmux new-session -d
# install the plugins
tmux run "~/.tmux/plugins/tpm/scripts/install_plugins.sh"
# killing the session is not required
tmux kill-session