@@ -0,0 +1,4 @@ | |||
*.swp | |||
*.swo |
@@ -0,0 +1 @@ | |||
debian/patches |
@@ -0,0 +1 @@ | |||
series |
@@ -0,0 +1 @@ | |||
2 |
@@ -0,0 +1,250 @@ | |||
## 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 | |||
* Using the excellent tool of [scroll](https://git.suckless.org/scroll/). | |||
* Using the scrollback [patch](https://st.suckless.org/patches/scrollback/). | |||
## I would like to have utmp and/or scroll functionality by default | |||
You can add the absolute patch of both programs in your config.h | |||
file. You only have to modify the value of utmp and scroll variables. | |||
## 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 using the w3m image hack? | |||
w3mimg uses a hack that draws an image on top of the terminal emulator Drawable | |||
window. The hack relies on the terminal to use a single buffer to draw its | |||
contents directly. | |||
st uses double-buffered drawing so the image is quickly replaced and may show a | |||
short flicker effect. | |||
Below is a patch example to change st double-buffering to a single Drawable | |||
buffer. | |||
diff --git a/x.c b/x.c | |||
--- a/x.c | |||
+++ b/x.c | |||
@@ -732,10 +732,6 @@ xresize(int col, int row) | |||
win.tw = col * win.cw; | |||
win.th = row * win.ch; | |||
- XFreePixmap(xw.dpy, xw.buf); | |||
- xw.buf = XCreatePixmap(xw.dpy, xw.win, win.w, win.h, | |||
- DefaultDepth(xw.dpy, xw.scr)); | |||
- XftDrawChange(xw.draw, xw.buf); | |||
xclear(0, 0, win.w, win.h); | |||
/* resize to new width */ | |||
@@ -1148,8 +1144,7 @@ xinit(int cols, int rows) | |||
gcvalues.graphics_exposures = False; | |||
dc.gc = XCreateGC(xw.dpy, parent, GCGraphicsExposures, | |||
&gcvalues); | |||
- xw.buf = XCreatePixmap(xw.dpy, xw.win, win.w, win.h, | |||
- DefaultDepth(xw.dpy, xw.scr)); | |||
+ xw.buf = xw.win; | |||
XSetForeground(xw.dpy, dc.gc, dc.col[defaultbg].pixel); | |||
XFillRectangle(xw.dpy, xw.buf, dc.gc, 0, 0, win.w, win.h); | |||
@@ -1632,8 +1627,6 @@ xdrawline(Line line, int x1, int y1, int x2) | |||
void | |||
xfinishdraw(void) | |||
{ | |||
- XCopyArea(xw.dpy, xw.buf, xw.win, dc.gc, 0, 0, win.w, | |||
- win.h, 0, 0); | |||
XSetForeground(xw.dpy, dc.gc, | |||
dc.col[IS_SET(MODE_REVERSE)? | |||
defaultfg : defaultbg].pixel); | |||
## 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-2020 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,472 @@ | |||
/* 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: scroll and/or utmp | |||
* 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; | |||
/* scroll program: to enable use a string like "scroll" */ | |||
char *scroll = 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; | |||
/* allow certain non-interactive (insecure) window operations such as: | |||
setting the clipboard text */ | |||
int allowwindowops = 0; | |||
/* | |||
* draw latency range in ms - from new content/keypress/etc until drawing. | |||
* within this range, st draws when content stops arriving (idle). mostly it's | |||
* near minlatency, but it waits longer for slow updates to avoid partial draw. | |||
* low minlatency will tear/flicker more, as it can "detect" idle too early. | |||
*/ | |||
static double minlatency = 8; | |||
static double maxlatency = 33; | |||
/* | |||
* 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 }, | |||
{ ShiftMask, Button4, ttysend, {.s = "\033[5;2~"} }, | |||
{ XK_ANY_MOD, Button4, ttysend, {.s = "\031"} }, | |||
{ ShiftMask, Button5, ttysend, {.s = "\033[6;2~"} }, | |||
{ 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.4 | |||
# 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,297 @@ | |||
stterm (0.8.4-1) unstable; urgency=medium | |||
* New upstream version 0.8.4. | |||
* d/control: rewrap (wrap-and-sort -ast). | |||
* d/gbp.conf: set compression = xz. | |||
-- Paride Legovini <paride@debian.org> Tue, 07 Jul 2020 18:37:15 +0000 | |||
stterm (0.8.3-1) unstable; urgency=medium | |||
* New upstream version 0.8.3. | |||
* Install the FAQ and LEGAGY files. | |||
* d/control: | |||
- bump the dh compat level to 13. | |||
- bump Standards-Version to 4.5.0 (no changes needed). | |||
- specify Rules-Requires-Root: no. | |||
- use the paride@debian.org alias in Uploaders. | |||
* d/rules: | |||
- stop enforcing -Wl,--as-needed (now done by default). | |||
- drop override_dh_auto_build (CPPFLAGS now supported upstream). | |||
-- Paride Legovini <paride@debian.org> Sun, 17 May 2020 17:18:33 +0000 | |||
stterm (0.8.2-1) unstable; urgency=medium | |||
* New upstream version 0.8.1 (closes: 921961) | |||
* Drop all the patches (upstreamed) | |||
-- Paride Legovini <pl@ninthfloor.org> Mon, 11 Feb 2019 10:54:52 +0000 | |||
stterm (0.8.1-2) unstable; urgency=medium | |||
* Bump Standards-Version to 4.3.0 (no changes needed) | |||
* Bump debhelper compat level to 12 (no changes needed) | |||
* Patch: allow pkg-config substitution for crossbuilding. | |||
Fixes FTCBFS. Closes: #900901. Thanks: Helmut Grohne. | |||
-- Paride Legovini <pl@ninthfloor.org> Thu, 03 Jan 2019 15:48:26 +0000 | |||
stterm (0.8.1-1) unstable; urgency=medium | |||
* New upstream version (closes: #838372) | |||
* New maintainer: Paride Legovini (closes: #909663) | |||
* Standard-Version 4.2.1 (no changes needed) | |||
* Compat level 11 (with B-D on debhelper-compat) | |||
* Do not install the terminfo file | |||
* Depend on libncurses-term (provides st's terminfo) | |||
* Drop the unused build-dependency on libxext-dev | |||
* Dropped all the patches. Now: | |||
- TERM is st-256color (closes: #785219, #838439); | |||
- The binary is installed as 'st', with a 'stterm' symlink. | |||
-- Paride Legovini <pl@ninthfloor.org> Tue, 13 Nov 2018 22:35:13 +0000 | |||
stterm (0.6-1) unstable; urgency=medium | |||
* Team upload | |||
* New upstream release (Closes: #820376) | |||
* Update debian/watch | |||
* Refresh patches | |||
[ Gianfranco Costamagna ] | |||
* Bump std-version to 3.9.8 | |||
* Fix insecure VCS fields. | |||
-- Dmitry Bogatov <KAction@gnu.org> Sun, 15 May 2016 18:46:37 +0300 | |||
stterm (0.5+20140606+gitc2fd275-1) unstable; urgency=low | |||
* New upstream release. | |||
- Thanks to Markus <waldeck@gmx.de> for the heads up. | |||
- Fix warning about missing fontset (Closes: #606149). | |||
- Option "-g" now works correctly. | |||
* debian/control | |||
- (Standards-Version): Update to 3.9.5. | |||
* debian/copyright | |||
- Update years. | |||
-- Jari Aalto <jari.aalto@cante.net> Sun, 15 Jun 2014 18:55:14 +0300 | |||
stterm (0.4.1+20130921+giteeae9b0-1) unstable; urgency=low | |||
* New upstream release. | |||
* pod2man.mk, debian-vars.mk, stterm.1.pod, stterm.manpages | |||
- Delete; no longer needed (Closes: #724096). | |||
* debian/patch | |||
- Refresh patches. | |||
* debian/rules | |||
- (man): delete. | |||
- (override_dh_auto_install): install manual page. | |||
-- Jari Aalto <jari.aalto@cante.net> Wed, 25 Sep 2013 08:27:18 +0300 | |||
stterm (0.4.1+20130812+git4579693-1) unstable; urgency=low | |||
* New upstream release. | |||
* debian/control | |||
- (Provides): add x-terminal-emulator. | |||
* debian/upstream.changelog | |||
- Sync with release. | |||
* debian/patches | |||
- Sync with release (quilt refresh). | |||
- (36, 40): New. Change command line option form -t to -T | |||
according to policy: 11.8.3 Packages providing a terminal emulator. | |||
* debian/{postinst,prerm} | |||
- New. Install x-terminal-emulator alternatives. | |||
* debian/repack.sh | |||
- Minor updates. | |||
* debian/rules | |||
- (get-changelog): Clean EOL whitespaces. | |||
* debian/*.mk | |||
- Minor updates. | |||
-- Jari Aalto <jari.aalto@cante.net> Fri, 16 Aug 2013 09:04:29 +0300 | |||
stterm (0.4.1+20130609+git5d3318c-1) unstable; urgency=low | |||
* New upstream release. | |||
* debian/copyright | |||
- Sync emails and license text | |||
* debian/upstream.changelog | |||
- Sync with release. | |||
-- Jari Aalto <jari.aalto@cante.net> Thu, 13 Jun 2013 10:48:23 +0300 | |||
stterm (0.4.1+20130526+gitb514410-1) unstable; urgency=low | |||
* New upstream release. | |||
* debian/control | |||
- (Description): Add reference to suckless tools and mention | |||
original binary name "st". | |||
* debian/patches | |||
- Sync with release. | |||
- (20): Update *.info file terminal descriptions. | |||
- (35): Update manual page for name stterm. | |||
* debian/upstream.changelog | |||
- Sync with release. | |||
-- Jari Aalto <jari.aalto@cante.net> Fri, 31 May 2013 12:44:29 +0300 | |||
stterm (0.4.1+20130511+git8f47c4a-1) unstable; urgency=low | |||
* New upstream release | |||
* debian/copyright | |||
- Update year. | |||
* debian/rules | |||
- (get-changelog): Update to new Git repository. | |||
* debian/upstream.changelog | |||
- Sync with release (Closes: #709318). | |||
-- Jari Aalto <jari.aalto@cante.net> Thu, 23 May 2013 10:51:36 +0300 | |||
stterm (0.4.1+20130501+git8618386-1) unstable; urgency=low | |||
* New upstream release (Closes: #706549). | |||
* debian/copyright | |||
- (X-Vcs-Git): Update from Hg to Git repository. | |||
* debian/patches | |||
- (12, 13, 20, 30): Refresh for current release. | |||
* debian/rules | |||
- Update build flags for current release. E.g VERSION 0.4.1. | |||
-- Jari Aalto <jari.aalto@cante.net> Wed, 01 May 2013 22:14:31 +0300 | |||
stterm (0.3+20121116+hg424-1) unstable; urgency=low | |||
* New upstream release. | |||
* debian/control | |||
- (Build-Depends): Add libfreetype6-dev, libxext-dev, pkg-config, | |||
libxft-dev. | |||
- (Standards-Version): Update to 3.9.4. | |||
* debian/patches | |||
- (12, 13, 20): Refresh for current release. | |||
- (30): New. Use name stterm-256. Patch thanks to John Vogel | |||
<jvogel4@stny.rr.com> (Closes: #693494). | |||
* debian/rules | |||
- (CFLAGS, LDFLAGS): Update for latest release. | |||
-- Jari Aalto <jari.aalto@cante.net> Sat, 24 Nov 2012 12:48:42 +0200 | |||
stterm (0.0~20120227+hg244-1) unstable; urgency=low | |||
* New upstream release. | |||
* debian/patches | |||
- (13): New. Update name st to stterm in window title. | |||
-- Jari Aalto <jari.aalto@cante.net> Sat, 21 Jul 2012 10:57:50 +0300 | |||
stterm (0.0~20120124+hg226-2) unstable; urgency=low | |||
* debian/compat | |||
- Update to 9. | |||
* debian/control | |||
- (Build-Depends): Update to debhelper 9. | |||
- (Standards-Version): Update to 3.9.3.1. | |||
* debian/copyright | |||
- Update to format 1.0. | |||
* debian/rules | |||
- Use hardened build flags | |||
http://wiki.debian.org/ReleaseGoals/SecurityHardeningBuildFlags | |||
- (override_dh_auto_build): New. | |||
-- Jari Aalto <jari.aalto@cante.net> Fri, 23 Mar 2012 15:45:22 -0400 | |||
stterm (0.0~20120124+hg226-1) unstable; urgency=low | |||
* New upstream release | |||
* debian/rules | |||
- Set LDFLAGS via dpkg-buildflags(1). | |||
- Use hardened CFLAGS (release goal). | |||
http://wiki.debian.org/ReleaseGoals/SecurityHardeningBuildFlags | |||
-- Jari Aalto <jari.aalto@cante.net> Sun, 05 Feb 2012 10:11:26 +0200 | |||
stterm (0.0~20110920+hg212-4) unstable; urgency=low | |||
* debian/rules | |||
- (terminfo): New. Run tic(1) at install time (Closes: #656557). | |||
* debian/{postinst,postrm}: Delete. Tic is now called in debian/rules. | |||
-- Jari Aalto <jari.aalto@cante.net> Mon, 23 Jan 2012 21:09:31 +0200 | |||
stterm (0.0~20110920+hg212-3) unstable; urgency=low | |||
* debian/postinst | |||
- Delete files created in postinst by tic(1) (Closes: #656557). | |||
-- Jari Aalto <jari.aalto@cante.net> Fri, 20 Jan 2012 15:36:11 +0200 | |||
stterm (0.0~20110920+hg212-2) unstable; urgency=low | |||
* debian/patches | |||
- (20): Correct terminal id from "st" to "stterm" (Closes: #656114). | |||
-- Jari Aalto <jari.aalto@cante.net> Tue, 17 Jan 2012 20:27:48 +0200 | |||
stterm (0.0~20110920+hg212-1) unstable; urgency=low | |||
* New upstream release. | |||
* debian/clean | |||
- Add config.h. | |||
* debian/compat | |||
- Update to 8. | |||
* debian/control | |||
- (Build-Depends): debhelper 8. | |||
- (Description): update firs line. | |||
- (Standards-Version): Update to 3.9.2. | |||
* debian/copyright | |||
- Update to DEP 5. | |||
* debian/patches | |||
- (10): Delete. Accepted upstream: options -V, --version. | |||
- (12): New. Replaced by patches 11-fix-compile and 12-version. | |||
- (13): Delete. Accepted upstream: do not display Ctrl, Alt key | |||
messages. | |||
- (20): Refresh. | |||
* debian/rules | |||
- (get-changelog): update instructions. | |||
-- Jari Aalto <jari.aalto@cante.net> Tue, 20 Sep 2011 12:56:21 +0300 | |||
stterm (0.0~20091219+hg68-4) unstable; urgency=low | |||
* debian/control | |||
- (Description): Correct units to MiB (Closes: #584649). | |||
-- Jari Aalto <jari.aalto@cante.net> Sat, 05 Jun 2010 13:27:55 +0300 | |||
stterm (0.0~20091219+hg68-3) unstable; urgency=low | |||
* debian/upstream.changelog | |||
- Update content (Closes: #583920). | |||
-- Jari Aalto <jari.aalto@cante.net> Wed, 02 Jun 2010 08:34:54 +0300 | |||
stterm (0.0~20091219+hg68-2) unstable; urgency=low | |||
* Bug fix release | |||
- Prevent tic(1) from writing to $HOME and handle terminfo | |||
file install in postinst script (FTBFS; Closes: #583627). | |||
* debian/patches | |||
- (20): New. Change terminal name from st to stterm. | |||
* debian/postinst | |||
- New file. | |||
* debian/rules | |||
- Move to full dh(1). | |||
* debian/stterm.install | |||
- Delete. Handled in debian/rules. | |||
* debian/upstream.changelog | |||
- New file. | |||
-- Jari Aalto <jari.aalto@cante.net> Sat, 29 May 2010 09:14:51 +0300 | |||
stterm (0.0~20091219+hg68-1) unstable; urgency=low | |||
* Initial release (Closes: #560596). | |||
-- Jari Aalto <jari.aalto@cante.net> Sun, 14 Feb 2010 01:02:03 +0200 |
@@ -0,0 +1 @@ | |||
config.h |
@@ -0,0 +1,40 @@ | |||
Source: stterm | |||
Section: x11 | |||
Priority: optional | |||
Maintainer: Paride Legovini <paride@debian.org> | |||
Build-Depends: | |||
debhelper-compat (= 13), | |||
libx11-dev, | |||
libxft-dev, | |||
pkg-config, | |||
Standards-Version: 4.5.0 | |||
Vcs-Browser: https://salsa.debian.org/debian/st | |||
Vcs-Git: https://salsa.debian.org/debian/st.git | |||
Homepage: https://st.suckless.org | |||
Rules-Requires-Root: no | |||
Package: stterm | |||
Architecture: any | |||
Depends: | |||
ncurses-term (>= 6.1+20180714-1), | |||
${misc:Depends}, | |||
${shlibs:Depends}, | |||
Provides: | |||
x-terminal-emulator, | |||
Multi-Arch: foreign | |||
X-Comment: | |||
The versioned dependency for ncurses-term is on the first update after the | |||
terminfo entry for st has been last updated in the terminfo database. This | |||
can be checked in <https://invisible-island.net/ncurses/NEWS.html>. | |||
Description: simple terminal emulator for X | |||
st is a terminal emulator from the suckless project with a focus on | |||
simplicity, clarity and frugality. The project's philosophy is about | |||
keeping things simple, minimal and usable. | |||
. | |||
st supports most VT10X escape sequences, serial lines, XIM, utmp via | |||
utmp(1), clipboard handling, mouse and keyboard shortcuts, UTF-8, wide | |||
characters, resize, 256 colors, true colors, antialiased fonts (using | |||
fontconfig), fallback fonts, and line drawing. It does *not* provide | |||
a scrollback buffer: users are encouraged to use a terminal multiplexter. | |||
. | |||
This Debian package is called 'stterm' for historical reasons. |
@@ -0,0 +1,101 @@ | |||
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ | |||
Upstream-Name: st | |||
Upstream-Contact: https://suckless.org/community/ | |||
Source: https://st.suckless.org | |||
Files: * | |||
Copyright: | |||
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> | |||
License: Expat | |||
Files: arg.h | |||
Copyright: 2017-2018 Christoph Lohmann <20h at r-36 dot net> | |||
License: Expat | |||
Comment: | |||
Got written permission from the Author. | |||
The relevant email excerpts follow. | |||
. | |||
On 2017-07-25 13:56, Christoph Lohmann wrote: | |||
> On Tue, 25 Jul 2017 13:56:30 Paride Legovini <pl@ninthfloor.org> wrote: | |||
> > while working on software packaging I encountered your arg.h file, with | |||
> > just the following notice: | |||
> > | |||
> > /* | |||
> > * Copy me if you can. | |||
> > * by 20h | |||
> > */ | |||
> > | |||
> > and no proper copyright attribution. I tracked down the file to `sbase', | |||
> > but I'm still unsure about where your actual intentions about the | |||
> > license for this file. May I assume it's MIX/X Consortium licensed as | |||
> > the rest of sbase? | |||
> | |||
> The license is meant to be public domain. History has destroyed this | |||
> dream of real public domain and lawyers live their greed. | |||
> | |||
> You can assume that it is MIT/X licensed. This will satisfy all | |||
> discussions. | |||
. | |||
On 2017-07-26 13:20, Christoph Lohmann wrote: | |||
> On Wed, 26 Jul 2017 13:20:40 Paride Legovini <pl@ninthfloor.org> wrote: | |||
> | |||
> > May I publicly quote your email? | |||
> | |||
> You are allowed to do that. | |||
Files: debian/* | |||
Copyright: | |||
2009-2016 Jari Aalto <jari.aalto@cante.net> | |||
2016 Dmitry Bogatov <KAction@gnu.org> | |||
2016 Gianfranco Costamagna <locutusofborg@debian.org> | |||
2018 Paride Legovini <pl@ninthfloor.org> | |||
License: GPL-2+ | |||
License: Expat | |||
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. | |||
License: GPL-2+ | |||
This package is free software; you can redistribute it and/or modify | |||
it under the terms of the GNU General Public License as published by | |||
the Free Software Foundation; either version 2 of the License, or | |||
(at your option) any later version. | |||
. | |||
This package is distributed in the hope that it will be useful, | |||
but WITHOUT ANY WARRANTY; without even the implied warranty of | |||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |||
GNU General Public License for more details. | |||
. | |||
You should have received a copy of the GNU General Public License | |||
along with this program. If not, see <http://www.gnu.org/licenses/>. | |||
. | |||
On Debian systems, the complete text of the GNU General | |||
Public License can be found in "/usr/share/common-licenses/GPL-2". |
@@ -0,0 +1,7 @@ | |||
[DEFAULT] | |||
debian-branch = debian/sid | |||
upstream-branch = | |||
upstream-tag = %(version)s | |||
pristine-tar = True | |||
pristine-tar-commit = True | |||
compression = xz |
@@ -0,0 +1,18 @@ | |||
#!/usr/bin/make -f | |||
# Needed for the st.1 VERSION fixup in override_dh_installman. | |||
include /usr/share/dpkg/pkg-info.mk | |||
export DEB_BUILD_MAINT_OPTIONS = hardening=+all | |||
%: | |||
dh $@ | |||
override_dh_auto_install: | |||
# The upstream install target runs tic(1), and we don't want to. We could patch | |||
# the command away, but it is simpler to install the couple of files we actually | |||
# want using debhelper. Let's disable dh_auto_install. | |||
override_dh_installman: | |||
dh_installman | |||
sed -i "s/VERSION/$(DEB_VERSION_UPSTREAM)/g" $(CURDIR)/debian/stterm/usr/share/man/man1/st.1 |
@@ -0,0 +1 @@ | |||
3.0 (quilt) |
@@ -0,0 +1,2 @@ | |||
FAQ | |||
LEGACY |
@@ -0,0 +1 @@ | |||
st usr/bin |
@@ -0,0 +1,2 @@ | |||
usr/bin/st usr/bin/stterm | |||
usr/share/man/man1/st.1.gz usr/share/man/man1/stterm.1.gz |
@@ -0,0 +1 @@ | |||
st.1 |
@@ -0,0 +1,16 @@ | |||
#!/bin/sh | |||
set -e | |||
# Get rid of the old 'stterm' alternative. | |||
# Since version 0.8.1-1 the binary is called 'st'. | |||
update-alternatives --remove x-terminal-emulator /usr/bin/stterm | |||
# Install the new alternative. | |||
update-alternatives \ | |||
--install /usr/bin/x-terminal-emulator x-terminal-emulator /usr/bin/st 15 \ | |||
--slave /usr/share/man/man1/x-terminal-emulator.1.gz x-terminal-emulator.1.gz /usr/share/man/man1/st.1.gz | |||
#DEBHELPER# | |||
exit 0 |
@@ -0,0 +1,11 @@ | |||
#!/bin/sh | |||
set -e | |||
if [ "$1" = remove ] || [ "$1" = deconfigure ]; then | |||
update-alternatives --remove x-terminal-emulator /usr/bin/st | |||
fi | |||
#DEBHELPER# | |||
exit 0 |
@@ -0,0 +1,6 @@ | |||
Name: st | |||
Contact: The <dev@suckless.org> mailing list | |||
Repository: git://git.suckless.org/st | |||
Repository-Browse: https://git.suckless.org/st/i | |||
Bug-Submit: Instructions at https://suckless.org/community/ | |||
FAQ: https://git.suckless.org/st/file/FAQ.html |
@@ -0,0 +1,2 @@ | |||
version=4 | |||
opts="mode=git, pgpmode=none" git://git.suckless.org/st refs/tags/([\d\.]+) |
@@ -0,0 +1,177 @@ | |||
.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), | |||
.BR scroll (1) | |||
.SH BUGS | |||
See the TODO file in the distribution. | |||
@@ -0,0 +1,125 @@ | |||
/* 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 *scroll; | |||
extern char *stty_args; | |||
extern char *vtiden; | |||
extern wchar_t *worddelimiters; | |||
extern int allowaltscreen; | |||
extern int allowwindowops; | |||
extern char *termname; | |||
extern unsigned int tabspaces; | |||
extern unsigned int defaultfg; | |||
extern unsigned int defaultbg; |
@@ -0,0 +1,239 @@ | |||
st-mono| simpleterm monocolor, | |||
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#2, | |||
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, | |||
rin=\E[%p1%dT, | |||
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, | |||
sitm=\E[3m, | |||
sgr0=\E[0m, | |||
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, | |||
# disabled rep for now: causes some issues with older ncurses versions. | |||
# rep=%p1%c\E[%p2%{1}%-%db, | |||
# 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| simpleterm, | |||
use=st-mono, | |||
colors#8, | |||
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, | |||
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, | |||
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, | |||
st-bs| simpleterm with backspace as backspace, | |||
use=st, | |||
kbs=\010, | |||
kdch1=\177, | |||
st-bs-256color| simpleterm with backspace as backspace and 256colors, | |||
use=st-256color, | |||
kbs=\010, | |||
kdch1=\177, |
@@ -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); |