From ee333e06111f107d85509361463138748bace8dd Mon Sep 17 00:00:00 2001 From: Explorer09 Date: Fri, 23 Aug 2024 08:03:17 +0800 Subject: [PATCH] doc: Update netbsd/README regarding curses support Signed-off-by: Kang-Che Sung --- netbsd/README.md | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/netbsd/README.md b/netbsd/README.md index ed7be0a3d..c319c1998 100644 --- a/netbsd/README.md +++ b/netbsd/README.md @@ -13,14 +13,21 @@ NetBSD is one of the last operating systems to use and maintain its own implementation of Curses. htop(1) can be compiled against either ncurses or NetBSD's curses(3). -In order for NetBSD's libcurses to be used, htop(1) must be configured with -`--disable-unicode`. This is necessary because htop(1) with Unicode enabled -directly accesses ncurses's cchar_t struct, which has different contents -in NetBSD's curses. - -Versions of libcurses in NetBSD 9 and prior have no mouse support -(this is an ncurses extension). Newer versions contain no-op mouse functions -for compatibility with ncurses. +htop(1) would use ncurses by default when it is found, as NetBSD's curses +support in htop is limited. + +To use NetBSD's libcurses, htop(1) must be configured with `--disable-unicode`. +Starting with htop 3.4.0, a new option `--with-curses=curses` may be specified +to let `configure` skip ncurses when both libraries are installed. + +Technical caveats regarding NetBSD's curses support: + +* htop with Unicode enabled directly accesses ncurses's `cchar_t` struct, which + has different contents in NetBSD's curses. + +* Versions of libcurses in NetBSD 9 and prior have no mouse support + (this is an ncurses extension). Newer versions contain no-op mouse functions + for compatibility with ncurses. What needs improvement ---