From a4481e884d8b6cd558abe272456bf2319f8fb376 Mon Sep 17 00:00:00 2001 From: "C. McEnroe" Date: Mon, 10 Aug 2020 15:36:46 -0400 Subject: contrib/palaver: Add prospective manual page --- contrib/palaver/pounce-palaver.1 | 98 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 98 insertions(+) create mode 100644 contrib/palaver/pounce-palaver.1 (limited to 'contrib') diff --git a/contrib/palaver/pounce-palaver.1 b/contrib/palaver/pounce-palaver.1 new file mode 100644 index 0000000..d1776c3 --- /dev/null +++ b/contrib/palaver/pounce-palaver.1 @@ -0,0 +1,98 @@ +.Dd August 10, 2020 +.Dt POUNCE-PALAVER 1 +.Os +. +.Sh NAME +.Nm pounce-palaver +.Nd Palaver push notifications for pounce +. +.Sh SYNOPSIS +.Nm +.Op Fl v +.Op Fl c Ar cert +.Op Fl d Ar path +.Op Fl k Ar priv +.Op Fl p Ar port +.Op Fl u Ar user +.Op Fl w Ar pass +.Ar host +. +.Sh DESCRIPTION +The +.Nm +daemon provides push notifications +for the Palaver IRC app via the +.Xr pounce 1 +IRC bouncer. +The +.Cm palaver +option must be enabled in +.Xr pounce 1 . +. +.Pp +The arguments are as follows: +.Bl -tag -width Ds +.It Fl c Ar cert +Load the TLS client certificate from +.Ar path . +If the private key is in a separate file, +it is loaded with +.Fl k . +.It Fl d Ar path +Set the path to the database file +used to store notification preferences. +The default path is documented in +.Sx FILES . +.It Fl k Ar priv +Load the TLS client private key from +.Ar path . +.It Fl p Ar port +Connect to +.Ar port . +The default port is 6697. +.It Fl u Ar user +Set the username to +.Ar user . +The default username is +.Dq pounce-palaver . +.It Fl v +Log IRC protocol, SQL and HTTP to standard error. +.It Fl w Ar pass +Log in with the server password +.Ar pass . +.It Ar host +Connect to +.Ar host . +.El +. +.Sh FILES +.Bl -tag -width Ds +.It Pa $XDG_DATA_DIRS/pounce-palaver/preferences.sqlite +The database file is searched for first in +.Ev $XDG_DATA_HOME , +usually +.Pa ~/.local/share , +followed by the colon-separated list of paths +.Ev $XDG_DATA_DIRS , +usually +.Pa /usr/local/share:/usr/share . +.It Pa ~/.local/share/pounce-palaver/preferences.sqlite +The most likely default path to the database file. +.El +. +.Sh SEE ALSO +.Xr pounce 1 +. +.Sh STANDARDS +.Lk https://github.com/cocodelabs/palaver-irc-capability "Palaver IRC Capability" +. +.Sh AUTHORS +.An June Bug Aq Mt june@causal.agency +. +.Sh BUGS +Send mail to +.Aq Mt list+pounce@causal.agency +or join +.Li #ascii.town +on +.Li chat.freenode.net . -- cgit 1.4.1 ='2020-06-17 17:47:54 -0400'>2020-06-17Remove aesJune McEnroe 2020-06-16Fix doas checkJune McEnroe 2020-06-16Add LC_COLLATE=C to ls aliasJune McEnroe 2020-06-11Fix pbd for neovimJune McEnroe 2020-06-11Alias sudo=doas if availableJune McEnroe 2020-06-11Add all VMs to ssh configJune McEnroe 2020-06-08Add additional permission for linking with LibreSSLJune McEnroe 2020-06-08Replace __DECONST with regular castsJune McEnroe 2020-06-08Replace __printflike with __attribute__((format(printf, ...)))June McEnroe 2020-06-08Replace __dead2 with __attribute__((noreturn))June McEnroe 2020-06-08Replace __FBSDID macros with commentsJune McEnroe 2020-06-08Remove reference to FreeBSD-specific libedit hackJune McEnroe 2020-06-08Prefix mandoc with exec in about-filterJune McEnroe 2020-06-07Remove mktemp options from mkbuiltins, mktokensJune McEnroe 2020-06-07Cast z_stream fields to size_tJune McEnroe 2020-06-07Call static_assert by _Static_assertJune McEnroe 2020-06-07Add OpenBSD to install.shJune McEnroe 2020-06-03Add The Song of AchillesJune McEnroe 2020-06-01Allow redirecting input in everJune McEnroe 2020-05-31Add %c conversion to c scriptJune McEnroe 2020-05-31Add c script to READMEJune McEnroe 2020-05-31Add c scriptJune McEnroe 2020-05-31Update mdoc source URLsJune McEnroe 2020-05-26Remove unfinished PSF fontsJune McEnroe