summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDan Davison <dandavison7@gmail.com>2022-02-26 09:53:07 -0500
committerDan Davison <dandavison7@gmail.com>2022-02-26 09:54:34 -0500
commit702bb5c8fdf568bce5056bdc9a66cdbc6146b590 (patch)
tree5543f166be183810fca5d7aa3586d93f160f019b
parentf165f56b849f6a4cbb97f3ce2da585bd8b0b03d8 (diff)
Create separate "Using delta with tmux" manual entry
-rw-r--r--manual/src/24-bit-color-truecolor.md10
-rw-r--r--manual/src/SUMMARY.md1
-rw-r--r--manual/src/using-delta-with-gnu-screen.md2
-rw-r--r--manual/src/using-delta-with-tmux.md7
4 files changed, 10 insertions, 10 deletions
diff --git a/manual/src/24-bit-color-truecolor.md b/manual/src/24-bit-color-truecolor.md
index 53d47dda..8b82d47d 100644
--- a/manual/src/24-bit-color-truecolor.md
+++ b/manual/src/24-bit-color-truecolor.md
@@ -3,13 +3,3 @@
Delta looks best if your terminal application supports 24 bit colors. See https://github.com/termstandard/colors#readme. For example, on MacOS, iTerm2 supports 24-bit colors but Terminal.app does not.
If your terminal application does not support 24-bit color, delta will still work, by automatically choosing the closest color from those available. See the `Colors` section of the help output below.
-
-If you're using tmux, it's worth checking that 24 bit color is working correctly. For example, run a color test script like [this one](https://gist.githubusercontent.com/lifepillar/09a44b8cf0f9397465614e622979107f/raw/24-bit-color.sh), or one of the others listed [here](https://gist.github.com/XVilka/8346728). If you do not see smooth color gradients, see the discussion at [tmux#696](https://github.com/tmux/tmux/issues/696). The short version is you need something like this in your `~/.tmux.conf`:
-
-```Shell
-set -ga terminal-overrides ",xterm-256color:Tc"
-```
-
-and you may then need to quit tmux completely for it to take effect.
-
-True color output in GNU Screen is currently only possible when using a development build, as support for it is not yet implemented in the (v4) release versions. A snapshot of the latest Git trunk can be obtained via https://git.savannah.gnu.org/cgit/screen.git/snapshot/screen-master.tar.gz - the required build steps are described in the `src/INSTALL` file. After installing the program, 24-bit color support can be activated by including `truecolor on` in either the system's or the user's `screenrc` file.
diff --git a/manual/src/SUMMARY.md b/manual/src/SUMMARY.md
index 210d4009..992c51d6 100644
--- a/manual/src/SUMMARY.md
+++ b/manual/src/SUMMARY.md
@@ -19,6 +19,7 @@
- [Merge conflicts](./merge-conflicts.md)
- [Git blame](./git-blame.md)
- [24 bit color (truecolor)](./24-bit-color-truecolor.md)
+ - [Using Delta with tmux](./using-delta-with-tmux.md)
- [Using Delta with GNU Screen](./using-delta-with-gnu-screen.md)
- [Using Delta on Windows](./using-delta-on-windows.md)
- [Mouse scrolling](./mouse-scrolling.md)
diff --git a/manual/src/using-delta-with-gnu-screen.md b/manual/src/using-delta-with-gnu-screen.md
index 2fa8f533..918e8733 100644
--- a/manual/src/using-delta-with-gnu-screen.md
+++ b/manual/src/using-delta-with-gnu-screen.md
@@ -1,5 +1,7 @@
# Using Delta with GNU Screen
+True color output in GNU Screen is currently only possible when using a development build, as support for it is not yet implemented in the (v4) release versions. A snapshot of the latest Git trunk can be obtained via https://git.savannah.gnu.org/cgit/screen.git/snapshot/screen-master.tar.gz - the required build steps are described in the `src/INSTALL` file. After installing the program, 24-bit color support can be activated by including `truecolor on` in either the system's or the user's `screenrc` file.
+
When working in Screen without true color output, it might be that colors supposed to be different look the same in XTerm compatible terminals. If that is the case, make sure the following settings are included in your `screenrc` file:
```Shell
diff --git a/manual/src/using-delta-with-tmux.md b/manual/src/using-delta-with-tmux.md
new file mode 100644
index 00000000..5367395c
--- /dev/null
+++ b/manual/src/using-delta-with-tmux.md
@@ -0,0 +1,7 @@
+If you're using tmux, it's worth checking that 24 bit color is working correctly. For example, run a color test script like [this one](https://gist.githubusercontent.com/lifepillar/09a44b8cf0f9397465614e622979107f/raw/24-bit-color.sh), or one of the others listed [here](https://gist.github.com/XVilka/8346728). If you do not see smooth color gradients, see the discussion at [tmux#696](https://github.com/tmux/tmux/issues/696). The short version is you need something like this in your `~/.tmux.conf`:
+
+```Shell
+set -ga terminal-overrides ",xterm-256color:Tc"
+```
+
+and you may then need to quit tmux completely for it to take effect.