From: Josh Grosse <josh@jggimi.net>
Subject: add README-main to net/transmission
To: ports@openbsd.org
Date: Mon, 30 Mar 2026 09:15:54 -0400

Attached is a diff to add pkg/README-main to net/transmission,
and includes a revision bump and PLIST-main revision.

The default "daemon" class does not always have sufficient resources
for transmission_daemon.  This documents how to add a login class
when needed.

OKs?  Alternative recommendations?
diff --git net/transmission/Makefile net/transmission/Makefile
index 0a76f8c469a..d26bc6ee2c5 100644
--- net/transmission/Makefile
+++ net/transmission/Makefile
@@ -3,6 +3,7 @@ COMMENT-gtk=	BitTorrent client with GTK+ interface
 COMMENT-qt=	BitTorrent client with Qt interface
 
 VER=		4.1.1
+REVISION=	0
 DISTNAME=	transmission-${VER}
 PKGNAME-main=	transmission-${VER}
 PKGNAME-gtk=	transmission-gtk-${VER}
diff --git net/transmission/pkg/PLIST-main net/transmission/pkg/PLIST-main
index 7710a51aec0..cf57d80073b 100644
--- net/transmission/pkg/PLIST-main
+++ net/transmission/pkg/PLIST-main
@@ -22,6 +22,7 @@
 @man man/man1/transmission-remote.1
 @man man/man1/transmission-show.1
 @comment share/applications/
+share/doc/pkg-readmes/${PKGSTEM}
 share/doc/transmission/
 share/doc/transmission/AUTHORS
 share/doc/transmission/COPYING
diff --git net/transmission/pkg/README-main net/transmission/pkg/README-main
new file mode 100644
index 00000000000..08950271ceb
--- /dev/null
+++ net/transmission/pkg/README-main
@@ -0,0 +1,17 @@
++-------------------------------------------------------------------------------
+| Running ${PKGSTEM} on OpenBSD
++-------------------------------------------------------------------------------
+
+Daemons started via rcctl(8) and the rc.subr(5) script system will use
+the "daemon" login class by default, unless there is a login class name
+that matches the script name.
+
+Should you need to run transmission_daemon with more resources than those
+of the "daemon" login class, create a "transmission_daemon" class in
+login.conf(5).  For example, this entry will use the "daemon" class for
+initial settings, and then set 512 current and 1024 max file descriptors:
+
+transmission_daemon:\
+        :openfiles-cur=512:\
+        :openfiles-max=1024:\
+        :tc=daemon: