JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
Synchronizing the FAQ of the website and the repository.
[st.git] / FAQ
1 --
2 Why does st not handle utmp entries?
3
4 Use the excellent tool of utmp[0] for this task.
5
6 [0] http://git.suckless.org/utmp/
7 --
8 Some _random program_ complains that st is unknown/not
9 recognised/unsupported/whatever!
10
11 It means that st doesn’t have any terminfo entry on your system. Chances are
12 you did not make install. If you just want to test it without installing it,
13 you can manualy run tic -s st.info in st dir. It will compile st.info into a
14 fully working local terminfo description. You can delete it when you’re done.
15 --
16 Nothing works, and nothing is said about an unknown terminal!
17
18 * Some programs just assume they’re running in xterm i.e. they don’t rely on
19   terminfo. What you see is the current state of the “xterm compliance”.
20 * Some programs don’t complain about the lacking st description and default to
21   another terminal. In that case see the question about terminfo.
22 --
23 I get some weird glitches/visual bug on _random program_!
24
25 Try lauching it with a different TERM: $ TERM=xterm myapp. toe(1) will give
26 you a list of available terminals, but you’ll most likely switch between
27 xterm, st or st-256color. The default value for TERM can be changed in
28 config.h (TNAME).
29 --
30 How do I scroll back up?
31
32 Invoke st with a screen multiplexer like GNU screen[0] or tmux[1].
33 st -e screen works better for text reflowing. To enter screen’s scroll
34 back mode aka “copy mode”, it’s C-a ESC. You probably want defscrollback
35 10000 in your ~/.screenrc too.
36
37 [0] http://en.wikipedia.org/wiki/GNU_Screen
38 [1] http://en.wikipedia.org/wiki/Tmux
39 --
40