commit
790e6f407f
15 changed files with 6108 additions and 0 deletions
@ -0,0 +1,195 @@ |
|||
## Why does st not handle utmp entries? |
|||
|
|||
Use the excellent tool of [utmp](https://git.suckless.org/utmp/) for this task. |
|||
|
|||
## Some _random program_ complains that st is unknown/not recognised/unsupported/whatever! |
|||
|
|||
It means that st doesn’t have any terminfo entry on your system. Chances are |
|||
you did not `make install`. If you just want to test it without installing it, |
|||
you can manually run `tic -sx st.info`. |
|||
|
|||
## Nothing works, and nothing is said about an unknown terminal! |
|||
|
|||
* Some programs just assume they’re running in xterm i.e. they don’t rely on |
|||
terminfo. What you see is the current state of the “xterm compliance”. |
|||
* Some programs don’t complain about the lacking st description and default to |
|||
another terminal. In that case see the question about terminfo. |
|||
|
|||
## How do I scroll back up? |
|||
|
|||
Using a terminal multiplexer. |
|||
|
|||
* `st -e tmux` using C-b [ |
|||
* `st -e screen` using C-a ESC |
|||
|
|||
## Why doesn't the Del key work in some programs? |
|||
|
|||
Taken from the terminfo manpage: |
|||
|
|||
If the terminal has a keypad that transmits codes when the keys |
|||
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, 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 send these |
|||
sequences. |
|||
|
|||
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 |
|||
|
|||
or |
|||
$ tput smkx |
|||
|
|||
In the case of bash, readline is used. Readline has a different note in its |
|||
manpage about this issue: |
|||
|
|||
enable-keypad (Off) |
|||
When set to On, readline will try to enable the |
|||
application keypad when it is called. Some systems |
|||
need this to enable arrow keys. |
|||
|
|||
Adding this option to your .inputrc will fix the keypad problem for all |
|||
applications using readline. |
|||
|
|||
If you are using zsh, then read the zsh FAQ |
|||
<http://zsh.sourceforge.net/FAQ/zshfaq03.html#l25>: |
|||
|
|||
It should be noted that the O / [ confusion can occur with other keys |
|||
such as Home and End. Some systems let you query the key sequences |
|||
sent by these keys from the system's terminal database, terminfo. |
|||
Unfortunately, the key sequences given there typically apply to the |
|||
mode that is not the one zsh uses by default (it's the "application" |
|||
mode rather than the "raw" mode). Explaining the use of terminfo is |
|||
outside of the scope of this FAQ, but if you wish to use the key |
|||
sequences given there you can tell the line editor to turn on |
|||
"application" mode when it starts and turn it off when it stops: |
|||
|
|||
function zle-line-init () { echoti smkx } |
|||
function zle-line-finish () { echoti rmkx } |
|||
zle -N zle-line-init |
|||
zle -N zle-line-finish |
|||
|
|||
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. |
|||
|
|||
## 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 |
|||
<https://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] https://st.suckless.org/patches/delkey |
|||
|
|||
## Why do images not work in st (in programs such as w3m)? |
|||
|
|||
This is a terrible hack that overdraws an image on top of the terminal emulator |
|||
window. It also relies on a very specific way the terminal draws it's contents. |
|||
|
|||
A more proper (but limited way) would be using sixels. Which st doesn't |
|||
support. |
|||
|
|||
## BadLength X error in Xft when trying to render emoji |
|||
|
|||
Xft makes st crash when rendering color emojis with the following error: |
|||
|
|||
"X Error of failed request: BadLength (poly request too large or internal Xlib length error)" |
|||
Major opcode of failed request: 139 (RENDER) |
|||
Minor opcode of failed request: 20 (RenderAddGlyphs) |
|||
Serial number of failed request: 1595 |
|||
Current serial number in output stream: 1818" |
|||
|
|||
This is a known bug in Xft (not st) which happens on some platforms and |
|||
combination of particular fonts and fontconfig settings. |
|||
|
|||
See also: |
|||
https://gitlab.freedesktop.org/xorg/lib/libxft/issues/6 |
|||
https://bugs.freedesktop.org/show_bug.cgi?id=107534 |
|||
https://bugzilla.redhat.com/show_bug.cgi?id=1498269 |
|||
|
|||
The solution is to remove color emoji fonts or disable this in the fontconfig |
|||
XML configuration. As an ugly workaround (which may work only on newer |
|||
fontconfig versions (FC_COLOR)), the following code can be used to mask color |
|||
fonts: |
|||
|
|||
FcPatternAddBool(fcpattern, FC_COLOR, FcFalse); |
|||
|
|||
Please don't bother reporting this bug to st, but notify the upstream Xft |
|||
developers about fixing this bug. |
@ -0,0 +1,17 @@ |
|||
A STATEMENT ON LEGACY SUPPORT |
|||
|
|||
In the terminal world there is much cruft that comes from old and unsup‐ |
|||
ported terminals that inherit incompatible modes and escape sequences |
|||
which noone is able to know, except when he/she comes from that time and |
|||
developed a graphical vt100 emulator at that time. |
|||
|
|||
One goal of st is to only support what is really needed. When you en‐ |
|||
counter a sequence which you really need, implement it. But while you |
|||
are at it, do not add the other cruft you might encounter while sneek‐ |
|||
ing at other terminal emulators. History has bloated them and there is |
|||
no real evidence that most of the sequences are used today. |
|||
|
|||
|
|||
Christoph Lohmann <20h@r-36.net> |
|||
2012-09-13T07:00:36.081271045+02:00 |
|||
|
@ -0,0 +1,34 @@ |
|||
MIT/X Consortium License |
|||
|
|||
© 2014-2018 Hiltjo Posthuma <hiltjo at codemadness dot org> |
|||
© 2018 Devin J. Pohly <djpohly at gmail dot com> |
|||
© 2014-2017 Quentin Rameau <quinq at fifth dot space> |
|||
© 2009-2012 Aurélien APTEL <aurelien dot aptel at gmail dot com> |
|||
© 2008-2017 Anselm R Garbe <garbeam at gmail dot com> |
|||
© 2012-2017 Roberto E. Vargas Caballero <k0ga at shike2 dot com> |
|||
© 2012-2016 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-2014 Eric Pruitt <eric.pruitt at gmail dot com> |
|||
© 2013 Michael Forney <mforney at mforney dot org> |
|||
© 2013-2014 Markus Teich <markus dot teich at stusta dot mhn dot de> |
|||
© 2014-2015 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"), |
|||
to deal in the Software without restriction, including without limitation |
|||
the rights to use, copy, modify, merge, publish, distribute, sublicense, |
|||
and/or sell copies of the Software, and to permit persons to whom the |
|||
Software is furnished to do so, subject to the following conditions: |
|||
|
|||
The above copyright notice and this permission notice shall be included in |
|||
all copies or substantial portions of the Software. |
|||
|
|||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
|||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
|||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
|||
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
|||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
|||
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
|||
DEALINGS IN THE SOFTWARE. |
@ -0,0 +1,57 @@ |
|||
# st - simple terminal
|
|||
# See LICENSE file for copyright and license details.
|
|||
.POSIX: |
|||
|
|||
include config.mk |
|||
|
|||
SRC = st.c x.c |
|||
OBJ = $(SRC:.c=.o) |
|||
|
|||
all: options st |
|||
|
|||
options: |
|||
@echo st build options: |
|||
@echo "CFLAGS = $(STCFLAGS)" |
|||
@echo "LDFLAGS = $(STLDFLAGS)" |
|||
@echo "CC = $(CC)" |
|||
|
|||
config.h: |
|||
cp config.def.h config.h |
|||
|
|||
.c.o: |
|||
$(CC) $(STCFLAGS) -c $< |
|||
|
|||
st.o: config.h st.h win.h |
|||
x.o: arg.h config.h st.h win.h |
|||
|
|||
$(OBJ): config.h config.mk |
|||
|
|||
st: $(OBJ) |
|||
$(CC) -o $@ $(OBJ) $(STLDFLAGS) |
|||
|
|||
clean: |
|||
rm -f st $(OBJ) st-$(VERSION).tar.gz |
|||
|
|||
dist: clean |
|||
mkdir -p st-$(VERSION) |
|||
cp -R FAQ LEGACY TODO LICENSE Makefile README config.mk\
|
|||
config.def.h st.info st.1 arg.h st.h win.h $(SRC)\
|
|||
st-$(VERSION) |
|||
tar -cf - st-$(VERSION) | gzip > st-$(VERSION).tar.gz |
|||
rm -rf st-$(VERSION) |
|||
|
|||
install: st |
|||
mkdir -p $(DESTDIR)$(PREFIX)/bin |
|||
cp -f st $(DESTDIR)$(PREFIX)/bin |
|||
chmod 755 $(DESTDIR)$(PREFIX)/bin/st |
|||
mkdir -p $(DESTDIR)$(MANPREFIX)/man1 |
|||
sed "s/VERSION/$(VERSION)/g" < st.1 > $(DESTDIR)$(MANPREFIX)/man1/st.1 |
|||
chmod 644 $(DESTDIR)$(MANPREFIX)/man1/st.1 |
|||
tic -sx st.info |
|||
@echo Please see the README file regarding the terminfo entry of st. |
|||
|
|||
uninstall: |
|||
rm -f $(DESTDIR)$(PREFIX)/bin/st |
|||
rm -f $(DESTDIR)$(MANPREFIX)/man1/st.1 |
|||
|
|||
.PHONY: all options clean dist install uninstall |
@ -0,0 +1,34 @@ |
|||
st - simple terminal |
|||
-------------------- |
|||
st is a simple terminal emulator for X which sucks less. |
|||
|
|||
|
|||
Requirements |
|||
------------ |
|||
In order to build st you need the Xlib header files. |
|||
|
|||
|
|||
Installation |
|||
------------ |
|||
Edit config.mk to match your local setup (st is installed into |
|||
the /usr/local namespace by default). |
|||
|
|||
Afterwards enter the following command to build and install st (if |
|||
necessary as root): |
|||
|
|||
make clean install |
|||
|
|||
|
|||
Running st |
|||
---------- |
|||
If you did not install st with make clean install, you must compile |
|||
the st terminfo entry with the following command: |
|||
|
|||
tic -sx st.info |
|||
|
|||
See the man page for additional details. |
|||
|
|||
Credits |
|||
------- |
|||
Based on Aurélien APTEL <aurelien dot aptel at gmail dot com> bt source code. |
|||
|
@ -0,0 +1,28 @@ |
|||
vt emulation |
|||
------------ |
|||
|
|||
* double-height support |
|||
|
|||
code & interface |
|||
---------------- |
|||
|
|||
* add a simple way to do multiplexing |
|||
|
|||
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) |
|||
* remove DEC test sequence when appropriate |
|||
|
|||
misc |
|||
---- |
|||
|
|||
$ grep -nE 'XXX|TODO' st.c |
|||
|
@ -0,0 +1,50 @@ |
|||
/*
|
|||
* Copy me if you can. |
|||
* by 20h |
|||
*/ |
|||
|
|||
#ifndef ARG_H__ |
|||
#define ARG_H__ |
|||
|
|||
extern char *argv0; |
|||
|
|||
/* use main(int argc, char *argv[]) */ |
|||
#define ARGBEGIN for (argv0 = *argv, argv++, argc--;\ |
|||
argv[0] && argv[0][0] == '-'\ |
|||
&& argv[0][1];\ |
|||
argc--, argv++) {\ |
|||
char argc_;\ |
|||
char **argv_;\ |
|||
int brk_;\ |
|||
if (argv[0][1] == '-' && argv[0][2] == '\0') {\ |
|||
argv++;\ |
|||
argc--;\ |
|||
break;\ |
|||
}\ |
|||
int i_;\ |
|||
for (i_ = 1, brk_ = 0, argv_ = argv;\ |
|||
argv[0][i_] && !brk_;\ |
|||
i_++) {\ |
|||
if (argv_ != argv)\ |
|||
break;\ |
|||
argc_ = argv[0][i_];\ |
|||
switch (argc_) |
|||
|
|||
#define ARGEND }\ |
|||
} |
|||
|
|||
#define ARGC() argc_ |
|||
|
|||
#define EARGF(x) ((argv[0][i_+1] == '\0' && argv[1] == NULL)?\ |
|||
((x), abort(), (char *)0) :\ |
|||
(brk_ = 1, (argv[0][i_+1] != '\0')?\ |
|||
(&argv[0][i_+1]) :\ |
|||
(argc--, argv++, argv[0]))) |
|||
|
|||
#define ARGF() ((argv[0][i_+1] == '\0' && argv[1] == NULL)?\ |
|||
(char *)0 :\ |
|||
(brk_ = 1, (argv[0][i_+1] != '\0')?\ |
|||
(&argv[0][i_+1]) :\ |
|||
(argc--, argv++, argv[0]))) |
|||
|
|||
#endif |
@ -0,0 +1,459 @@ |
|||
/* See LICENSE file for copyright and license details. */ |
|||
|
|||
/*
|
|||
* appearance |
|||
* |
|||
* font: see http://freedesktop.org/software/fontconfig/fontconfig-user.html
|
|||
*/ |
|||
static char *font = "Liberation Mono:pixelsize=12:antialias=true:autohint=true"; |
|||
static int borderpx = 2; |
|||
|
|||
/*
|
|||
* What program is execed by st depends of these precedence rules: |
|||
* 1: program passed with -e |
|||
* 2: utmp option |
|||
* 3: SHELL environment variable |
|||
* 4: value of shell in /etc/passwd |
|||
* 5: value of shell in config.h |
|||
*/ |
|||
static char *shell = "/bin/sh"; |
|||
char *utmp = NULL; |
|||
char *stty_args = "stty raw pass8 nl -echo -iexten -cstopb 38400"; |
|||
|
|||
/* identification sequence returned in DA and DECID */ |
|||
char *vtiden = "\033[?6c"; |
|||
|
|||
/* Kerning / character bounding-box multipliers */ |
|||
static float cwscale = 1.0; |
|||
static float chscale = 1.0; |
|||
|
|||
/*
|
|||
* word delimiter string |
|||
* |
|||
* More advanced example: L" `'\"()[]{}" |
|||
*/ |
|||
wchar_t *worddelimiters = L" "; |
|||
|
|||
/* selection timeouts (in milliseconds) */ |
|||
static unsigned int doubleclicktimeout = 300; |
|||
static unsigned int tripleclicktimeout = 600; |
|||
|
|||
/* alt screens */ |
|||
int allowaltscreen = 1; |
|||
|
|||
/* frames per second st should at maximum draw to the screen */ |
|||
static unsigned int xfps = 120; |
|||
static unsigned int actionfps = 30; |
|||
|
|||
/*
|
|||
* blinking timeout (set to 0 to disable blinking) for the terminal blinking |
|||
* attribute. |
|||
*/ |
|||
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 |
|||
*/ |
|||
static int bellvolume = 0; |
|||
|
|||
/* default TERM value */ |
|||
char *termname = "st-256color"; |
|||
|
|||
/*
|
|||
* spaces per tab |
|||
* |
|||
* When you are changing this value, don't forget to adapt the »it« value in |
|||
* the st.info and appropriately install the st.info in the environment where |
|||
* you use this st version. |
|||
* |
|||
* it#$tabspaces, |
|||
* |
|||
* Secondly make sure your kernel is not expanding tabs. When running `stty |
|||
* -a` »tab0« should appear. You can tell the terminal to not expand tabs by |
|||
* running following command: |
|||
* |
|||
* stty tabs |
|||
*/ |
|||
unsigned int tabspaces = 8; |
|||
|
|||
/* Terminal colors (16 first used in escape sequence) */ |
|||
static const char *colorname[] = { |
|||
/* 8 normal colors */ |
|||
"black", |
|||
"red3", |
|||
"green3", |
|||
"yellow3", |
|||
"blue2", |
|||
"magenta3", |
|||
"cyan3", |
|||
"gray90", |
|||
|
|||
/* 8 bright colors */ |
|||
"gray50", |
|||
"red", |
|||
"green", |
|||
"yellow", |
|||
"#5c5cff", |
|||
"magenta", |
|||
"cyan", |
|||
"white", |
|||
|
|||
[255] = 0, |
|||
|
|||
/* more colors can be added after 255 to use with DefaultXX */ |
|||
"#cccccc", |
|||
"#555555", |
|||
}; |
|||
|
|||
|
|||
/*
|
|||
* Default colors (colorname index) |
|||
* foreground, background, cursor, reverse cursor |
|||
*/ |
|||
unsigned int defaultfg = 7; |
|||
unsigned int defaultbg = 0; |
|||
static unsigned int defaultcs = 256; |
|||
static unsigned int defaultrcs = 257; |
|||
|
|||
/*
|
|||
* Default shape of cursor |
|||
* 2: Block ("█") |
|||
* 4: Underline ("_") |
|||
* 6: Bar ("|") |
|||
* 7: Snowman ("☃") |
|||
*/ |
|||
static unsigned int cursorshape = 2; |
|||
|
|||
/*
|
|||
* Default columns and rows numbers |
|||
*/ |
|||
|
|||
static unsigned int cols = 80; |
|||
static unsigned int rows = 24; |
|||
|
|||
/*
|
|||
* Default colour and shape of the mouse cursor |
|||
*/ |
|||
static unsigned int mouseshape = XC_xterm; |
|||
static unsigned int mousefg = 7; |
|||
static unsigned int mousebg = 0; |
|||
|
|||
/*
|
|||
* Color used to display font attributes when fontconfig selected a font which |
|||
* doesn't match the ones requested. |
|||
*/ |
|||
static unsigned int defaultattr = 11; |
|||
|
|||
/*
|
|||
* Force mouse select/shortcuts 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 forcemousemod = ShiftMask; |
|||
|
|||
/*
|
|||
* Internal mouse shortcuts. |
|||
* Beware that overloading Button1 will disable the selection. |
|||
*/ |
|||
static MouseShortcut mshortcuts[] = { |
|||
/* mask button function argument release */ |
|||
{ XK_ANY_MOD, Button2, selpaste, {.i = 0}, 1 }, |
|||
{ XK_ANY_MOD, Button4, ttysend, {.s = "\031"} }, |
|||
{ XK_ANY_MOD, Button5, ttysend, {.s = "\005"} }, |
|||
}; |
|||
|
|||
/* Internal keyboard shortcuts. */ |
|||
#define MODKEY Mod1Mask |
|||
#define TERMMOD (ControlMask|ShiftMask) |
|||
|
|||
static Shortcut shortcuts[] = { |
|||
/* mask keysym function argument */ |
|||
{ XK_ANY_MOD, XK_Break, sendbreak, {.i = 0} }, |
|||
{ ControlMask, XK_Print, toggleprinter, {.i = 0} }, |
|||
{ ShiftMask, XK_Print, printscreen, {.i = 0} }, |
|||
{ XK_ANY_MOD, XK_Print, printsel, {.i = 0} }, |
|||
{ TERMMOD, XK_Prior, zoom, {.f = +1} }, |
|||
{ TERMMOD, XK_Next, zoom, {.f = -1} }, |
|||
{ TERMMOD, XK_Home, zoomreset, {.f = 0} }, |
|||
{ TERMMOD, XK_C, clipcopy, {.i = 0} }, |
|||
{ TERMMOD, XK_V, clippaste, {.i = 0} }, |
|||
{ TERMMOD, XK_Y, selpaste, {.i = 0} }, |
|||
{ ShiftMask, XK_Insert, selpaste, {.i = 0} }, |
|||
{ TERMMOD, XK_Num_Lock, numlock, {.i = 0} }, |
|||
}; |
|||
|
|||
/*
|
|||
* Special keys (change & recompile st.info accordingly) |
|||
* |
|||
* Mask value: |
|||
* * Use XK_ANY_MOD to match the key no matter modifiers state |
|||
* * Use XK_NO_MOD to match the key alone (no modifiers) |
|||
* appkey value: |
|||
* * 0: no value |
|||
* * > 0: keypad application mode enabled |
|||
* * = 2: term.numlock = 1 |
|||
* * < 0: keypad application mode disabled |
|||
* appcursor value: |
|||
* * 0: no value |
|||
* * > 0: cursor application mode enabled |
|||
* * < 0: cursor application mode disabled |
|||
* |
|||
* 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. |
|||
*/ |
|||
|
|||
/*
|
|||
* If you want keys other than the X11 function keys (0xFD00 - 0xFFFF) |
|||
* to be mapped below, add them to this array. |
|||
*/ |
|||
static KeySym mappedkeys[] = { -1 }; |
|||
|
|||
/*
|
|||
* State bits to ignore when matching key or button events. By default, |
|||
* numlock (Mod2Mask) and keyboard layout (XK_SWITCH_MOD) are ignored. |
|||
*/ |
|||
static uint ignoremod = Mod2Mask|XK_SWITCH_MOD; |
|||
|
|||
/*
|
|||
* This is the huge key array which defines all compatibility to the Linux |
|||
* world. Please decide about changes wisely. |
|||
*/ |
|||
static Key key[] = { |
|||
/* keysym mask string appkey appcursor */ |
|||
{ XK_KP_Home, ShiftMask, "\033[2J", 0, -1}, |
|||
{ XK_KP_Home, ShiftMask, "\033[1;2H", 0, +1}, |
|||
{ XK_KP_Home, XK_ANY_MOD, "\033[H", 0, -1}, |
|||
{ XK_KP_Home, XK_ANY_MOD, "\033[1~", 0, +1}, |
|||
{ XK_KP_Up, XK_ANY_MOD, "\033Ox", +1, 0}, |
|||
{ XK_KP_Up, XK_ANY_MOD, "\033[A", 0, -1}, |
|||
{ XK_KP_Up, XK_ANY_MOD, "\033OA", 0, +1}, |
|||
{ XK_KP_Down, XK_ANY_MOD, "\033Or", +1, 0}, |
|||
{ XK_KP_Down, XK_ANY_MOD, "\033[B", 0, -1}, |
|||
{ XK_KP_Down, XK_ANY_MOD, "\033OB", 0, +1}, |
|||
{ XK_KP_Left, XK_ANY_MOD, "\033Ot", +1, 0}, |
|||
{ XK_KP_Left, XK_ANY_MOD, "\033[D", 0, -1}, |
|||
{ XK_KP_Left, XK_ANY_MOD, "\033OD", 0, +1}, |
|||
{ XK_KP_Right, XK_ANY_MOD, "\033Ov", +1, 0}, |
|||
{ XK_KP_Right, XK_ANY_MOD, "\033[C", 0, -1}, |
|||
{ XK_KP_Right, XK_ANY_MOD, "\033OC", 0, +1}, |
|||
{ XK_KP_Prior, ShiftMask, "\033[5;2~", 0, 0}, |
|||
{ XK_KP_Prior, XK_ANY_MOD, "\033[5~", 0, 0}, |
|||
{ XK_KP_Begin, XK_ANY_MOD, "\033[E", 0, 0}, |
|||
{ XK_KP_End, ControlMask, "\033[J", -1, 0}, |
|||
{ XK_KP_End, ControlMask, "\033[1;5F", +1, 0}, |
|||
{ XK_KP_End, ShiftMask, "\033[K", -1, 0}, |
|||
{ XK_KP_End, ShiftMask, "\033[1;2F", +1, 0}, |
|||
{ XK_KP_End, XK_ANY_MOD, "\033[4~", 0, 0}, |
|||
{ XK_KP_Next, ShiftMask, "\033[6;2~", 0, 0}, |
|||
{ XK_KP_Next, XK_ANY_MOD, "\033[6~", 0, 0}, |
|||
{ XK_KP_Insert, ShiftMask, "\033[2;2~", +1, 0}, |
|||
{ XK_KP_Insert, ShiftMask, "\033[4l", -1, 0}, |
|||
{ XK_KP_Insert, ControlMask, "\033[L", -1, 0}, |
|||
{ XK_KP_Insert, ControlMask, "\033[2;5~", +1, 0}, |
|||
{ XK_KP_Insert, XK_ANY_MOD, "\033[4h", -1, 0}, |
|||
{ XK_KP_Insert, XK_ANY_MOD, "\033[2~", +1, 0}, |
|||
{ XK_KP_Delete, ControlMask, "\033[M", -1, 0}, |
|||
{ XK_KP_Delete, ControlMask, "\033[3;5~", +1, 0}, |
|||
{ XK_KP_Delete, ShiftMask, "\033[2K", -1, 0}, |
|||
{ XK_KP_Delete, ShiftMask, "\033[3;2~", +1, 0}, |
|||
{ XK_KP_Delete, XK_ANY_MOD, "\033[P", -1, 0}, |
|||
{ XK_KP_Delete, XK_ANY_MOD, "\033[3~", +1, 0}, |
|||
{ XK_KP_Multiply, XK_ANY_MOD, "\033Oj", +2, 0}, |
|||
{ XK_KP_Add, XK_ANY_MOD, "\033Ok", +2, 0}, |
|||
{ XK_KP_Enter, XK_ANY_MOD, "\033OM", +2, 0}, |
|||
{ XK_KP_Enter, XK_ANY_MOD, "\r", -1, 0}, |
|||
{ XK_KP_Subtract, XK_ANY_MOD, "\033Om", +2, 0}, |
|||
{ XK_KP_Decimal, XK_ANY_MOD, "\033On", +2, 0}, |
|||
{ XK_KP_Divide, XK_ANY_MOD, "\033Oo", +2, 0}, |
|||
{ XK_KP_0, XK_ANY_MOD, "\033Op", +2, 0}, |
|||
{ XK_KP_1, XK_ANY_MOD, "\033Oq", +2, 0}, |
|||
{ XK_KP_2, XK_ANY_MOD, "\033Or", +2, 0}, |
|||
{ XK_KP_3, XK_ANY_MOD, "\033Os", +2, 0}, |
|||
{ XK_KP_4, XK_ANY_MOD, "\033Ot", +2, 0}, |
|||
{ XK_KP_5, XK_ANY_MOD, "\033Ou", +2, 0}, |
|||
{ XK_KP_6, XK_ANY_MOD, "\033Ov", +2, 0}, |
|||
{ XK_KP_7, XK_ANY_MOD, "\033Ow", +2, 0}, |
|||
{ XK_KP_8, XK_ANY_MOD, "\033Ox", +2, 0}, |
|||
{ XK_KP_9, XK_ANY_MOD, "\033Oy", +2, 0}, |
|||
{ XK_Up, ShiftMask, "\033[1;2A", 0, 0}, |
|||
{ XK_Up, Mod1Mask, "\033[1;3A", 0, 0}, |
|||
{ XK_Up, ShiftMask|Mod1Mask,"\033[1;4A", 0, 0}, |
|||
{ XK_Up, ControlMask, "\033[1;5A", 0, 0}, |
|||
{ XK_Up, ShiftMask|ControlMask,"\033[1;6A", 0, 0}, |
|||
{ XK_Up, ControlMask|Mod1Mask,"\033[1;7A", 0, 0}, |
|||
{ XK_Up,ShiftMask|ControlMask|Mod1Mask,"\033[1;8A", 0, 0}, |
|||
{ XK_Up, XK_ANY_MOD, "\033[A", 0, -1}, |
|||
{ XK_Up, XK_ANY_MOD, "\033OA", 0, +1}, |
|||
{ XK_Down, ShiftMask, "\033[1;2B", 0, 0}, |
|||
{ XK_Down, Mod1Mask, "\033[1;3B", 0, 0}, |
|||
{ XK_Down, ShiftMask|Mod1Mask,"\033[1;4B", 0, 0}, |
|||
{ XK_Down, ControlMask, "\033[1;5B", 0, 0}, |
|||
{ XK_Down, ShiftMask|ControlMask,"\033[1;6B", 0, 0}, |
|||
{ XK_Down, ControlMask|Mod1Mask,"\033[1;7B", 0, 0}, |
|||
{ XK_Down,ShiftMask|ControlMask|Mod1Mask,"\033[1;8B",0, 0}, |
|||
{ XK_Down, XK_ANY_MOD, "\033[B", 0, -1}, |
|||
{ XK_Down, XK_ANY_MOD, "\033OB", 0, +1}, |
|||
{ XK_Left, ShiftMask, "\033[1;2D", 0, 0}, |
|||
{ XK_Left, Mod1Mask, "\033[1;3D", 0, 0}, |
|||
{ XK_Left, ShiftMask|Mod1Mask,"\033[1;4D", 0, 0}, |
|||
{ XK_Left, ControlMask, "\033[1;5D", 0, 0}, |
|||
{ XK_Left, ShiftMask|ControlMask,"\033[1;6D", 0, 0}, |
|||
{ XK_Left, ControlMask|Mod1Mask,"\033[1;7D", 0, 0}, |
|||
{ XK_Left,ShiftMask|ControlMask|Mod1Mask,"\033[1;8D",0, 0}, |
|||
{ XK_Left, XK_ANY_MOD, "\033[D", 0, -1}, |
|||
{ XK_Left, XK_ANY_MOD, "\033OD", 0, +1}, |
|||
{ XK_Right, ShiftMask, "\033[1;2C", 0, 0}, |
|||
{ XK_Right, Mod1Mask, "\033[1;3C", 0, 0}, |
|||
{ XK_Right, ShiftMask|Mod1Mask,"\033[1;4C", 0, 0}, |
|||
{ XK_Right, ControlMask, "\033[1;5C", 0, 0}, |
|||
{ XK_Right, ShiftMask|ControlMask,"\033[1;6C", 0, 0}, |
|||
{ XK_Right, ControlMask|Mod1Mask,"\033[1;7C", 0, 0}, |
|||
{ XK_Right,ShiftMask|ControlMask|Mod1Mask,"\033[1;8C",0, 0}, |
|||
{ XK_Right, XK_ANY_MOD, "\033[C", 0, -1}, |
|||
{ XK_Right, XK_ANY_MOD, "\033OC", 0, +1}, |
|||
{ XK_ISO_Left_Tab, ShiftMask, "\033[Z", 0, 0}, |
|||
{ XK_Return, Mod1Mask, "\033\r", 0, 0}, |
|||
{ XK_Return, XK_ANY_MOD, "\r", 0, 0}, |
|||
{ XK_Insert, ShiftMask, "\033[4l", -1, 0}, |
|||
{ XK_Insert, ShiftMask, "\033[2;2~", +1, 0}, |
|||
{ XK_Insert, ControlMask, "\033[L", -1, 0}, |
|||
{ XK_Insert, ControlMask, "\033[2;5~", +1, 0}, |
|||
{ XK_Insert, XK_ANY_MOD, "\033[4h", -1, 0}, |
|||
{ XK_Insert, XK_ANY_MOD, "\033[2~", +1, 0}, |
|||
{ XK_Delete, ControlMask, "\033[M", -1, 0}, |
|||
{ XK_Delete, ControlMask, "\033[3;5~", +1, 0}, |
|||
{ XK_Delete, ShiftMask, "\033[2K", -1, 0}, |
|||
{ XK_Delete, ShiftMask, "\033[3;2~", +1, 0}, |
|||
{ XK_Delete, XK_ANY_MOD, "\033[P", -1, 0}, |
|||
{ XK_Delete, XK_ANY_MOD, "\033[3~", +1, 0}, |
|||
{ XK_BackSpace, XK_NO_MOD, "\177", 0, 0}, |
|||
{ XK_BackSpace, Mod1Mask, "\033\177", 0, 0}, |
|||
{ XK_Home, ShiftMask, "\033[2J", 0, -1}, |
|||
{ XK_Home, ShiftMask, "\033[1;2H", 0, +1}, |
|||
{ XK_Home, XK_ANY_MOD, "\033[H", 0, -1}, |
|||
{ XK_Home, XK_ANY_MOD, "\033[1~", 0, +1}, |
|||
{ XK_End, ControlMask, "\033[J", -1, 0}, |
|||
{ XK_End, ControlMask, "\033[1;5F", +1, 0}, |
|||
{ XK_End, ShiftMask, "\033[K", -1, 0}, |
|||
{ XK_End, ShiftMask, "\033[1;2F", +1, 0}, |
|||
{ XK_End, XK_ANY_MOD, "\033[4~", 0, 0}, |
|||
{ XK_Prior, ControlMask, "\033[5;5~", 0, 0}, |
|||
{ XK_Prior, ShiftMask, "\033[5;2~", 0, 0}, |
|||
{ XK_Prior, XK_ANY_MOD, "\033[5~", 0, 0}, |
|||
{ XK_Next, ControlMask, "\033[6;5~", 0, 0}, |
|||
{ XK_Next, ShiftMask, "\033[6;2~", 0, 0}, |
|||
{ XK_Next, XK_ANY_MOD, "\033[6~", 0, 0}, |
|||
{ XK_F1, XK_NO_MOD, "\033OP" , 0, 0}, |
|||
{ XK_F1, /* F13 */ ShiftMask, "\033[1;2P", 0, 0}, |
|||
{ XK_F1, /* F25 */ ControlMask, "\033[1;5P", 0, 0}, |
|||
{ XK_F1, /* F37 */ Mod4Mask, "\033[1;6P", 0, 0}, |
|||
{ XK_F1, /* F49 */ Mod1Mask, "\033[1;3P", 0, 0}, |
|||
{ XK_F1, /* F61 */ Mod3Mask, "\033[1;4P", 0, 0}, |
|||
{ XK_F2, XK_NO_MOD, "\033OQ" , 0, 0}, |
|||
{ XK_F2, /* F14 */ ShiftMask, "\033[1;2Q", 0, 0}, |
|||
{ XK_F2, /* F26 */ ControlMask, "\033[1;5Q", 0, 0}, |
|||
{ XK_F2, /* F38 */ Mod4Mask, "\033[1;6Q", 0, 0}, |
|||
{ XK_F2, /* F50 */ Mod1Mask, "\033[1;3Q", 0, 0}, |
|||
{ XK_F2, /* F62 */ Mod3Mask, "\033[1;4Q", 0, 0}, |
|||
{ XK_F3, XK_NO_MOD, "\033OR" , 0, 0}, |
|||
{ XK_F3, /* F15 */ ShiftMask, "\033[1;2R", 0, 0}, |
|||
{ XK_F3, /* F27 */ ControlMask, "\033[1;5R", 0, 0}, |
|||
{ XK_F3, /* F39 */ Mod4Mask, "\033[1;6R", 0, 0}, |
|||
{ XK_F3, /* F51 */ Mod1Mask, "\033[1;3R", 0, 0}, |
|||
{ XK_F3, /* F63 */ Mod3Mask, "\033[1;4R", 0, 0}, |
|||
{ XK_F4, XK_NO_MOD, "\033OS" , 0, 0}, |
|||
{ XK_F4, /* F16 */ ShiftMask, "\033[1;2S", 0, 0}, |
|||
{ XK_F4, /* F28 */ ControlMask, "\033[1;5S", 0, 0}, |
|||
{ XK_F4, /* F40 */ Mod4Mask, "\033[1;6S", 0, 0}, |
|||
{ XK_F4, /* F52 */ Mod1Mask, "\033[1;3S", 0, 0}, |
|||
{ XK_F5, XK_NO_MOD, "\033[15~", 0, 0}, |
|||
{ XK_F5, /* F17 */ ShiftMask, "\033[15;2~", 0, 0}, |
|||
{ XK_F5, /* F29 */ ControlMask, "\033[15;5~", 0, 0}, |
|||
{ XK_F5, /* F41 */ Mod4Mask, "\033[15;6~", 0, 0}, |
|||
{ XK_F5, /* F53 */ Mod1Mask, "\033[15;3~", 0, 0}, |
|||
{ XK_F6, XK_NO_MOD, "\033[17~", 0, 0}, |
|||
{ XK_F6, /* F18 */ ShiftMask, "\033[17;2~", 0, 0}, |
|||
{ XK_F6, /* F30 */ ControlMask, "\033[17;5~", 0, 0}, |
|||
{ XK_F6, /* F42 */ Mod4Mask, "\033[17;6~", 0, 0}, |
|||
{ XK_F6, /* F54 */ Mod1Mask, "\033[17;3~", 0, 0}, |
|||
{ XK_F7, XK_NO_MOD, "\033[18~", 0, 0}, |
|||
{ XK_F7, /* F19 */ ShiftMask, "\033[18;2~", 0, 0}, |
|||
{ XK_F7, /* F31 */ ControlMask, "\033[18;5~", 0, 0}, |
|||
{ XK_F7, /* F43 */ Mod4Mask, "\033[18;6~", 0, 0}, |
|||
{ XK_F7, /* F55 */ Mod1Mask, "\033[18;3~", 0, 0}, |
|||
{ XK_F8, XK_NO_MOD, "\033[19~", 0, 0}, |
|||
{ XK_F8, /* F20 */ ShiftMask, "\033[19;2~", 0, 0}, |
|||
{ XK_F8, /* F32 */ ControlMask, "\033[19;5~", 0, 0}, |
|||
{ XK_F8, /* F44 */ Mod4Mask, "\033[19;6~", 0, 0}, |
|||
{ XK_F8, /* F56 */ Mod1Mask, "\033[19;3~", 0, 0}, |
|||
{ XK_F9, XK_NO_MOD, "\033[20~", 0, 0}, |
|||
{ XK_F9, /* F21 */ ShiftMask, "\033[20;2~", 0, 0}, |
|||
{ XK_F9, /* F33 */ ControlMask, "\033[20;5~", 0, 0}, |
|||
{ XK_F9, /* F45 */ Mod4Mask, "\033[20;6~", 0, 0}, |
|||
{ XK_F9, /* F57 */ Mod1Mask, "\033[20;3~", 0, 0}, |
|||
{ XK_F10, XK_NO_MOD, "\033[21~", 0, 0}, |
|||
{ XK_F10, /* F22 */ ShiftMask, "\033[21;2~", 0, 0}, |
|||
{ XK_F10, /* F34 */ ControlMask, "\033[21;5~", 0, 0}, |
|||
{ XK_F10, /* F46 */ Mod4Mask, "\033[21;6~", 0, 0}, |
|||
{ XK_F10, /* F58 */ Mod1Mask, "\033[21;3~", 0, 0}, |
|||
{ XK_F11, XK_NO_MOD, "\033[23~", 0, 0}, |
|||
{ XK_F11, /* F23 */ ShiftMask, "\033[23;2~", 0, 0}, |
|||
{ XK_F11, /* F35 */ ControlMask, "\033[23;5~", 0, 0}, |
|||
{ XK_F11, /* F47 */ Mod4Mask, "\033[23;6~", 0, 0}, |
|||
{ XK_F11, /* F59 */ Mod1Mask, "\033[23;3~", 0, 0}, |
|||
{ XK_F12, XK_NO_MOD, "\033[24~", 0, 0}, |
|||
{ XK_F12, /* F24 */ ShiftMask, "\033[24;2~", 0, 0}, |
|||
{ XK_F12, /* F36 */ ControlMask, "\033[24;5~", 0, 0}, |
|||
{ XK_F12, /* F48 */ Mod4Mask, "\033[24;6~", 0, 0}, |
|||
{ XK_F12, /* F60 */ Mod1Mask, "\033[24;3~", 0, 0}, |
|||
{ XK_F13, XK_NO_MOD, "\033[1;2P", 0, 0}, |
|||
{ XK_F14, XK_NO_MOD, "\033[1;2Q", 0, 0}, |
|||
{ XK_F15, XK_NO_MOD, "\033[1;2R", 0, 0}, |
|||
{ XK_F16, XK_NO_MOD, "\033[1;2S", 0, 0}, |
|||
{ XK_F17, XK_NO_MOD, "\033[15;2~", 0, 0}, |
|||
{ XK_F18, XK_NO_MOD, "\033[17;2~", 0, 0}, |
|||
{ XK_F19, XK_NO_MOD, "\033[18;2~", 0, 0}, |
|||
{ XK_F20, XK_NO_MOD, "\033[19;2~", 0, 0}, |
|||
{ XK_F21, XK_NO_MOD, "\033[20;2~", 0, 0}, |
|||
{ XK_F22, XK_NO_MOD, "\033[21;2~", 0, 0}, |
|||
{ XK_F23, XK_NO_MOD, "\033[23;2~", 0, 0}, |
|||
{ XK_F24, XK_NO_MOD, "\033[24;2~", 0, 0}, |
|||
{ XK_F25, XK_NO_MOD, "\033[1;5P", 0, 0}, |
|||
{ XK_F26, XK_NO_MOD, "\033[1;5Q", 0, 0}, |
|||
{ XK_F27, XK_NO_MOD, "\033[1;5R", 0, 0}, |
|||
{ XK_F28, XK_NO_MOD, "\033[1;5S", 0, 0}, |
|||
{ XK_F29, XK_NO_MOD, "\033[15;5~", 0, 0}, |
|||
{ XK_F30, XK_NO_MOD, "\033[17;5~", 0, 0}, |
|||
{ XK_F31, XK_NO_MOD, "\033[18;5~", 0, 0}, |
|||
{ XK_F32, XK_NO_MOD, "\033[19;5~", 0, 0}, |
|||
{ XK_F33, XK_NO_MOD, "\033[20;5~", 0, 0}, |
|||
{ XK_F34, XK_NO_MOD, "\033[21;5~", 0, 0}, |
|||
{ XK_F35, XK_NO_MOD, "\033[23;5~", 0, 0}, |
|||
}; |
|||
|
|||
/*
|
|||
* Selection types' masks. |
|||
* Use the same masks as usual. |
|||
* Button1Mask is always unset, to make masks match between ButtonPress. |
|||
* ButtonRelease and MotionNotify. |
|||
* If no match is found, regular selection is used. |
|||
*/ |
|||
static uint selmasks[] = { |
|||
[SEL_RECTANGULAR] = Mod1Mask, |
|||
}; |
|||
|
|||
/*
|
|||
* Printable characters in ASCII, used to estimate the advance width |
|||
* of single wide characters. |
|||
*/ |
|||
static char ascii_printable[] = |
|||
" !\"#$%&'()*+,-./0123456789:;<=>?" |
|||
"@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_" |
|||
"`abcdefghijklmnopqrstuvwxyz{|}~"; |
@ -0,0 +1,35 @@ |
|||
# st version
|
|||
VERSION = 0.8.2 |
|||
|
|||
# Customize below to fit your system
|
|||
|
|||
# paths
|
|||
PREFIX = /usr/local |
|||
MANPREFIX = $(PREFIX)/share/man |
|||
|
|||
X11INC = /usr/X11R6/include |
|||
X11LIB = /usr/X11R6/lib |
|||
|
|||
PKG_CONFIG = pkg-config |
|||
|
|||
# includes and libs
|
|||
INCS = -I$(X11INC) \
|
|||
`$(PKG_CONFIG) --cflags fontconfig` \
|
|||
`$(PKG_CONFIG) --cflags freetype2` |
|||
LIBS = -L$(X11LIB) -lm -lrt -lX11 -lutil -lXft \
|
|||
`$(PKG_CONFIG) --libs fontconfig` \
|
|||
`$(PKG_CONFIG) --libs freetype2` |
|||
|
|||
# flags
|
|||
STCPPFLAGS = -DVERSION=\"$(VERSION)\" -D_XOPEN_SOURCE=600 |
|||
STCFLAGS = $(INCS) $(STCPPFLAGS) $(CPPFLAGS) $(CFLAGS) |
|||
STLDFLAGS = $(LIBS) $(LDFLAGS) |
|||
|
|||
# OpenBSD:
|
|||
#CPPFLAGS = -DVERSION=\"$(VERSION)\" -D_XOPEN_SOURCE=600 -D_BSD_SOURCE
|
|||
#LIBS = -L$(X11LIB) -lm -lX11 -lutil -lXft \
|
|||
# `pkg-config --libs fontconfig` \
|
|||
# `pkg-config --libs freetype2`
|
|||
|
|||
# compiler and linker
|
|||
# CC = c99
|
@ -0,0 +1,176 @@ |
|||
.TH ST 1 st\-VERSION |
|||
.SH NAME |
|||
st \- simple terminal |
|||
.SH SYNOPSIS |
|||
.B st |
|||
.RB [ \-aiv ] |
|||
.RB [ \-c |
|||
.IR class ] |
|||
.RB [ \-f |
|||
.IR font ] |
|||
.RB [ \-g |
|||
.IR geometry ] |
|||
.RB [ \-n |
|||
.IR name ] |
|||
.RB [ \-o |
|||
.IR iofile ] |
|||
.RB [ \-T |
|||
.IR title ] |
|||
.RB [ \-t |
|||
.IR title ] |
|||
.RB [ \-l |
|||
.IR line ] |
|||
.RB [ \-w |
|||
.IR windowid ] |
|||
.RB [[ \-e ] |
|||
.IR command |
|||
.RI [ arguments ...]] |
|||
.PP |
|||
.B st |
|||
.RB [ \-aiv ] |
|||
.RB [ \-c |
|||
.IR class ] |
|||
.RB [ \-f |
|||
.IR font ] |
|||
.RB [ \-g |
|||
.IR geometry ] |
|||
.RB [ \-n |
|||
.IR name ] |
|||
.RB [ \-o |
|||
.IR iofile ] |
|||
.RB [ \-T |
|||
.IR title ] |
|||
.RB [ \-t |
|||
.IR title ] |
|||
.RB [ \-w |
|||
.IR windowid ] |
|||
.RB \-l |
|||
.IR line |
|||
.RI [ stty_args ...] |
|||
.SH DESCRIPTION |
|||
.B st |
|||
is a simple terminal emulator. |
|||
.SH OPTIONS |
|||
.TP |
|||
.B \-a |
|||
disable alternate screens in terminal |
|||
.TP |
|||
.BI \-c " class" |
|||
defines the window class (default $TERM). |
|||
.TP |
|||
.BI \-f " font" |
|||
defines the |
|||
.I font |
|||
to use when st is run. |
|||
.TP |
|||
.BI \-g " geometry" |
|||
defines the X11 geometry string. |
|||
The form is [=][<cols>{xX}<rows>][{+-}<xoffset>{+-}<yoffset>]. See |
|||
.BR XParseGeometry (3) |
|||
for further details. |
|||
.TP |
|||
.B \-i |
|||
will fixate the position given with the -g option. |
|||
.TP |
|||
.BI \-n " name" |
|||
defines the window instance name (default $TERM). |
|||
.TP |
|||
.BI \-o " iofile" |
|||
writes all the I/O to |
|||
.I iofile. |
|||
This feature is useful when recording st sessions. A value of "-" means |
|||
standard output. |
|||
.TP |
|||
.BI \-T " title" |
|||
defines the window title (default 'st'). |
|||
.TP |
|||
.BI \-t " title" |
|||
defines the window title (default 'st'). |
|||
.TP |
|||
.BI \-w " windowid" |
|||
embeds st within the window identified by |
|||
.I windowid |
|||
.TP |
|||
.BI \-l " line" |
|||
use a tty |
|||
.I line |
|||
instead of a pseudo terminal. |
|||
.I line |
|||
should be a (pseudo-)serial device (e.g. /dev/ttyS0 on Linux for serial port |
|||
0). |
|||
When this flag is given |
|||
remaining arguments are used as flags for |
|||
.BR stty(1). |
|||
By default st initializes the serial line to 8 bits, no parity, 1 stop bit |
|||
and a 38400 baud rate. The speed is set by appending it as last argument |
|||
(e.g. 'st -l /dev/ttyS0 115200'). Arguments before the last one are |
|||
.BR stty(1) |
|||
flags. If you want to set odd parity on 115200 baud use for example 'st -l |
|||
/dev/ttyS0 parenb parodd 115200'. Set the number of bits by using for |
|||
example 'st -l /dev/ttyS0 cs7 115200'. See |
|||
.BR stty(1) |
|||
for more arguments and cases. |
|||
.TP |
|||
.B \-v |
|||
prints version information to stderr, then exits. |
|||
.TP |
|||
.BI \-e " command " [ " arguments " "... ]" |
|||
st executes |
|||
.I command |
|||
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 compatibility, |
|||
and all the remaining arguments are used as a command |
|||
even without it. |
|||
.SH SHORTCUTS |
|||
.TP |
|||
.B Break |
|||
Send a break in the serial line. |
|||
Break key is obtained in PC keyboards |
|||
pressing at the same time control and pause. |
|||
.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 Ctrl-Shift-Page Up |
|||
Increase font size. |
|||
.TP |
|||
.B Ctrl-Shift-Page Down |
|||
Decrease font size. |
|||
.TP |
|||
.B Ctrl-Shift-Home |
|||
Reset to default font size. |
|||
.TP |
|||
.B Ctrl-Shift-y |
|||
Paste from primary selection (middle mouse button). |
|||
.TP |
|||
.B Ctrl-Shift-c |
|||
Copy the selected text to the clipboard selection. |
|||
.TP |
|||
.B Ctrl-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 |
|||
code. This keeps it fast, secure and simple. |
|||
.SH AUTHORS |
|||
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 utmp (1), |
|||
.BR stty (1) |
|||
.SH BUGS |
|||
See the TODO file in the distribution. |
|||
|
File diff suppressed because it is too large
@ -0,0 +1,123 @@ |
|||
/* See LICENSE for license details. */ |
|||
|
|||
#include <stdint.h> |
|||
#include <sys/types.h> |
|||
|
|||
/* macros */ |
|||
#define MIN(a, b) ((a) < (b) ? (a) : (b)) |
|||
#define MAX(a, b) ((a) < (b) ? (b) : (a)) |
|||
#define LEN(a) (sizeof(a) / sizeof(a)[0]) |
|||
#define BETWEEN(x, a, b) ((a) <= (x) && (x) <= (b)) |
|||
#define DIVCEIL(n, d) (((n) + ((d) - 1)) / (d)) |
|||
#define DEFAULT(a, b) (a) = (a) ? (a) : (b) |
|||
#define LIMIT(x, a, b) (x) = (x) < (a) ? (a) : (x) > (b) ? (b) : (x) |
|||
#define ATTRCMP(a, b) ((a).mode != (b).mode || (a).fg != (b).fg || \ |
|||
(a).bg != (b).bg) |
|||
#define TIMEDIFF(t1, t2) ((t1.tv_sec-t2.tv_sec)*1000 + \ |
|||
(t1.tv_nsec-t2.tv_nsec)/1E6) |
|||
#define MODBIT(x, set, bit) ((set) ? ((x) |= (bit)) : ((x) &= ~(bit))) |
|||
|
|||
#define TRUECOLOR(r,g,b) (1 << 24 | (r) << 16 | (g) << 8 | (b)) |
|||
#define IS_TRUECOL(x) (1 << 24 & (x)) |
|||
|
|||
enum glyph_attribute { |
|||
ATTR_NULL = 0, |
|||
ATTR_BOLD = 1 << 0, |
|||
ATTR_FAINT = 1 << 1, |
|||
ATTR_ITALIC = 1 << 2, |
|||
ATTR_UNDERLINE = 1 << 3, |
|||
ATTR_BLINK = 1 << 4, |
|||
ATTR_REVERSE = 1 << 5, |
|||
ATTR_INVISIBLE = 1 << 6, |
|||
ATTR_STRUCK = 1 << 7, |
|||
ATTR_WRAP = 1 << 8, |
|||
ATTR_WIDE = 1 << 9, |
|||
ATTR_WDUMMY = 1 << 10, |
|||
ATTR_BOLD_FAINT = ATTR_BOLD | ATTR_FAINT, |
|||
}; |
|||
|
|||
enum selection_mode { |
|||
SEL_IDLE = 0, |
|||
SEL_EMPTY = 1, |
|||
SEL_READY = 2 |
|||
}; |
|||
|
|||
enum selection_type { |
|||
SEL_REGULAR = 1, |
|||
SEL_RECTANGULAR = 2 |
|||
}; |
|||
|
|||
enum selection_snap { |
|||
SNAP_WORD = 1, |
|||
SNAP_LINE = 2 |
|||
}; |
|||
|
|||
typedef unsigned char uchar; |
|||
typedef unsigned int uint; |
|||
typedef unsigned long ulong; |
|||
typedef unsigned short ushort; |
|||
|
|||
typedef uint_least32_t Rune; |
|||
|
|||
#define Glyph Glyph_ |
|||
typedef struct { |
|||
Rune u; /* character code */ |
|||
ushort mode; /* attribute flags */ |
|||
uint32_t fg; /* foreground */ |
|||
uint32_t bg; /* background */ |
|||
} Glyph; |
|||
|
|||
typedef Glyph *Line; |
|||
|
|||
typedef union { |
|||
int i; |
|||
uint ui; |
|||
float f; |
|||
const void *v; |
|||
const char *s; |
|||
} Arg; |
|||
|
|||
void die(const char *, ...); |
|||
void redraw(void); |
|||
void draw(void); |
|||
|
|||
void printscreen(const Arg *); |
|||
void printsel(const Arg *); |
|||
void sendbreak(const Arg *); |
|||
void toggleprinter(const Arg *); |
|||
|
|||
int tattrset(int); |
|||
void tnew(int, int); |
|||
void tresize(int, int); |
|||
void tsetdirtattr(int); |
|||
void ttyhangup(void); |
|||
int ttynew(char *, char *, char *, char **); |
|||
size_t ttyread(void); |
|||
void ttyresize(int, int); |
|||
void ttywrite(const char *, size_t, int); |
|||
|
|||
void resettitle(void); |
|||
|
|||
void selclear(void); |
|||
void selinit(void); |
|||
void selstart(int, int, int); |
|||
void selextend(int, int, int, int); |
|||
int selected(int, int); |
|||
char *getsel(void); |
|||
|
|||
size_t utf8encode(Rune, char *); |
|||
|
|||
void *xmalloc(size_t); |
|||
void *xrealloc(void *, size_t); |
|||
char *xstrdup(char *); |
|||
|
|||
/* config.h globals */ |
|||
extern char *utmp; |
|||
extern char *stty_args; |
|||
extern char *vtiden; |
|||
extern wchar_t *worddelimiters; |
|||
extern int allowaltscreen; |
|||
extern char *termname; |
|||
extern unsigned int tabspaces; |
|||
extern unsigned int defaultfg; |
|||
extern unsigned int defaultbg; |
@ -0,0 +1,222 @@ |
|||
st| simpleterm, |
|||
acsc=+C\,D-A.B0E``aaffgghFiGjjkkllmmnnooppqqrrssttuuvvwwxxyyzz{{||}}~~, |
|||
am, |
|||
bce, |
|||
bel=^G, |
|||
blink=\E[5m, |
|||
bold=\E[1m, |
|||
cbt=\E[Z, |
|||
cvvis=\E[?25h, |
|||
civis=\E[?25l, |
|||
clear=\E[H\E[2J, |
|||
cnorm=\E[?12l\E[?25h, |
|||
colors#8, |
|||
cols#80, |
|||
cr=^M, |
|||
csr=\E[%i%p1%d;%p2%dr, |
|||
cub=\E[%p1%dD, |
|||
cub1=^H, |
|||
cud1=^J, |
|||
cud=\E[%p1%dB, |
|||
cuf1=\E[C, |
|||
cuf=\E[%p1%dC, |
|||
cup=\E[%i%p1%d;%p2%dH, |
|||
cuu1=\E[A, |
|||
cuu=\E[%p1%dA, |
|||
dch=\E[%p1%dP, |
|||
dch1=\E[P, |
|||
dim=\E[2m, |
|||
dl=\E[%p1%dM, |
|||
dl1=\E[M, |
|||
ech=\E[%p1%dX, |
|||
ed=\E[J, |
|||
el=\E[K, |
|||
el1=\E[1K, |
|||
enacs=\E)0, |
|||
flash=\E[?5h$<80/>\E[?5l, |
|||
fsl=^G, |
|||
home=\E[H, |
|||
hpa=\E[%i%p1%dG, |
|||
hs, |
|||
ht=^I, |
|||
hts=\EH, |
|||
ich=\E[%p1%d@, |
|||
il1=\E[L, |
|||
il=\E[%p1%dL, |
|||
ind=^J, |
|||
indn=\E[%p1%dS, |
|||
invis=\E[8m, |
|||
is2=\E[4l\E>\E[?1034l, |
|||
it#8, |
|||
kel=\E[1;2F, |
|||
ked=\E[1;5F, |
|||
ka1=\E[1~, |
|||
ka3=\E[5~, |
|||
kc1=\E[4~, |
|||
kc3=\E[6~, |
|||
kbs=\177, |
|||
kcbt=\E[Z, |
|||
kb2=\EOu, |
|||
kcub1=\EOD, |
|||
kcud1=\EOB, |
|||
kcuf1=\EOC, |
|||
kcuu1=\EOA, |
|||
kDC=\E[3;2~, |
|||
kent=\EOM, |
|||
kEND=\E[1;2F, |
|||
kIC=\E[2;2~, |
|||
kNXT=\E[6;2~, |
|||
kPRV=\E[5;2~, |
|||
kHOM=\E[1;2H, |
|||
kLFT=\E[1;2D, |
|||
kRIT=\E[1;2C, |
|||
kind=\E[1;2B, |
|||
kri=\E[1;2A, |
|||
kclr=\E[3;5~, |
|||
kdl1=\E[3;2~, |
|||
kdch1=\E[3~, |
|||
kich1=\E[2~, |
|||
kend=\E[4~, |
|||
kf1=\EOP, |
|||
kf2=\EOQ, |
|||
kf3=\EOR, |
|||
kf4=\EOS, |
|||
kf5=\E[15~, |
|||
kf6=\E[17~, |
|||
kf7=\E[18~, |
|||
kf8=\E[19~, |
|||
kf9=\E[20~, |
|||
kf10=\E[21~, |
|||
kf11=\E[23~, |
|||
kf12=\E[24~, |
|||
kf13=\E[1;2P, |
|||
kf14=\E[1;2Q, |
|||
kf15=\E[1;2R, |
|||
kf16=\E[1;2S, |
|||
kf17=\E[15;2~, |
|||
kf18=\E[17;2~, |
|||
kf19=\E[18;2~, |
|||
kf20=\E[19;2~, |
|||
kf21=\E[20;2~, |
|||
kf22=\E[21;2~, |
|||
kf23=\E[23;2~, |
|||
kf24=\E[24;2~, |
|||
kf25=\E[1;5P, |
|||
kf26=\E[1;5Q, |
|||
kf27=\E[1;5R, |
|||
kf28=\E[1;5S, |
|||
kf29=\E[15;5~, |
|||
kf30=\E[17;5~, |
|||
kf31=\E[18;5~, |
|||
kf32=\E[19;5~, |
|||
kf33=\E[20;5~, |
|||
kf34=\E[21;5~, |
|||
kf35=\E[23;5~, |
|||
kf36=\E[24;5~, |
|||
kf37=\E[1;6P, |
|||
kf38=\E[1;6Q, |
|||
kf39=\E[1;6R, |
|||
kf40=\E[1;6S, |
|||
kf41=\E[15;6~, |
|||
kf42=\E[17;6~, |
|||
kf43=\E[18;6~, |
|||
kf44=\E[19;6~, |
|||
kf45=\E[20;6~, |
|||
kf46=\E[21;6~, |
|||
kf47=\E[23;6~, |
|||
kf48=\E[24;6~, |
|||
kf49=\E[1;3P, |
|||
kf50=\E[1;3Q, |
|||
kf51=\E[1;3R, |
|||
kf52=\E[1;3S, |
|||
kf53=\E[15;3~, |
|||
kf54=\E[17;3~, |
|||
kf55=\E[18;3~, |
|||
kf56=\E[19;3~, |
|||
kf57=\E[20;3~, |
|||
kf58=\E[21;3~, |
|||
kf59=\E[23;3~, |
|||
kf60=\E[24;3~, |
|||
kf61=\E[1;4P, |
|||
kf62=\E[1;4Q, |
|||
kf63=\E[1;4R, |
|||
khome=\E[1~, |
|||
kil1=\E[2;5~, |
|||
krmir=\E[2;2~, |
|||
knp=\E[6~, |
|||
kmous=\E[M, |
|||
kpp=\E[5~, |
|||
lines#24, |
|||
mir, |
|||
msgr, |
|||
npc, |
|||
op=\E[39;49m, |
|||
pairs#64, |
|||
mc0=\E[i, |
|||
mc4=\E[4i, |
|||
mc5=\E[5i, |
|||
rc=\E8, |
|||
rev=\E[7m, |
|||
ri=\EM, |
|||
ritm=\E[23m, |
|||
rmacs=\E(B, |
|||
rmcup=\E[?1049l, |
|||
rmir=\E[4l, |
|||
rmkx=\E[?1l\E>, |
|||
rmso=\E[27m, |
|||
rmul=\E[24m, |
|||
rs1=\Ec, |
|||
rs2=\E[4l\E>\E[?1034l, |
|||
sc=\E7, |
|||
setab=\E[4%p1%dm, |
|||
setaf=\E[3%p1%dm, |
|||
setb=\E[4%?%p1%{1}%=%t4%e%p1%{3}%=%t6%e%p1%{4}%=%t1%e%p1%{6}%=%t3%e%p1%d%;m, |
|||
setf=\E[3%?%p1%{1}%=%t4%e%p1%{3}%=%t6%e%p1%{4}%=%t1%e%p1%{6}%=%t3%e%p1%d%;m, |
|||
sgr0=\E[0m, |
|||
sgr=%?%p9%t\E(0%e\E(B%;\E[0%?%p6%t;1%;%?%p2%t;4%;%?%p1%p3%|%t;7%;%?%p4%t;5%;%?%p7%t;8%;m, |
|||
sitm=\E[3m, |
|||
smacs=\E(0, |
|||
smcup=\E[?1049h, |
|||
smir=\E[4h, |
|||
smkx=\E[?1h\E=, |
|||
smso=\E[7m, |
|||
smul=\E[4m, |
|||
tbc=\E[3g, |
|||
tsl=\E]0;, |
|||
xenl, |
|||
vpa=\E[%i%p1%dd, |
|||
# XTerm extensions |
|||
rmxx=\E[29m, |
|||
smxx=\E[9m, |
|||
# tmux extensions, see TERMINFO EXTENSIONS in tmux(1) |
|||
Tc, |
|||
Ms=\E]52;%p1%s;%p2%s\007, |
|||
Se=\E[2 q, |
|||
Ss=\E[%p1%d q, |
|||
|
|||
st-256color| simpleterm with 256 colors, |
|||
use=st, |
|||
ccc, |
|||
colors#256, |
|||
oc=\E]104\007, |
|||
pairs#32767, |
|||
# Nicked from xterm-256color |
|||
initc=\E]4;%p1%d;rgb\:%p2%{255}%*%{1000}%/%2.2X/%p3%{255}%*%{1000}%/%2.2X/%p4%{255}%*%{1000}%/%2.2X\E\\, |
|||
setab=\E[%?%p1%{8}%<%t4%p1%d%e%p1%{16}%<%t10%p1%{8}%-%d%e48;5;%p1%d%;m, |
|||
setaf=\E[%?%p1%{8}%<%t3%p1%d%e%p1%{16}%<%t9%p1%{8}%-%d%e38;5;%p1%d%;m, |
|||
|
|||
st-meta| simpleterm with meta key, |
|||
use=st, |
|||
km, |
|||
rmm=\E[?1034l, |
|||
smm=\E[?1034h, |
|||
rs2=\E[4l\E>\E[?1034h, |
|||
is2=\E[4l\E>\E[?1034h, |
|||
|
|||
st-meta-256color| simpleterm with meta key and 256 colors, |
|||
use=st-256color, |
|||
km, |
|||
rmm=\E[?1034l, |
|||
smm=\E[?1034h, |
|||
rs2=\E[4l\E>\E[?1034h, |
|||
is2=\E[4l\E>\E[?1034h, |
@ -0,0 +1,39 @@ |
|||
/* See LICENSE for license details. */ |
|||
|
|||
enum win_mode { |
|||
MODE_VISIBLE = 1 << 0, |
|||
MODE_FOCUSED = 1 << 1, |
|||
MODE_APPKEYPAD = 1 << 2, |
|||
MODE_MOUSEBTN = 1 << 3, |
|||
MODE_MOUSEMOTION = 1 << 4, |
|||
MODE_REVERSE = 1 << 5, |
|||
MODE_KBDLOCK = 1 << 6, |
|||
MODE_HIDE = 1 << 7, |
|||
MODE_APPCURSOR = 1 << 8, |
|||
MODE_MOUSESGR = 1 << 9, |
|||
MODE_8BIT = 1 << 10, |
|||
MODE_BLINK = 1 << 11, |
|||
MODE_FBLINK = 1 << 12, |
|||
MODE_FOCUS = 1 << 13, |
|||
MODE_MOUSEX10 = 1 << 14, |
|||
MODE_MOUSEMANY = 1 << 15, |
|||
MODE_BRCKTPASTE = 1 << 16, |
|||
MODE_NUMLOCK = 1 << 17, |
|||
MODE_MOUSE = MODE_MOUSEBTN|MODE_MOUSEMOTION|MODE_MOUSEX10\ |
|||
|MODE_MOUSEMANY, |
|||
}; |
|||
|
|||
void xbell(void); |
|||
void xclipcopy(void); |
|||
void xdrawcursor(int, int, Glyph, int, int, Glyph); |
|||
void xdrawline(Line, int, int, int); |
|||
void xfinishdraw(void); |
|||
void xloadcols(void); |
|||
int xsetcolorname(int, const char *); |
|||
void xsettitle(char *); |
|||
int xsetcursor(int); |
|||
void xsetmode(int, unsigned int); |
|||
void xsetpointermotion(int); |
|||
void xsetsel(char *); |
|||
int xstartdraw(void); |
|||
void xximspot(int, int); |
File diff suppressed because it is too large
Loading…
Reference in new issue