rio: replace PKGMESSAGE with files/README.NetBSD

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

Module Name:	pkgsrc-wip
Committed By:	ci4ic4 <ci4ic4%gmail.com@localhost>
Pushed By:	ci4ic4
Date:		Mon May 25 09:02:51 2026 +0100
Changeset:	698fdbd3b79eee7614b4a4090ed6ba5fb69edffa

Modified Files:
	rio/Makefile
	rio/PLIST
Added Files:
	rio/files/README.NetBSD
Removed Files:
	rio/PKGMESSAGE

Log Message:
rio: replace PKGMESSAGE with files/README.NetBSD

PKGMESSAGE is reserved for critical warnings; operational notes
belong in a README file installed under share/doc/<pkg>/.

- Remove PKGMESSAGE
- Add files/README.NetBSD with terminal-type, shell, and theme notes
- Install it to share/doc/rio/ via do-install
- Add share/doc/rio to INSTALLATION_DIRS and PLIST

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

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

diffstat:
 rio/Makefile            |  5 ++++-
 rio/PKGMESSAGE          | 34 ----------------------------------
 rio/PLIST               |  1 +
 rio/files/README.NetBSD | 26 ++++++++++++++++++++++++++
 4 files changed, 31 insertions(+), 35 deletions(-)

diffs:
diff --git a/rio/Makefile b/rio/Makefile
index e142f57353..fe6880d398 100644
--- a/rio/Makefile
+++ b/rio/Makefile
@@ -48,7 +48,8 @@ SUBST_VARS.terminfo-dirs=	PREFIX
 INSTALLATION_DIRS+=	bin \
 			share/applications \
 			share/icons/hicolor/scalable/apps \
-			share/terminfo
+			share/terminfo \
+			share/doc/rio
 
 
 # Patch vendor crates to enable wgpu GLES backend on NetBSD.
@@ -97,6 +98,8 @@ do-install:
 	# Install terminfo so programs inside rio recognise TERM=xterm-rio.
 	${LOCALBASE}/bin/tic -x -o ${DESTDIR}${PREFIX}/share/terminfo \
 		${WRKSRC}/misc/rio.terminfo
+	${INSTALL_DATA} ${FILESDIR}/README.NetBSD \
+		${DESTDIR}${PREFIX}/share/doc/rio/README.NetBSD
 .if !empty(PKG_OPTIONS:Mman)
 	# Build and install man pages from scdoc source in extra/man/.
 	${SCDOC} < ${WRKSRC}/extra/man/rio.1.scd > \
diff --git a/rio/PKGMESSAGE b/rio/PKGMESSAGE
deleted file mode 100644
index 46fdaeddbb..0000000000
--- a/rio/PKGMESSAGE
+++ /dev/null
@@ -1,34 +0,0 @@
-$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.
-===========================================================================
diff --git a/rio/PLIST b/rio/PLIST
index e20391352c..5ee4d56e74 100644
--- a/rio/PLIST
+++ b/rio/PLIST
@@ -4,6 +4,7 @@ share/applications/rio.desktop
 share/icons/hicolor/scalable/apps/rio.svg
 share/terminfo/r/rio+base
 share/terminfo/x/xterm-rio
+share/doc/rio/README.NetBSD
 ${PLIST.man}man/man1/rio.1
 ${PLIST.man}man/man5/rio-bindings.5
 ${PLIST.man}man/man5/rio.5
diff --git a/rio/files/README.NetBSD b/rio/files/README.NetBSD
new file mode 100644
index 0000000000..a9e9e86d6d
--- /dev/null
+++ b/rio/files/README.NetBSD
@@ -0,0 +1,26 @@
+$NetBSD$
+
+TERMINAL TYPE
+  Rio installs xterm-rio and rio+base terminfo entries under
+  ${PREFIX}/share/terminfo.  These are found by pkgsrc ncurses-linked
+  programs.  Base-system programs (/usr/bin/vi, /usr/bin/tmux, etc.)
+  link against NetBSD's libterminfo, which reads only
+  /usr/share/misc/terminfo.cdb and ignores TERMINFO_DIRS.  They will
+  report "unknown terminal type" with TERM=xterm-rio.
+
+  To use a universally-known terminal type, add to ~/.config/rio/config.toml:
+
+    env-vars = ["TERM=xterm-256color"]
+
+SHELL DETECTION
+  Rio reads the login shell from /etc/passwd.  Some display managers
+  (including MATE) inherit a different $SHELL into the X session.  If
+  rio starts the wrong shell, set it explicitly in config.toml:
+
+    [shell]
+    program = "/usr/pkg/bin/zsh"   # adjust to your login shell
+    args = ["--login"]
+
+THEMES
+  No themes ship with this package.  User themes belong in
+  ~/.config/rio/themes/; see the upstream documentation for the format.