jitsi-meet: Provide instructions

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

Module Name:	pkgsrc-wip
Committed By:	Greg Troxel <gdt%lexort.com@localhost>
Pushed By:	gdt
Date:		Mon Mar 3 09:43:03 2025 -0500
Changeset:	5066c61a552a5fb64b3c39a58cee52d7564e353f

Modified Files:
	jitsi-meet/Makefile
	jitsi-meet/PLIST
	jitsi-meet/TODO
Added Files:
	jitsi-meet/files/README.pkgsrc

Log Message:
jitsi-meet: Provide instructions

Install a README.pkgsrc in $docdir with a caution that this is not
easy, pointers to upstream docs, and various web postings.

Drop TODO about instructions, as what's hard is not about pkgsrc.

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

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

diffstat:
 jitsi-meet/Makefile            |  4 +++-
 jitsi-meet/PLIST               |  1 +
 jitsi-meet/TODO                |  2 --
 jitsi-meet/files/README.pkgsrc | 26 ++++++++++++++++++++++++++
 4 files changed, 30 insertions(+), 3 deletions(-)

diffs:
diff --git a/jitsi-meet/Makefile b/jitsi-meet/Makefile
index 99d455d610..cce3cdca7b 100644
--- a/jitsi-meet/Makefile
+++ b/jitsi-meet/Makefile
@@ -26,7 +26,7 @@ CONF_FILES+=		${EGDIR}/title.html ${PKG_SYSCONFDIR}/title.html
 # \todo Explain how this variable makes its way into the package.
 BUILD_DEFS+=		VARBASE
 
-INSTALLATION_DIRS=	${EGDIR} share/examples/jitsi-meet
+INSTALLATION_DIRS=	${EGDIR} share/examples/jitsi-meet share/doc/jitsi-meet
 
 do-configure:
 	cd ${WRKSRC} && \
@@ -47,5 +47,7 @@ post-install:
 		${DESTDIR}${PREFIX}/share/examples/jitsi-meet/interface_config.js
 	${INSTALL_DATA} ${WRKSRC}/title.html \
 		${DESTDIR}${PREFIX}/share/examples/jitsi-meet/title.html
+	${INSTALL_DATA} files/README.pkgsrc \
+		${DESTDIR}${PREFIX}/share/doc/jitsi-meet/README.pkgsrc
 
 .include "../../mk/bsd.pkg.mk"
diff --git a/jitsi-meet/PLIST b/jitsi-meet/PLIST
index 0b8073c543..506d47d479 100644
--- a/jitsi-meet/PLIST
+++ b/jitsi-meet/PLIST
@@ -1,4 +1,5 @@
 @comment $NetBSD$
+share/doc/jitsi-meet/README.pkgsrc
 share/examples/jitsi-meet/config.js
 share/examples/jitsi-meet/interface_config.js
 share/examples/jitsi-meet/title.html
diff --git a/jitsi-meet/TODO b/jitsi-meet/TODO
index 455f5401a4..72459c9725 100644
--- a/jitsi-meet/TODO
+++ b/jitsi-meet/TODO
@@ -4,8 +4,6 @@
 - Excise google analytics, following pkgsrc's norm of removing
   phone-home code.
 
-- Provide installation instructions.
-
 - No longer pull data from the network (see www/gitea)
 
 - Resolve chat/jitsi-meet/Makefile.common setting DISTINFO_FILE but
diff --git a/jitsi-meet/files/README.pkgsrc b/jitsi-meet/files/README.pkgsrc
new file mode 100644
index 0000000000..08c341e40b
--- /dev/null
+++ b/jitsi-meet/files/README.pkgsrc
@@ -0,0 +1,26 @@
+$NetBSD$
+
+First, understand that installing jitsi-meet is an advanced-level
+system administration activity.  There is very little about jitsi-meet
+that is specific to pkgsrc.
+
+Read the upstream installation and configuration instructions:
+
+  https://jitsi.github.io/handbook/docs/devops-guide/
+
+Note that, surprisingly, there are no instructions for nginx
+configuration.  Apparently that is within the Debian packages, and
+reading that (after finding it) is likely helpful.  The following
+link, old and not validated, may also be helpful:
+
+  https://pub.nethence.com/chat/jitsi-meet-nginx
+
+Using prosody is the standard approach, documented by upstream.
+Multiple old web pages explain how to use ejabberd instead:
+
+  https://blog.windfluechter.net/content/blog/2020/06/19/1759-jitsi-meet-and-ejabberd
+  https://blog.jabberhead.tk/2020/03/16/install-jitsi-meet-alongside-ejabberd/
+
+An old configuration example:
+
+  https://github.com/debalance/meet.debalance.de/tree/master/etc