tmux-resurrect/docs/restoring_shell_history.md
Bruno Sutic d7825683d1
Deprecate restoring shell history
"restoring shell history" feature is very invasive and dirty. I propose
removing it in the future without the replacement.

I worry it spoils the first experience of using this plugin for users
that accidentally turn it on and don't know how to turn it off, see
https://github.com/tmux-plugins/tmux-resurrect/issues/288

Also, it hurts me to reject PRs that improve the feature.

Thoughts?
2019-08-27 13:26:29 +02:00

916 B

Restoring shell history (deprecated, do not use)

This feature is deprecated because it's very invasive. It will be removed in the future with no replacement. To see problems it causes check this issue.

Supported shells: bash and zsh.

Enable feature with this option in .tmux.conf:

set -g @resurrect-save-shell-history 'on'

Note: the older @resurrect-save-bash-history is now an alias to @resurrect-save-shell-history.

Shell history for individual panes will now be saved and restored. Due to technical limitations, this only works for panes which have no program running in foreground when saving. tmux-resurrect will send history write command to each such pane.

To prevent these commands from being added to bash history themselves, add HISTCONTROL=ignoreboth to your .bashrc (this is set by default in Ubuntu).