From 5ae2d2af232ff77020935ab26fa67151e637c610 Mon Sep 17 00:00:00 2001 From: nick black Date: Wed, 27 Oct 2021 20:42:01 -0400 Subject: [PATCH] [README] kill duplicate FAQ, use a href syntax in FAQs --- README.md | 23 ++++++++--------------- 1 file changed, 8 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index 0eab6b33c..a10b5608c 100644 --- a/README.md +++ b/README.md @@ -217,8 +217,8 @@ each release. Download it, and install the contents as you deem fit. Glyph width, and indeed whether a glyph can be displayed at all, is dependent in part on the font configuration. Ideally, your font configuration has a -glyph for every Unicode EGC, and each glyph's width matches up with the C -library's `wcswidth()` result for the EGC. If this is not the case, you'll +glyph for every Unicode EGC, and each glyph's width matches up with the POSIX +function's `wcswidth()` result for the EGC. If this is not the case, you'll likely get blanks or � (U+FFFD, REPLACEMENT CHARACTER) for missing characters, and subsequent characters on the line may be misplaced. @@ -235,8 +235,8 @@ inspect your environment's rendering of drawing characters, run ## FAQs If things break or seem otherwise lackluster, **please** consult the -[Environment Notes](#environment-notes) section! You **need** to have a correct -`TERM` and `LANG` definition, and probably want `COLORTERM`. +[Environment Notes](#environment-notes) section! You **need** correct +`TERM` and `LANG` definitions, and might want `COLORTERM`.
Can I write a CLI program (scrolling, fits in with the shell, etc.) @@ -317,7 +317,8 @@ If things break or seem otherwise lackluster, **please** consult the
I'm getting strange and/or duplicate inputs in Kitty. - Notcurses supports Kitty's powerful [keyboard protocol](https://sw.kovidgoyal.net/kitty/keyboard-protocol/), + Notcurses supports Kitty's powerful + keyboard protocol, which includes things like key release events and modifier keypresses by themselves. This means, among other things, that a program in Kitty will usually immediately get an NC_ENTER NCTYPE_RELEASE @@ -480,7 +481,8 @@ If things break or seem otherwise lackluster, **please** consult the
Notcurses exits immediately in MSYS2/Cygwin. - Notcurses requires the [Windows ConPTY](https://devblogs.microsoft.com/commandline/windows-command-line-introducing-the-windows-pseudo-console-conpty/) + Notcurses requires the + Windows ConPTY layer. This is available in Cygwin by default since 3.2.0, but is disabled by default in MSYS. Launch mintty with -P on arguments, or export MSYS=enable_pcon before launching it. @@ -535,15 +537,6 @@ If things break or seem otherwise lackluster, **please** consult the writes directly into a memory map.
-
- I get a NCKEY_ENTER immediately after launching a Notcurses - program, but I didn't press Enter. - When the Kitty keyboard disambiguation protocol is in use, events are - generated for both the press and release of keys. If you launched - your program from an interactive shell, you almost certainly released - enter after the program was launched. -
- ## Useful links * [BiDi in Terminal Emulators](https://terminal-wg.pages.freedesktop.org/bidi/)