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 |
18
FAQ
18
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:
|
||||
@ -92,16 +92,20 @@ Putting these lines into your .zshrc will fix the problems.
|
||||
|
||||
## 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