about summary refs log tree commit diff stats
path: root/docs/profanity-connect.1
diff options
context:
space:
mode:
authorMichael Vetter <jubalh@iodoru.org>2021-01-09 08:08:10 +0100
committerMichael Vetter <jubalh@iodoru.org>2021-01-09 08:08:10 +0100
commitd3820239613d0dcf6bc8e4cdd81ff7d14113c609 (patch)
tree589e6ff2dfc56400d34079dbaf86515cb56afd14 /docs/profanity-connect.1
parent8c08e64f377c9faee1abe9c663e9b2d73e7a7a45 (diff)
downloadprofani-tty-d3820239613d0dcf6bc8e4cdd81ff7d14113c609.tar.gz
Release 0.10.0
Diffstat (limited to 'docs/profanity-connect.1')
-rw-r--r--docs/profanity-connect.187
1 files changed, 87 insertions, 0 deletions
diff --git a/docs/profanity-connect.1 b/docs/profanity-connect.1
new file mode 100644
index 00000000..ecbbfb41
--- /dev/null
+++ b/docs/profanity-connect.1
@@ -0,0 +1,87 @@
+.TH man 1 "2021-01-09" "0.10.0" "Profanity XMPP client"
+
+.SH NAME
+/connect
+
+.SH DESCRIPTION
+Login to a chat service. If no account is specified, the default is used if one is configured. A local account is created with the JID as it's name if it doesn't already exist.
+
+.SH SYNOPSIS
+/connect [<account>]
+
+.LP
+/connect <account> [server <server>] [port <port>] [tls force|allow|trust|legacy|disable] [auth default|legacy]
+
+.LP
+
+.SH ARGUMENTS
+.PP
+\fB<account>\fR
+.RS 4
+The local account you wish to connect with, or a JID if connecting for the first time.
+.RE
+.PP
+\fBserver <server>\fR
+.RS 4
+Supply a server if it is different to the domain part of your JID.
+.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 default behaviour.
+.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 server's certificate.
+.RE
+.PP
+\fBtls legacy\fR
+.RS 4
+Use legacy TLS for the connection. It means server doesn't support STARTTLS and TLS is forced just after TCP connection is established.
+.RE
+.PP
+\fBtls disable\fR
+.RS 4
+Disable TLS for the connection.
+.RE
+.PP
+\fBauth default\fR
+.RS 4
+Default authentication process.
+.RE
+.PP
+\fBauth legacy\fR
+.RS 4
+Allow legacy authentication.
+.RE
+
+.SH EXAMPLES
+/connect
+
+.LP
+/connect odin@valhalla.edda
+
+.LP
+/connect odin@valhalla.edda server talk.google.com
+
+.LP
+/connect freyr@vanaheimr.edda port 5678
+
+.LP
+/connect me@localhost.test.org server 127.0.0.1 tls disable
+
+.LP
+/connect me@chatty server chatty.com port 5443
+
+.LP