mirror of
git://git.suckless.org/st
synced 2025-08-01 04:32:13 -07:00
Compare commits
234 Commits
Author | SHA1 | Date | |
---|---|---|---|
|
92e092efe6 | ||
|
5f48e89716 | ||
|
bdd649a102 | ||
|
71fa10f613 | ||
|
caa97cc781 | ||
|
c03548750b | ||
|
8e15887de9 | ||
|
89cf0fc597 | ||
|
980991fa6e | ||
|
ae1923d275 | ||
|
38af006b5e | ||
|
c990abfedf | ||
|
3cb7f27afe | ||
|
1811b6030c | ||
|
22571ea4e8 | ||
|
8751809aff | ||
|
765bb0fd14 | ||
|
07ce96a3a0 | ||
|
190b94c7a2 | ||
|
4f21c41a1c | ||
|
3a5053f6c1 | ||
|
7ab6c92e18 | ||
|
0622ad9bad | ||
|
21f765426c | ||
|
753fe862b1 | ||
|
61c35cd246 | ||
|
742a41d655 | ||
|
f36dd277a2 | ||
|
0d7448dabc | ||
|
b17aa18f7c | ||
|
736685d641 | ||
|
89807ed453 | ||
|
84c756b97e | ||
|
2fdcc5e5f6 | ||
|
ab69ea89b7 | ||
|
5528280fae | ||
|
6dc2b546ec | ||
|
c27c731b9f | ||
|
6ee56d6590 | ||
|
215bdb2da3 | ||
|
56abffb4b6 | ||
|
aff35af275 | ||
|
83e73c6242 | ||
|
42fa1f5ce4 | ||
|
23ed12857f | ||
|
9eb70a2d3e | ||
|
9619760e12 | ||
|
a6af2cc469 | ||
|
b94ad75e5d | ||
|
e6dd0f825d | ||
|
b0310fba5d | ||
|
9d1495f9ee | ||
|
c569e3146e | ||
|
39ae1a4de5 | ||
|
6352502d64 | ||
|
b9390a5496 | ||
|
d2937b05ae | ||
|
d3e0f3444b | ||
|
ecac5ee35e | ||
|
93b54cfcc4 | ||
|
6f5f770186 | ||
|
6524f022f7 | ||
|
9305f3c184 | ||
|
5bb90125c8 | ||
|
69d1fe06a9 | ||
|
288f80cb06 | ||
|
c9357a8edf | ||
|
580302f317 | ||
|
246c3481d7 | ||
|
b341e51351 | ||
|
86d1e432a8 | ||
|
c7e24e44c8 | ||
|
5406e655da | ||
|
72d2accc22 | ||
|
2fcfea1bf1 | ||
|
b746816b78 | ||
|
4f60751440 | ||
|
f5075a9e9d | ||
|
c87d45466b | ||
|
28259f5750 | ||
|
adeb2e95d6 | ||
|
9494362d0b | ||
|
cf1fcc4d96 | ||
|
230d0c8428 | ||
|
b0bddc694a | ||
|
487bbb24d0 | ||
|
29619a1a35 | ||
|
b8804f9f67 | ||
|
1b514048b2 | ||
|
3604445ffc | ||
|
ac11bbb03b | ||
|
c5f1d74fd8 | ||
|
7dd24bfb4c | ||
|
aba6c292af | ||
|
4d14d97547 | ||
|
708b697ed7 | ||
|
09f5d98251 | ||
|
4418939dd9 | ||
|
bafbba56cd | ||
|
11625c7166 | ||
|
008aae541b | ||
|
cd159883d1 | ||
|
f9fb620914 | ||
|
86633ada91 | ||
|
dcfe505d3c | ||
|
88429cdcbf | ||
|
0c8feecbf7 | ||
|
a7eef8f230 | ||
|
63a07eb19c | ||
|
dc8c5c82aa | ||
|
c7a945c408 | ||
|
5afb3862ba | ||
|
0392d165d0 | ||
|
98a1085d0e | ||
|
51466e019a | ||
|
c490a60b80 | ||
|
83dea7fd7b | ||
|
e5f6736ee0 | ||
|
a3549c2eec | ||
|
8342036f98 | ||
|
9d9e049eac | ||
|
177d888dff | ||
|
fa04911c91 | ||
|
1926305318 | ||
|
8f3e6a577d | ||
|
f8b4998b32 | ||
|
6530025bca | ||
|
d4a17316d3 | ||
|
20c4f12254 | ||
|
821a6e00a5 | ||
|
8de8ae3923 | ||
|
ec3268961d | ||
|
769d481807 | ||
|
b4dfa18124 | ||
|
e8f3513bf4 | ||
|
f210ea26c4 | ||
|
8306568bd0 | ||
|
844cd7ce17 | ||
|
8c5ba1cfb0 | ||
|
3949aa7c5d | ||
|
84ceefe089 | ||
|
b5d0a13c10 | ||
|
984c12d2a6 | ||
|
da78629cf5 | ||
|
f5356d0185 | ||
|
bcbaf5d9be | ||
|
f796533b1b | ||
|
955923b38b | ||
|
0015e198bf | ||
|
1fc4afd1e6 | ||
|
21bd4f4f9d | ||
|
50e6355e0d | ||
|
77569526c0 | ||
|
19d095717f | ||
|
5edeec1b20 | ||
|
738f555f66 | ||
|
58eaa998b3 | ||
|
c2fd2754eb | ||
|
27b28f1dc2 | ||
|
587b443592 | ||
|
93661042a2 | ||
|
18a05fdf43 | ||
|
5159d55c63 | ||
|
6fd887077e | ||
|
bb6dc33206 | ||
|
2323e962e6 | ||
|
c6fcb78b3a | ||
|
8b4cfcea73 | ||
|
a32c5f5726 | ||
|
ba36d1394b | ||
|
ede83bd08b | ||
|
2411308bd2 | ||
|
d03aa8d20b | ||
|
80d8051269 | ||
|
488977c8ef | ||
|
f4ebb3180f | ||
|
3544e354b2 | ||
|
cf890e5bf0 | ||
|
bdb850a16a | ||
|
e31829f659 | ||
|
5e917ab287 | ||
|
99fb365aa3 | ||
|
870f961c49 | ||
|
1629363f2d | ||
|
6b315558f8 | ||
|
5f91983541 | ||
|
9e3e8ce466 | ||
|
0e439e5624 | ||
|
74962bf566 | ||
|
6681af165b | ||
|
1ae2745fd1 | ||
|
a48f2be7f5 | ||
|
17fa1493ee | ||
|
a8a9e66a7d | ||
|
17290f493b | ||
|
43d74ef362 | ||
|
3764f38fc8 | ||
|
53105cf74f | ||
|
aa35bbd7a1 | ||
|
704d12442e | ||
|
02d2df5790 | ||
|
c4b79b055d | ||
|
7f1e02e4db | ||
|
84f6dbffa5 | ||
|
2d67f99d28 | ||
|
4a8574b439 | ||
|
8f11e1cd03 | ||
|
844c503c80 | ||
|
1b0b9759dc | ||
|
99d2d6007a | ||
|
fe31a3f634 | ||
|
6b7f63bac5 | ||
|
80b32af794 | ||
|
16ac85bf54 | ||
|
fe527aa508 | ||
|
3afdb4ff04 | ||
|
f9dc374ea0 | ||
|
fa19f241a3 | ||
|
df1810dd8f | ||
|
ed855ea432 | ||
|
68d97457ec | ||
|
49672dac7b | ||
|
f21e47f44a | ||
|
87abc7cd59 | ||
|
1388870331 | ||
|
6b56cbf9cc | ||
|
3269bf213d | ||
|
4ad2fc7f18 | ||
|
dc74c4f729 | ||
|
b8d6171cb0 | ||
|
ebb6e03201 | ||
|
f27b44b7c2 | ||
|
3cb80840db | ||
|
c46d929fe1 |
96
FAQ
96
FAQ
@@ -37,23 +37,23 @@ Taken from the terminfo manpage:
|
||||
are pressed, this information can be given. Note that it is not
|
||||
possible to handle terminals where the keypad only works in
|
||||
local (this applies, for example, to the unshifted HP 2621 keys).
|
||||
If the keypad can be set to transmit or not transmit, tive these
|
||||
If the keypad can be set to transmit or not transmit, give these
|
||||
codes as smkx and rmkx. Otherwise the keypad is assumed to
|
||||
always transmit.
|
||||
|
||||
In the st case smkx=E[?1hE= and rmkx=E[?1lE>, so it is mandatory that
|
||||
applications which want to test against keypad keys, have to send these
|
||||
applications which want to test against keypad keys send these
|
||||
sequences.
|
||||
|
||||
But buggy applications like bash and irssi for example don't do this. A fast
|
||||
But buggy applications (like bash and irssi, for example) don't do this. A fast
|
||||
solution for them is to use the following command:
|
||||
|
||||
$ printf "\033?1h\033=" >/dev/tty
|
||||
$ printf '\033[?1h\033=' >/dev/tty
|
||||
|
||||
or
|
||||
$ echo $(tput smkx) >/dev/tty
|
||||
$ tput smkx
|
||||
|
||||
In the case of bash readline is used. Readline has a different note in its
|
||||
In the case of bash, readline is used. Readline has a different note in its
|
||||
manpage about this issue:
|
||||
|
||||
enable-keypad (Off)
|
||||
@@ -84,8 +84,84 @@ If you are using zsh, then read the zsh FAQ
|
||||
|
||||
Putting these lines into your .zshrc will fix the problems.
|
||||
|
||||
## How can use meta in 8bit mode?
|
||||
## How can I use meta in 8bit mode?
|
||||
|
||||
St supports meta in 8bit mode, but the default terminfo entry doesn't
|
||||
use this capability. If you want it, you have to use the 'st-meta' value
|
||||
in TERM.
|
||||
|
||||
## I cannot compile st in OpenBSD
|
||||
|
||||
OpenBSD lacks librt, despite it being mandatory in POSIX
|
||||
<http://pubs.opengroup.org/onlinepubs/9699919799/utilities/c99.html#tag_20_11_13>.
|
||||
If you want to compile st for OpenBSD you have to remove -lrt from config.mk, and
|
||||
st will compile without any loss of functionality, because all the functions are
|
||||
included in libc on this platform.
|
||||
|
||||
## The Backspace Case
|
||||
|
||||
St is emulating the Linux way of handling backspace being delete and delete being
|
||||
backspace.
|
||||
|
||||
This is an issue that was discussed in suckless mailing list
|
||||
<http://lists.suckless.org/dev/1404/20697.html>. Here is why some old grumpy
|
||||
terminal users wants its backspace to be how he feels it:
|
||||
|
||||
Well, I am going to comment why I want to change the behaviour
|
||||
of this key. When ASCII was defined in 1968, communication
|
||||
with computers was done using punched cards, or hardcopy
|
||||
terminals (basically a typewriter machine connected with the
|
||||
computer using a serial port). ASCII defines DELETE as 7F,
|
||||
because, in punched-card terms, it means all the holes of the
|
||||
card punched; it is thus a kind of 'physical delete'. In the
|
||||
same way, the BACKSPACE key was a non-destructive backspace,
|
||||
as on a typewriter. So, if you wanted to delete a character,
|
||||
you had to BACKSPACE and then DELETE. Another use of BACKSPACE
|
||||
was to type accented characters, for example 'a BACKSPACE `'.
|
||||
The VT100 had no BACKSPACE key; it was generated using the
|
||||
CONTROL key as another control character (CONTROL key sets to
|
||||
0 b7 b6 b5, so it converts H (code 0x48) into BACKSPACE (code
|
||||
0x08)), but it had a DELETE key in a similar position where
|
||||
the BACKSPACE key is located today on common PC keyboards.
|
||||
All the terminal emulators emulated the difference between
|
||||
these keys correctly: the backspace key generated a BACKSPACE
|
||||
(^H) and delete key generated a DELETE (^?).
|
||||
|
||||
But a problem arose when Linus Torvalds wrote Linux. Unlike
|
||||
earlier terminals, the Linux virtual terminal (the terminal
|
||||
emulator integrated in the kernel) returned a DELETE when
|
||||
backspace was pressed, due to the VT100 having a DELETE key in
|
||||
the same position. This created a lot of problems (see [1]
|
||||
and [2]). Since Linux has become the king, a lot of terminal
|
||||
emulators today generate a DELETE when the backspace key is
|
||||
pressed in order to avoid problems with Linux. The result is
|
||||
that the only way of generating a BACKSPACE on these systems
|
||||
is by using CONTROL + H. (I also think that emacs had an
|
||||
important point here because the CONTROL + H prefix is used
|
||||
in emacs in some commands (help commands).)
|
||||
|
||||
From point of view of the kernel, you can change the key
|
||||
for deleting a previous character with stty erase. When you
|
||||
connect a real terminal into a machine you describe the type
|
||||
of terminal, so getty configures the correct value of stty
|
||||
erase for this terminal. In the case of terminal emulators,
|
||||
however, you don't have any getty that can set the correct
|
||||
value of stty erase, so you always get the default value.
|
||||
For this reason, it is necessary to add 'stty erase ^H' to your
|
||||
profile if you have changed the value of the backspace key.
|
||||
Of course, another solution is for st itself to modify the
|
||||
value of stty erase. I usually have the inverse problem:
|
||||
when I connect to non-Unix machines, I have to press CONTROL +
|
||||
h to get a BACKSPACE. The inverse problem occurs when a user
|
||||
connects to my Unix machines from a different system with a
|
||||
correct backspace key.
|
||||
|
||||
[1] http://www.ibb.net/~anne/keyboard.html
|
||||
[2] http://www.tldp.org/HOWTO/Keyboard-and-Console-HOWTO-5.html
|
||||
|
||||
## But I really want the old grumpy behaviour of my terminal
|
||||
|
||||
Apply [1].
|
||||
|
||||
[1] http://st.suckless.org/patches/delkey
|
||||
|
||||
St support meta in 8bit mode, but the default terminfo entry doesn't
|
||||
use this capability. If you want it, you have to use st-meta value
|
||||
in TERM.
|
||||
|
9
LICENSE
9
LICENSE
@@ -1,15 +1,16 @@
|
||||
MIT/X Consortium License
|
||||
|
||||
© 2009-2012 Aurélien APTEL <aurelien dot aptel at gmail dot com>
|
||||
© 2009-2012 Aurélien APTEL <aurelien dot aptel at gmail dot com>
|
||||
© 2009 Anselm R Garbe <garbeam at gmail dot com>
|
||||
© 2012 Roberto E. Vargas Caballero <k0ga at shike2 dot com>
|
||||
© 2012 Christoph Lohmann <20h at r-36 dot net>
|
||||
© 2012-2015 Roberto E. Vargas Caballero <k0ga at shike2 dot com>
|
||||
© 2012-2015 Christoph Lohmann <20h at r-36 dot net>
|
||||
© 2013 Eon S. Jeon <esjeon at hyunmu dot am>
|
||||
© 2013 Alexander Sedov <alex0player at gmail dot com>
|
||||
© 2013 Mark Edgar <medgar123 at gmail dot com>
|
||||
© 2013 Eric Pruitt <eric.pruitt at gmail dot com>
|
||||
© 2013 Michael Forney <mforney at mforney dot org>
|
||||
© 2013 Markus Teich <markus dot teich at stusta dot mhn dot de>
|
||||
© 2013-2014 Markus Teich <markus dot teich at stusta dot mhn dot de>
|
||||
© 2014 Laslo Hunhold <dev at frign dot de>
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a
|
||||
copy of this software and associated documentation files (the "Software"),
|
||||
|
2
Makefile
2
Makefile
@@ -34,7 +34,7 @@ clean:
|
||||
dist: clean
|
||||
@echo creating dist tarball
|
||||
@mkdir -p st-${VERSION}
|
||||
@cp -R LICENSE Makefile README config.mk config.def.h st.info st.1 ${SRC} st-${VERSION}
|
||||
@cp -R LICENSE Makefile README config.mk config.def.h st.info st.1 arg.h ${SRC} st-${VERSION}
|
||||
@tar -cf st-${VERSION}.tar st-${VERSION}
|
||||
@gzip st-${VERSION}.tar
|
||||
@rm -rf st-${VERSION}
|
||||
|
2
README
2
README
@@ -1,6 +1,6 @@
|
||||
st - simple terminal
|
||||
--------------------
|
||||
st is a simple virtual terminal emulator for X which sucks less.
|
||||
st is a simple terminal emulator for X which sucks less.
|
||||
|
||||
|
||||
Requirements
|
||||
|
3
TODO
3
TODO
@@ -11,13 +11,14 @@ code & interface
|
||||
drawing
|
||||
-------
|
||||
* add diacritics support to xdraws()
|
||||
* switch to a suckless font drawing library
|
||||
* make the font cache simpler
|
||||
* add better support for brightening of the upper colors
|
||||
|
||||
bugs
|
||||
----
|
||||
|
||||
* fix shift up/down (shift selection in emacs)
|
||||
* fix -e handling
|
||||
* remove DEC test sequence when appropriate
|
||||
|
||||
misc
|
||||
|
33
config.def.h
33
config.def.h
@@ -8,10 +8,15 @@
|
||||
static char font[] = "Liberation Mono:pixelsize=12:antialias=false:autohint=false";
|
||||
static int borderpx = 2;
|
||||
static char shell[] = "/bin/sh";
|
||||
static char *utmp = NULL;
|
||||
static char stty_args[] = "stty raw -echo -iexten echonl";
|
||||
|
||||
/* Kerning / character bounding-box mutlipliers */
|
||||
float cwscale = 1.0;
|
||||
float chscale = 1.0;
|
||||
/* identification sequence returned in DA and DECID */
|
||||
static char vtiden[] = "\033[?6c";
|
||||
|
||||
/* Kerning / character bounding-box multipliers */
|
||||
static float cwscale = 1.0;
|
||||
static float chscale = 1.0;
|
||||
|
||||
/*
|
||||
* word delimiter string
|
||||
@@ -37,6 +42,11 @@ static unsigned int actionfps = 30;
|
||||
*/
|
||||
static unsigned int blinktimeout = 800;
|
||||
|
||||
/*
|
||||
* thickness of underline and bar cursors
|
||||
*/
|
||||
static unsigned int cursorthickness = 2;
|
||||
|
||||
/*
|
||||
* bell volume. It must be a value between -100 and 100. Use 0 for disabling
|
||||
* it
|
||||
@@ -110,10 +120,13 @@ static Shortcut shortcuts[] = {
|
||||
{ ControlMask, XK_Print, toggleprinter, {.i = 0} },
|
||||
{ ShiftMask, XK_Print, printscreen, {.i = 0} },
|
||||
{ XK_ANY_MOD, XK_Print, printsel, {.i = 0} },
|
||||
{ MODKEY|ShiftMask, XK_Prior, xzoom, {.i = +1} },
|
||||
{ MODKEY|ShiftMask, XK_Next, xzoom, {.i = -1} },
|
||||
{ MODKEY|ShiftMask, XK_Prior, xzoom, {.f = +1} },
|
||||
{ MODKEY|ShiftMask, XK_Next, xzoom, {.f = -1} },
|
||||
{ MODKEY|ShiftMask, XK_Home, xzoomreset, {.f = 0} },
|
||||
{ ShiftMask, XK_Insert, selpaste, {.i = 0} },
|
||||
{ MODKEY|ShiftMask, XK_Insert, clippaste, {.i = 0} },
|
||||
{ MODKEY|ShiftMask, XK_C, clipcopy, {.i = 0} },
|
||||
{ MODKEY|ShiftMask, XK_V, clippaste, {.i = 0} },
|
||||
{ MODKEY, XK_Num_Lock, numlock, {.i = 0} },
|
||||
};
|
||||
|
||||
@@ -137,7 +150,7 @@ static Shortcut shortcuts[] = {
|
||||
* * > 0: crlf mode is enabled
|
||||
* * < 0: crlf mode is disabled
|
||||
*
|
||||
* Be careful with the order of the definitons because st searchs in
|
||||
* Be careful with the order of the definitions because st searches in
|
||||
* this table sequentially, so any XK_ANY_MOD must be in the last
|
||||
* position for a key.
|
||||
*/
|
||||
@@ -154,6 +167,11 @@ static KeySym mappedkeys[] = { -1 };
|
||||
*/
|
||||
static uint ignoremod = Mod2Mask|XK_SWITCH_MOD;
|
||||
|
||||
/* Override mouse-select while mask is active (when MODE_MOUSE is set).
|
||||
* Note that if you want to use ShiftMask with selmasks, set this to an other
|
||||
* modifier, set to 0 to not use it. */
|
||||
static uint forceselmod = ShiftMask;
|
||||
|
||||
static Key key[] = {
|
||||
/* keysym mask string appkey appcursor crlf */
|
||||
{ XK_KP_Home, ShiftMask, "\033[2J", 0, -1, 0},
|
||||
@@ -212,7 +230,6 @@ static Key key[] = {
|
||||
{ XK_KP_7, XK_ANY_MOD, "\033Ow", +2, 0, 0},
|
||||
{ XK_KP_8, XK_ANY_MOD, "\033Ox", +2, 0, 0},
|
||||
{ XK_KP_9, XK_ANY_MOD, "\033Oy", +2, 0, 0},
|
||||
{ XK_BackSpace, XK_NO_MOD, "\177", 0, 0, 0},
|
||||
{ XK_Up, ShiftMask, "\033[1;2A", 0, 0, 0},
|
||||
{ XK_Up, ControlMask, "\033[1;5A", 0, 0, 0},
|
||||
{ XK_Up, Mod1Mask, "\033[1;3A", 0, 0, 0},
|
||||
@@ -250,6 +267,7 @@ static Key key[] = {
|
||||
{ XK_Delete, ShiftMask, "\033[3;2~", +1, 0, 0},
|
||||
{ XK_Delete, XK_ANY_MOD, "\033[P", -1, 0, 0},
|
||||
{ XK_Delete, XK_ANY_MOD, "\033[3~", +1, 0, 0},
|
||||
{ XK_BackSpace, XK_NO_MOD, "\177", 0, 0, 0},
|
||||
{ XK_Home, ShiftMask, "\033[2J", 0, -1, 0},
|
||||
{ XK_Home, ShiftMask, "\033[1;2H", 0, +1, 0},
|
||||
{ XK_Home, XK_ANY_MOD, "\033[H", 0, -1, 0},
|
||||
@@ -360,7 +378,6 @@ static Key key[] = {
|
||||
* ButtonRelease and MotionNotify.
|
||||
* If no match is found, regular selection is used.
|
||||
*/
|
||||
|
||||
static uint selmasks[] = {
|
||||
[SEL_RECTANGULAR] = Mod1Mask,
|
||||
};
|
||||
|
@@ -1,5 +1,5 @@
|
||||
# st version
|
||||
VERSION = 0.5
|
||||
VERSION = 0.6
|
||||
|
||||
# Customize below to fit your system
|
||||
|
||||
@@ -14,15 +14,15 @@ X11LIB = /usr/X11R6/lib
|
||||
INCS = -I. -I/usr/include -I${X11INC} \
|
||||
`pkg-config --cflags fontconfig` \
|
||||
`pkg-config --cflags freetype2`
|
||||
LIBS = -L/usr/lib -lc -L${X11LIB} -lX11 -lutil -lXext -lXft \
|
||||
LIBS = -L/usr/lib -lc -L${X11LIB} -lm -lrt -lX11 -lutil -lXext -lXft \
|
||||
`pkg-config --libs fontconfig` \
|
||||
`pkg-config --libs freetype2`
|
||||
|
||||
# flags
|
||||
CPPFLAGS = -DVERSION=\"${VERSION}\" -D_BSD_SOURCE -D_XOPEN_SOURCE=600
|
||||
CPPFLAGS = -DVERSION=\"${VERSION}\" -D_XOPEN_SOURCE=600
|
||||
CFLAGS += -g -std=c99 -pedantic -Wall -Wvariadic-macros -Os ${INCS} ${CPPFLAGS}
|
||||
LDFLAGS += -g ${LIBS}
|
||||
|
||||
# compiler and linker
|
||||
CC ?= cc
|
||||
# CC = cc
|
||||
|
||||
|
83
st.1
83
st.1
@@ -10,15 +10,41 @@ st \- simple terminal
|
||||
.IR font ]
|
||||
.RB [ \-g
|
||||
.IR geometry ]
|
||||
.RB [ \-i ]
|
||||
.RB [ \-o
|
||||
.IR file ]
|
||||
.RB [ \-t
|
||||
.IR title ]
|
||||
.RB [ \-l
|
||||
.IR line ]
|
||||
.RB [ \-w
|
||||
.IR windowid ]
|
||||
.RB [ \-v ]
|
||||
.RB [ \-e
|
||||
.IR command ...]
|
||||
.RI [ commands ...]
|
||||
.PP
|
||||
.B st
|
||||
.RB [ \-a ]
|
||||
.RB [ \-c
|
||||
.IR class ]
|
||||
.RB [ \-f
|
||||
.IR font ]
|
||||
.RB [ \-g
|
||||
.IR geometry ]
|
||||
.RB [ \-i ]
|
||||
.RB [ \-o
|
||||
.IR file ]
|
||||
.RB [ \-t
|
||||
.IR title ]
|
||||
.RB [ \-l
|
||||
.IR line ]
|
||||
.RB [ \-w
|
||||
.IR windowid ]
|
||||
.RB [ \-v ]
|
||||
.RB [ \-l
|
||||
.IR line ]
|
||||
.RI [ stty_args ...]
|
||||
.SH DESCRIPTION
|
||||
.B st
|
||||
is a simple terminal emulator.
|
||||
@@ -36,14 +62,17 @@ defines the
|
||||
to use when st is run.
|
||||
.TP
|
||||
.BI \-g " geometry"
|
||||
defines the X11 geometry string, which will fixate the height and width of st.
|
||||
The form is [=][<width>{xX}<height>][{+-}<xoffset>{+-}<yoffset>]. See
|
||||
defines the X11 geometry string.
|
||||
The form is [=][<cols>{xX}<rows>][{+-}<xoffset>{+-}<yoffset>]. See
|
||||
.BR XParseGeometry (3)
|
||||
for further details.
|
||||
.TP
|
||||
.BI \-o " file"
|
||||
.B \-i
|
||||
will fixate the position given with the -g option.
|
||||
.TP
|
||||
.BI \-o " iofile"
|
||||
writes all the I/O to
|
||||
.I file.
|
||||
.I iofile.
|
||||
This feature is useful when recording st sessions. A value of "-" means
|
||||
standard output.
|
||||
.TP
|
||||
@@ -54,6 +83,11 @@ defines the window title (default 'st').
|
||||
embeds st within the window identified by
|
||||
.I windowid
|
||||
.TP
|
||||
.BI \-l " line"
|
||||
use a tty line instead of a pseudo terminal.
|
||||
When this flag is used
|
||||
remaining arguments are used as flags for stty.
|
||||
.TP
|
||||
.B \-v
|
||||
prints version information to stderr, then exits.
|
||||
.TP
|
||||
@@ -63,6 +97,43 @@ st executes
|
||||
instead of the shell. If this is used it
|
||||
.B must be the last option
|
||||
on the command line, as in xterm / rxvt.
|
||||
This option is only intended for compability,
|
||||
and all the remaining arguments are used as a command
|
||||
even without it.
|
||||
.SH SHORTCUTS
|
||||
.TP
|
||||
.B Ctrl-Print Screen
|
||||
Toggle if st should print to the
|
||||
.I iofile.
|
||||
.TP
|
||||
.B Shift-Print Screen
|
||||
Print the full screen to the
|
||||
.I iofile.
|
||||
.TP
|
||||
.B Print Screen
|
||||
Print the selection to the
|
||||
.I iofile.
|
||||
.TP
|
||||
.B Alt-Shift-Page Up
|
||||
Increase font size.
|
||||
.TP
|
||||
.B Alt-Shift-Page Down
|
||||
Decrease font size.
|
||||
.TP
|
||||
.B Alt-Shift-Home
|
||||
Reset to default font size.
|
||||
.TP
|
||||
.B Shift-Insert
|
||||
Paste from primary selection (middle mouse button).
|
||||
.TP
|
||||
.B Alt-Shift-Insert
|
||||
Paste from clipboard selection.
|
||||
.TP
|
||||
.B Alt-Shift-c
|
||||
Copy the selected text to the clipboard selection.
|
||||
.TP
|
||||
.B Alt-Shift-v
|
||||
Paste from the clipboard selection.
|
||||
.SH CUSTOMIZATION
|
||||
.B st
|
||||
can be customized by creating a custom config.h and (re)compiling the source
|
||||
@@ -72,7 +143,9 @@ See the LICENSE file for the authors.
|
||||
.SH LICENSE
|
||||
See the LICENSE file for the terms of redistribution.
|
||||
.SH SEE ALSO
|
||||
.BR tabbed (1)
|
||||
.BR tabbed (1),
|
||||
.BR utmp (1),
|
||||
.BR stty (1)
|
||||
.SH BUGS
|
||||
See the TODO file in the distribution.
|
||||
|
||||
|
4
st.info
4
st.info
@@ -32,7 +32,7 @@ st| simpleterm,
|
||||
el=\E[K,
|
||||
el1=\E[1K,
|
||||
enacs=\E)0,
|
||||
flash=\E[?5h\E[?5l,
|
||||
flash=\E[?5h$<80/>\E[?5l,
|
||||
fsl=^G,
|
||||
home=\E[H,
|
||||
hpa=\E[%i%p1%dG,
|
||||
@@ -150,6 +150,7 @@ st| simpleterm,
|
||||
mir,
|
||||
msgr,
|
||||
ncv#3,
|
||||
npc,
|
||||
op=\E[39;49m,
|
||||
pairs#64,
|
||||
mc0=\E[i,
|
||||
@@ -183,7 +184,6 @@ st| simpleterm,
|
||||
smul=\E[4m,
|
||||
tbc=\E[3g,
|
||||
tsl=\E]0;,
|
||||
ul,
|
||||
xenl,
|
||||
vpa=\E[%i%p1%dd,
|
||||
|
||||
|
Reference in New Issue
Block a user