about summary refs log tree commit diff
path: root/extra/edit/pounce-edit.1
blob: 36c59aa3944e610ad99b94d7e135b6c542149a35 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
.Dd April  3, 2022
.Dt POUNCE-EDIT 7
.Os
.
.Sh NAME
.Nm pounce-edit
.Nd pounce configuration over IRC
.
.Sh SYNOPSIS
.Nm
.Op Fl av
.Op Fl c Ar cert
.Op Fl h Ar host
.Op Fl k Ar priv
.Op Fl p Ar port
.Op Fl t Ar trust
.Op Fl u Ar user
.Op Fl w Ar pass
.Ar config ...
.
.Sh DESCRIPTION
The
.Nm
client provides
.Xr pounce 1
configuration editing
over IRC.
It accepts commands
sent to the user's own nick.
It writes its changes
to the last configuration file
listed on the command line.
Changes do not take effect until
.Xr pounce 1
is restarted.
Configuration files
are searched for
in the same manner as
.Xr pounce 1 .
.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl a
Allow setting all options,
including those that
may render
.Xr pounce 1
inoperable.
.
.It Fl c Ar cert
Load the TLS client certificate from
.Ar cert .
If the private key
is in a separate file,
it is loaded with
.Fl k .
.
.It Fl h Ar host
Connect to
.Ar host .
The default is the value of
.Cm local-host
from the configuration files.
.
.It Fl p Ar port
Connect to
.Ar port .
The default is the value of
.Cm local-port
from the configuration files,
or 6697.
.
.It Fl t Ar trust
Trust the self-signed certificate loaded from
.Ar path
and disable server name verification.
.
.It Fl u Ar user
Set the username to
.Ar user .
The default username is
.Dq pounce-edit .
.
.It Fl v
Log IRC protocol to standard error.
.
.It Fl w Ar pass
Log in with the server password
.Ar pass .
.El
.
.Sh COMMANDS
Commands are sent as private messages
to the user's own nick.
Replies are sent as notices.
.Bl -tag -width Ds
.It Ic get Op Ar option
Show the value of an option,
or list all set options.
.It Ic restart
Restart
.Xr pounce 1 .
.It Ic set Ar option Op Ar value
Set an option.
.It Ic unset Ar option
Unset an option.
.El
.
.Sh FILES
See
.Xr pounce 1 .
.
.Sh EXAMPLES
Inherit options from
.Pa tilde.conf ,
write changes to
.Pa tilde.edit :
.Bd -literal -offset indent
$ pounce tilde.conf tilde.edit
$ pounce-edit -c local.pem tilde.conf tilde.edit
.Ed
.
.Sh AUTHORS
.An June McEnroe Aq Mt june@causal.agency
.
.Sh BUGS
Send mail to
.Aq Mt list+pounce@causal.agency
or join
.Li #ascii.town
on
.Li irc.tilde.chat .