about summary refs log tree commit diff stats
path: root/docs/profanity-rooms.1
diff options
context:
space:
mode:
Diffstat (limited to 'docs/profanity-rooms.1')
-rw-r--r--docs/profanity-rooms.160
1 files changed, 60 insertions, 0 deletions
diff --git a/docs/profanity-rooms.1 b/docs/profanity-rooms.1
new file mode 100644
index 00000000..ba6e46b8
--- /dev/null
+++ b/docs/profanity-rooms.1
@@ -0,0 +1,60 @@
+.TH man 1 "2022-10-12" "0.13.0" "Profanity XMPP client"
+
+.SH NAME
+/rooms
+
+.SH DESCRIPTION
+List the chat rooms available at the specified conference service. If no argument is supplied, the account preference 'muc.service' is used, 'conference.<domain-part>' by default. The filter argument only shows rooms that contain the provided text, case insensitive.
+
+.SH SYNOPSIS
+/rooms
+
+.LP
+/rooms filter <text>
+
+.LP
+/rooms service <service>
+
+.LP
+/rooms service <service> filter <text>
+
+.LP
+/rooms cache on|off|clear
+
+.LP
+
+.SH ARGUMENTS
+.PP
+\fBservice <service>\fR
+.RS 4
+The conference service to query.
+.RE
+.PP
+\fBfilter <text>\fR
+.RS 4
+The text to filter results by.
+.RE
+.PP
+\fBcache on|off\fR
+.RS 4
+Enable or disable caching of rooms list response, enabled by default.
+.RE
+.PP
+\fBcache clear\fR
+.RS 4
+Clear the rooms response cache if enabled.
+.RE
+
+.SH EXAMPLES
+/rooms
+
+.LP
+/rooms filter development
+
+.LP
+/rooms service conference.jabber.org
+
+.LP
+/rooms service conference.jabber.org filter "News Room"
+
+.LP