mirror of
git://git.suckless.org/st
synced 2025-08-03 13:42:28 -07:00
Compare commits
110 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 |
24
FAQ
24
FAQ
@@ -51,7 +51,7 @@ solution for them is to use the following command:
|
||||
$ 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
|
||||
manpage about this issue:
|
||||
@@ -86,22 +86,26 @@ Putting these lines into your .zshrc will fix the problems.
|
||||
|
||||
## 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.
|
||||
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 of librt, despite it begin mandatory in POSIX
|
||||
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.
|
||||
|
||||
## Backspace key does not work
|
||||
## 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>:
|
||||
<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
|
||||
@@ -155,3 +159,9 @@ This is an issue that was discussed in suckless mailing list
|
||||
[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
|
||||
|
||||
|
4
LICENSE
4
LICENSE
@@ -2,8 +2,8 @@ MIT/X Consortium License
|
||||
|
||||
© 2009-2012 Aurélien APTEL <aurelien dot aptel at gmail dot com>
|
||||
© 2009 Anselm R Garbe <garbeam at gmail dot com>
|
||||
© 2012-2014 Roberto E. Vargas Caballero <k0ga at shike2 dot com>
|
||||
© 2012-2014 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>
|
||||
|
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
TODO
2
TODO
@@ -11,6 +11,7 @@ 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
|
||||
|
||||
@@ -18,7 +19,6 @@ bugs
|
||||
----
|
||||
|
||||
* fix shift up/down (shift selection in emacs)
|
||||
* fix -e handling
|
||||
* remove DEC test sequence when appropriate
|
||||
|
||||
misc
|
||||
|
18
config.def.h
18
config.def.h
@@ -9,6 +9,7 @@ static char font[] = "Liberation Mono:pixelsize=12:antialias=false:autohint=fals
|
||||
static int borderpx = 2;
|
||||
static char shell[] = "/bin/sh";
|
||||
static char *utmp = NULL;
|
||||
static char stty_args[] = "stty raw -echo -iexten echonl";
|
||||
|
||||
/* identification sequence returned in DA and DECID */
|
||||
static char vtiden[] = "\033[?6c";
|
||||
@@ -41,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
|
||||
@@ -114,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} },
|
||||
};
|
||||
|
||||
@@ -202,7 +211,7 @@ static Key key[] = {
|
||||
{ XK_KP_Delete, ShiftMask, "\033[2K", -1, 0, 0},
|
||||
{ XK_KP_Delete, ShiftMask, "\033[3;2~", +1, 0, 0},
|
||||
{ XK_KP_Delete, XK_ANY_MOD, "\033[P", -1, 0, 0},
|
||||
{ XK_KP_Delete, XK_ANY_MOD, "\177", +1, 0, 0},
|
||||
{ XK_KP_Delete, XK_ANY_MOD, "\033[3~", +1, 0, 0},
|
||||
{ XK_KP_Multiply, XK_ANY_MOD, "\033Oj", +2, 0, 0},
|
||||
{ XK_KP_Add, XK_ANY_MOD, "\033Ok", +2, 0, 0},
|
||||
{ XK_KP_Enter, XK_ANY_MOD, "\033OM", +2, 0, 0},
|
||||
@@ -257,7 +266,8 @@ static Key key[] = {
|
||||
{ XK_Delete, ShiftMask, "\033[2K", -1, 0, 0},
|
||||
{ XK_Delete, ShiftMask, "\033[3;2~", +1, 0, 0},
|
||||
{ XK_Delete, XK_ANY_MOD, "\033[P", -1, 0, 0},
|
||||
{ XK_Delete, XK_ANY_MOD, "\177", +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},
|
||||
|
@@ -1,5 +1,5 @@
|
||||
# st version
|
||||
VERSION = 0.5
|
||||
VERSION = 0.6
|
||||
|
||||
# Customize below to fit your system
|
||||
|
||||
@@ -19,10 +19,10 @@ LIBS = -L/usr/lib -lc -L${X11LIB} -lm -lrt -lX11 -lutil -lXext -lXft \
|
||||
`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
|
||||
|
||||
|
75
st.1
75
st.1
@@ -15,11 +15,36 @@ st \- simple terminal
|
||||
.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.
|
||||
@@ -45,9 +70,9 @@ for further details.
|
||||
.B \-i
|
||||
will fixate the position given with the -g option.
|
||||
.TP
|
||||
.BI \-o " file"
|
||||
.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
|
||||
@@ -58,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
|
||||
@@ -67,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
|
||||
@@ -76,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.
|
||||
|
||||
|
7
st.info
7
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,
|
||||
@@ -53,7 +53,7 @@ st| simpleterm,
|
||||
ka3=\E[5~,
|
||||
kc1=\E[4~,
|
||||
kc3=\E[6~,
|
||||
kbs=\010,
|
||||
kbs=\177,
|
||||
kcbt=\E[Z,
|
||||
kb2=\EOu,
|
||||
kcub1=\EOD,
|
||||
@@ -73,7 +73,7 @@ st| simpleterm,
|
||||
kri=\E[1;2A,
|
||||
kclr=\E[3;5~,
|
||||
kdl1=\E[3;2~,
|
||||
kdch1=\0177,
|
||||
kdch1=\E[3~,
|
||||
kich1=\E[2~,
|
||||
kend=\E[4~,
|
||||
kf1=\EOP,
|
||||
@@ -150,6 +150,7 @@ st| simpleterm,
|
||||
mir,
|
||||
msgr,
|
||||
ncv#3,
|
||||
npc,
|
||||
op=\E[39;49m,
|
||||
pairs#64,
|
||||
mc0=\E[i,
|
||||
|
Reference in New Issue
Block a user