diff options
Diffstat (limited to 'doc/cha-troubleshooting.5')
| -rw-r--r-- | doc/cha-troubleshooting.5 | 36 |
1 files changed, 24 insertions, 12 deletions
diff --git a/doc/cha-troubleshooting.5 b/doc/cha-troubleshooting.5 index 8f205664..3748c99c 100644 --- a/doc/cha-troubleshooting.5 +++ b/doc/cha-troubleshooting.5 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 3.3 +.\" Automatically generated by Pandoc 3.4 .\" .TH "cha\-troubleshooting" "5" "" "" "Troubleshooting Chawan" .SH Troubleshooting Chawan @@ -6,30 +6,30 @@ This document lists common problems you may run into when using Chawan. .SS I can\[cq]t select/copy text with my mouse? Your options are: .IP \[bu] 2 -Use \f[CR]v\f[R] (and copy with \f[CR]y\f[R]). -Drawback: requires keyboard +Press \f[CR]v\f[R] (and copy with \f[CR]y\f[R]). +You can then expand the selection with the mouse. .IP \[bu] 2 Hold down the shift key while selecting. -Drawback: can only select text currently on the screen +Drawback: can only select text currently on the screen, and you +can\[cq]t select tabs. .IP \[bu] 2 Disable mouse support (\f[CR]input.use\-mouse = false\f[R] in config.toml). -Drawback: see above (plus now you can\[cq]t use the mouse to move on the -screen) +Drawback: see above. .SS Why do I get strange/incorrect/ugly colors? Chawan\[cq]s display capabilities depend on what your terminal reports. In particular: .IP \[bu] 2 if the \f[CR]$COLORTERM\f[R] variable is not set, then it may fall back -to 8\-bit or ANSI colors +to 8\-bit or ANSI colors. +Make sure you export it as \f[CR]COLORTERM=truecolor\f[R]. .IP \[bu] 2 if it does not respond to querying the background color, then -Chawan\[cq]s color contrast correction will likely malfunction -.PP -You can fix this manually by exporting \f[CR]COLORTERM=truecolor\f[R] -and +Chawan\[cq]s color contrast correction will likely malfunction. +you can correct this using the \f[CR]display.default\-background\-color\f[R]/\f[CR]display.default\-foreground\-color\f[R] variables. +.PP See config.md for details. .SS Can I view Markdown files using Chawan? Yes; Chawan now has a built\-in markdown converter. @@ -43,7 +43,7 @@ Unfortunately, mandoc passes us the formatted document as a \f[I]file\f[R], which Chawan reasonably interprets as plain text without formatting. .PP -At this point you have two options: +At this point, you have two options: .IP \[bu] 2 \f[CR]export PAGER=\[aq]cha \-T text/x\-ansi\[aq]\f[R] and see that man suddenly works as expected. @@ -53,6 +53,18 @@ expected. .PP Ideally you should do both, to deal with cases like git help which shells out to man directly. +.PP +There is still one problem with this solution: some programs will try to +call \f[CR]$PAGER\f[R] without shell expansion, breaking the +\f[CR]\-T text/x\-ansi\f[R] trick. +To fix this, put a script somewhere in your \f[CR]PATH\f[R]: +.IP +.EX +\f[I]#!/bin/sh\f[R] +exec cha \-T text/x\-ansi \[dq]$\[at]\[dq] +.EE +.PP +and \f[CR]export PAGER=pcha\f[R]. .SS Where are the keybindings? Please run \f[CR]cha about:chawan\f[R] for a list of default keybindings. |