Skip to content

Latest commit

History

History
79 lines (49 loc) · 1.86 KB

CONTRIBUTING.md

File metadata and controls

79 lines (49 loc) · 1.86 KB

What should I do before opening an issue?

Before opening an issue, please ensure that:

  • Your problem is a specific problem or question or suggestion, not a general complaint.

  • $TERMinside tmux is screen, screen-256color, tmux or tmux-256color. Check by runningecho $TERMinside tmux.

  • You can reproduce the problem with the latest tmux release, or a build from Git master.

  • Your question or issue is not coveredin the manual(runman tmux).

  • Your problem is not mentioned inthe CHANGES file.

  • Nobody else has opened the same issue recently.

What should I include in an issue?

Please include the output of:

uname -sp&&tmux -V&&echo$TERM

Also include:

  • Your platform (Linux, macOS, or whatever).

  • A brief description of the problem with steps to reproduce.

  • A minimal tmux config, if you can't reproduce without a config.

  • Your terminal, and$TERMinside and outside of tmux.

  • Logs from tmux (see below). Please attach logs to the issue directly rather than using a download site or pastebin. Put in a zip file if necessary.

  • At most one or two screenshots, if helpful.

How do I test without a.tmux.conf?

Run a separate tmux server with-f/dev/nullto skip loading.tmux.conf:

tmux -Ltest kill-server
tmux -Ltest -f/dev/null new

How do I get logs from tmux?

Add-vvto tmux to create three log files in the current directory. If you can reproduce without a configuration file:

tmux -Ltest kill-server
tmux -vv -Ltest -f/dev/null new

Or if you need your configuration:

tmux kill-server
tmux -vv new

The log files are:

  • tmux-server*.log:server log file.

  • tmux-client*.log:client log file.

  • tmux-out*.log:output log file.

Please attach the log files to your issue.