From 79968a0aab940955ed81b0afb714706fb9ed36c8 Mon Sep 17 00:00:00 2001
From: "C. McEnroe" <june@causal.agency>
Date: Tue, 11 Aug 2020 15:43:55 -0400
Subject: contrib/palaver: Document service configuration

---
 contrib/palaver/pounce-palaver.1 | 46 +++++++++++++++++++++++++++++++++++++++-
 1 file changed, 45 insertions(+), 1 deletion(-)

(limited to 'contrib/palaver/pounce-palaver.1')

diff --git a/contrib/palaver/pounce-palaver.1 b/contrib/palaver/pounce-palaver.1
index d1776c3..187b8ee 100644
--- a/contrib/palaver/pounce-palaver.1
+++ b/contrib/palaver/pounce-palaver.1
@@ -1,4 +1,4 @@
-.Dd August 10, 2020
+.Dd August 11, 2020
 .Dt POUNCE-PALAVER 1
 .Os
 .
@@ -65,6 +65,50 @@ Connect to
 .Ar host .
 .El
 .
+.Ss Service Configuration
+Add the following to
+.Pa /etc/rc.conf
+to enable the
+.Nm
+daemon:
+.Bd -literal -offset indent
+pounce_palaver_enable="YES"
+.Ed
+.
+.Pp
+To use the preferences database of a user,
+add the following:
+.Bd -literal -offset indent
+pounce_palaver_user="user"
+pounce_palaver_env="HOME=/home/user"
+.Ed
+.
+.Pp
+The
+.Nm
+service supports profiles
+for running multiple instances.
+Set
+.Va pounce_palaver_profiles
+to a space-separated list of names.
+Flags for each profile
+will be set from
+.Va pounce_palaver_${profile}_flags .
+For example:
+.Bd -literal -offset indent
+pounce_palaver_profiles="example1 example2"
+pounce_palaver_example1_flags="example1.irc.example.org"
+pounce_palaver_example2_flags="example2.irc.example.org"
+.Ed
+.Pp
+The commands
+.Cm start , stop ,
+etc.\&
+will operate on the profile
+given as an additional argument,
+or on all profiles
+without an additional argument.
+.
 .Sh FILES
 .Bl -tag -width Ds
 .It Pa $XDG_DATA_DIRS/pounce-palaver/preferences.sqlite
-- 
cgit 1.4.1