rio: add PKGMESSAGE; declare ncurses DEPENDS

[ci4ic4 (via pkgsrc-wip) <commit-notify%pkgsrc.org@localhost>]

Module Name:	pkgsrc-wip
Committed By:	ci4ic4 <ci4ic4%gmail.com@localhost>
Pushed By:	ci4ic4
Date:		Sun May 24 23:09:34 2026 +0100
Changeset:	1cc2474913d64f4b5df32ca890eace7a8e1b4890

Modified Files:
	rio/Makefile
Added Files:
	rio/PKGMESSAGE

Log Message:
rio: add PKGMESSAGE; declare ncurses DEPENDS

PKGMESSAGE covers three user-visible gotchas: base-system programs
need TERM=xterm-256color (libterminfo reads only the CDB, not
TERMINFO_DIRS), shell detection from /etc/passwd, and theme placement.

DEPENDS on ncurses is now explicit: do-install calls
${LOCALBASE}/bin/tic which requires ncurses to be installed, and the
installed terminfo is only useful to ncurses-linked programs anyway.

To see a diff of this commit:
https://wip.pkgsrc.org/cgi-bin/gitweb.cgi?p=pkgsrc-wip.git;a=commitdiff;h=1cc2474913d64f4b5df32ca890eace7a8e1b4890

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

diffstat:
 rio/Makefile   |  1 +
 rio/PKGMESSAGE | 34 ++++++++++++++++++++++++++++++++++
 2 files changed, 35 insertions(+)

diffs:
diff --git a/rio/Makefile b/rio/Makefile
index d0dc383bf1..e142f57353 100644
--- a/rio/Makefile
+++ b/rio/Makefile
@@ -24,6 +24,7 @@ CARGO_FEATURES=			x11
 USE_LANGUAGES=	c c++
 
 USE_TOOLS+=	pkg-config
+DEPENDS+=		ncurses-[0-9]*:../../devel/ncurses
 
 .include "options.mk"
 
diff --git a/rio/PKGMESSAGE b/rio/PKGMESSAGE
new file mode 100644
index 0000000000..46fdaeddbb
--- /dev/null
+++ b/rio/PKGMESSAGE
@@ -0,0 +1,34 @@
+$NetBSD$
+
+===========================================================================
+Notes for rio on NetBSD
+===========================================================================
+
+TERMINAL TYPE (base system programs)
+  Rio sets TERM=xterm-rio inside the terminal.  The xterm-rio terminfo
+  entry is installed under ${PREFIX}/share/terminfo and is visible to
+  pkgsrc ncurses-linked programs (helix, zellij, etc.).
+
+  Base-system programs such as /usr/bin/vi and /usr/bin/tmux link against
+  NetBSD's own libterminfo, which reads only /usr/share/misc/terminfo.cdb
+  and does not honour TERMINFO_DIRS.  They will report "unknown terminal
+  type" or behave incorrectly with TERM=xterm-rio.
+
+  Workaround: add the following to ~/.config/rio/config.toml so that
+  spawned processes see a terminal type both databases know:
+
+    env-vars = ["TERM=xterm-256color"]
+
+SHELL
+  Rio detects the login shell from /etc/passwd.  If your display manager
+  sets $SHELL to something else, override it in config.toml:
+
+    [shell]
+    program = "/usr/pkg/bin/zsh"   # or your preferred shell
+    args = ["--login"]
+
+THEMES
+  No themes ship with this package.  User themes go in:
+    ~/.config/rio/themes/
+  See the rio documentation for the theme file format.
+===========================================================================