From 4c5a1ceefa91a079a2369a79839e26c7929ec237 Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Wed, 12 May 2021 12:24:29 +0530 Subject: [PATCH] Add a FAQ entry for why one should never output binary data into terminals --- docs/faq.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/faq.rst b/docs/faq.rst index e87b7c352..d703609ae 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -170,6 +170,17 @@ You can, of course, also run |kitty| from a terminal with command line options, And within |kitty| itself, you can always run |kitty| using just `kitty` as it cleverly adds itself to the ``PATH``. +I catted a binary file and now kitty is hung? +----------------------------------------------- + +**Never** output unknown binary data directly into a terminal. + +Terminals have a single channel for both data and control. Certain bytes +are control codes. Some of these control codes are of arbitrary length, so +if the binary data you output into the terminal happens to contain the starting +sequence for one of these control codes, the terminal will hang waiting for +the closing sequence. Press :kbd:`ctrl+shift+delete` to reset the terminal. + kitty is not able to use my favorite font? ---------------------------------------------