Skip to content

Commit 8a6e519

Browse files
Explorer09BenBE
authored andcommitted
doc: Update netbsd/README regarding curses support
Signed-off-by: Kang-Che Sung <[email protected]>
1 parent c34fb93 commit 8a6e519

File tree

1 file changed

+15
-8
lines changed

1 file changed

+15
-8
lines changed

netbsd/README.md

+15-8
Original file line numberDiff line numberDiff line change
@@ -13,14 +13,21 @@ NetBSD is one of the last operating systems to use and maintain its own
1313
implementation of Curses.
1414

1515
htop(1) can be compiled against either ncurses or NetBSD's curses(3).
16-
In order for NetBSD's libcurses to be used, htop(1) must be configured with
17-
`--disable-unicode`. This is necessary because htop(1) with Unicode enabled
18-
directly accesses ncurses's cchar_t struct, which has different contents
19-
in NetBSD's curses.
20-
21-
Versions of libcurses in NetBSD 9 and prior have no mouse support
22-
(this is an ncurses extension). Newer versions contain no-op mouse functions
23-
for compatibility with ncurses.
16+
By default, htop(1) will use ncurses when it is found, as support for NetBSD's
17+
curses in htop is limited.
18+
19+
To use NetBSD's libcurses, htop(1) must be configured with `--disable-unicode`.
20+
Starting with htop 3.4.0, a new option `--with-curses=curses` may be specified
21+
to let `configure` skip ncurses when both libraries are installed.
22+
23+
Technical caveats regarding NetBSD's curses support:
24+
25+
* htop with Unicode enabled directly accesses ncurses's `cchar_t` struct, which
26+
has different contents in NetBSD's curses.
27+
28+
* Versions of libcurses in NetBSD 9 and prior have no mouse support
29+
(this is an ncurses extension). Newer versions contain no-op mouse functions
30+
for compatibility with ncurses.
2431

2532
What needs improvement
2633
---

0 commit comments

Comments
 (0)