about summary refs log tree commit diff stats
path: root/docs/profanity-register.1
diff options
context:
space:
mode:
Diffstat (limited to 'docs/profanity-register.1')
-rw-r--r--docs/profanity-register.168
1 files changed, 68 insertions, 0 deletions
diff --git a/docs/profanity-register.1 b/docs/profanity-register.1
new file mode 100644
index 00000000..51671eef
--- /dev/null
+++ b/docs/profanity-register.1
@@ -0,0 +1,68 @@
+.TH man 1 "2022-10-12" "0.13.0" "Profanity XMPP client"
+
+.SH NAME
+/register
+
+.SH DESCRIPTION
+Register an account on a server.
+
+.SH SYNOPSIS
+/register <username> <server> [port <port>] [tls force|allow|trust|legacy|disable]
+
+.LP
+
+.SH ARGUMENTS
+.PP
+\fB<username>\fR
+.RS 4
+Username to register with.
+.RE
+.PP
+\fB<server>\fR
+.RS 4
+Server to register account on.
+.RE
+.PP
+\fBport <port>\fR
+.RS 4
+The port to use if different to the default (5222, or 5223 for SSL).
+.RE
+.PP
+\fBtls force\fR
+.RS 4
+Force TLS connection, and fail if one cannot be established. This is the default behavior.
+.RE
+.PP
+\fBtls allow\fR
+.RS 4
+Use TLS for the connection if it is available.
+.RE
+.PP
+\fBtls trust\fR
+.RS 4
+Force TLS connection and trust the server's certificate.
+.RE
+.PP
+\fBtls legacy\fR
+.RS 4
+Use legacy TLS for the connection. This forces TLS just after the TCP connection is established. Use when a server doesn't support STARTTLS.
+.RE
+.PP
+\fBtls disable\fR
+.RS 4
+Disable TLS for the connection.
+.RE
+
+.SH EXAMPLES
+/register odin valhalla.edda 
+
+.LP
+/register freyr vanaheimr.edda port 5678
+
+.LP
+/register me 127.0.0.1 tls disable
+
+.LP
+/register someuser my.xmppserv.er port 5443 tls force
+
+.LP