summaryrefslogtreecommitdiffstats
path: root/CONTRIBUTING
blob: d466768bab146989759e6b8e5782a49b6450da0a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
When reporting issues:

YOU MUST INCLUDE THE TMUX VERSION

DO NOT OPEN AN ISSUE THAT DOES NOT MENTION THE TMUX VERSION

Please also include:

- your platform (Linux, OS X, 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 $TERM inside and outside of tmux;
- logs from tmux (see below);
- at most one or two screenshots, if helpful.

Please do not report bugs (crashes, incorrect behaviour) without reproducing on
a tmux built from Git master.

Note that TERM inside tmux must be a variant of screen or tmux (for example:
screen or screen-256color, tmux or tmux-256color). Please ensure this is the
case before opening an issue.

To run tmux without a config and get logs, run:

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

Then reproduce the problem, exit tmux, and attach the tmux-server-*.log file
from the current directory to the issue.