tmux2.9aにアップデートしたらマイグレーションが必要だった

環境

% sw_vers
ProductName:    Mac OS X
ProductVersion: 10.14.6
BuildVersion:   18G95

事象

Macでtmuxを使っていた。
.tmux.confを用意してカスタマイズして使っていた。
このとき、homebrewを使って brew upgrade をしてtmuxをバージョンアップしたときに差異を発見。

バージョン 2.9aを使用

% tmux -V
tmux 2.9a

警告

/Users/hoge/.tmux.conf:114: invalid option: status-attr
/Users/hoge/.tmux.conf:117: invalid option: window-status-fg
/Users/hoge/.tmux.conf:118: invalid option: window-status-bg
/Users/hoge/.tmux.conf:119: invalid option: window-status-attr
/Users/hoge/.tmux.conf:122: invalid option: window-status-fg
/Users/hoge/.tmux.conf:123: invalid option: window-status-current-bg
/Users/hoge/.tmux.conf:124: invalid option: window-status-current-attr
/Users/hoge/.tmux.conf:127: invalid option: pane-border-fg
/Users/hoge/.tmux.conf:128: invalid option: pane-active-border-fg
/Users/hoge/.tmux.conf:131: invalid option: message-bg
/Users/hoge/.tmux.conf:132: invalid option: message-fg

どうも書式が変わってしまったようだ。

CHANGES FROM 2.8 to 2.9

relase：https://raw.githubusercontent.com/tmux/tmux/2.9a/CHANGES

2.8と2.9の違いより

* The individual -fg, -bg and -attr options have been removed; they
  were superseded by -style options in tmux 1.9.

-fg, -bg と個々に設定していたがなくなったようだ。
pane-active-border-fg や window-status-current-bg の設定に invalid option と言われる理由はここ。

マイグレーションする

参考：tmux v2.9 マイグレーションガイド 〜 tmux をv2.9 に上げたらinvalid option エラーが出た - Qiita

こちらより便利ツールの紹介あり。

For tmux configs: Merge deprecated/removed -fg, -bg, and -attr options into the -style option · GitHub

これを使って実行するとさくっとマイグレーションすることができた。

変更点より差分例

• status-style ... status barの色変更

-set-option -g status-bg black
-set-option -g status-fg yellow
-set-option -g status-attr dim
+set-option -g status-style bg=black,fg=yellow,dim

• windows-status-style ... window titleの色変更

-set-window-option -g window-status-fg blue
-set-window-option -g window-status-bg black
-set-window-option -g window-status-attr dim
+set-window-option -g window-status-style fg=blue,bg=black,dim,fg=brightblue

• window-status-current-style ... active window tilteの色変更

-set-window-option -g window-status-fg brightblue
-set-window-option -g window-status-current-bg blue
-set-window-option -g window-status-current-attr dim
+set-window-option -g window-status-current-style bg=blue,dim

• pane-border-style / pane-active-border-style

-set-option -g pane-border-fg black
+set-option -g pane-border-style fg=black
-set-option -g pane-active-border-fg brightgreen
+set-option -g pane-active-border-style fg=brightgreen

• tmessage-style ... textの色

-set-option -g message-bg black
-set-option -g message-fg brightred
+set-option -g message-style bg=black,fg=brightred

色はひとそれぞだが、変更箇所の例として紹介する。