commit 7c47d43f39bb4f4f32f11bb9311c342ca07c6df9
parent f97c5118acaae4d5116a57f474021c7faa132a1d
Author: mrgrouse <bdmfegys@duck.com>
Date: Fri, 15 Nov 2024 17:29:09 -0500
FAQ: update all instances of old st name to birdterm
Diffstat:
| M | FAQ | | | 42 | +++++++++++++++++++++--------------------- |
1 file changed, 21 insertions(+), 21 deletions(-)
diff --git a/FAQ b/FAQ
@@ -1,28 +1,28 @@
-## Why does st not handle utmp entries?
+## Why does birdterm 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!
+## Some _random program_ complains that birdterm is unknown/not recognised/unsupported/whatever!
-It means that st doesn’t have any terminfo entry on your system. Chances are
+It means that birdterm 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`.
+you can manually run `tic -sx birdterm.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
+ terminfo. What you see is the current birdtermate of the “xterm compliance”.
+* Some programs don’t complain about the lacking birdterm 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
+ * `birdterm -e tmux` using C-b [
+ * `birdterm -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/).
@@ -45,7 +45,7 @@ Taken from the terminfo manpage:
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
+In the birdterm case smkx=E[?1hE= and rmkx=E[?1lE>, so it is mandatory that
applications which want to test against keypad keys send these
sequences.
@@ -91,17 +91,17 @@ 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
+birdterm supports meta in 8bit mode, but the default terminfo entry doesn't
+use this capability. If you want it, you have to use the 'birdterm-meta' value
in TERM.
-## I cannot compile st in OpenBSD
+## I cannot compile birdterm 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
+If you want to compile birdterm for OpenBSD you have to remove -lrt from config.mk, and
+birdterm will compile without any loss of functionality, because all the functions are
included in libc on this platform.
@@ -156,7 +156,7 @@ terminal users wants its backspace to be how he feels it:
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
+ Of course, another solution is for birdterm 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
@@ -174,16 +174,16 @@ Apply [1].
[1] https://st.suckless.org/patches/delkey
-## Why do images not work in st using the w3m image hack?
+## Why do images not work in birdterm 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
+birdterm 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
+Below is a patch example to change birdterm double-buffering to a single Drawable
buffer.
diff --git a/x.c b/x.c
@@ -223,7 +223,7 @@ diff --git a/x.c b/x.c
## BadLength X error in Xft when trying to render emoji
-Xft makes st crash when rendering color emojis with the following error:
+Xft makes birdterm 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)
@@ -231,7 +231,7 @@ Xft makes st crash when rendering color emojis with the following error:
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
+This is a known bug in Xft (not birdterm) which happens on some platforms and
combination of particular fonts and fontconfig settings.
See also:
@@ -246,7 +246,7 @@ fonts:
FcPatternAddBool(fcpattern, FC_COLOR, FcFalse);
-Please don't bother reporting this bug to st, but notify the upstream Xft
+Please don't bother reporting this bug to birdterm, but notify the upstream Xft
developers about fixing this bug.
As of 2022-09-05 this now seems to be finally fixed in libXft 2.3.5:
