aniani
/
profanity
mirror of https://github.com/profanity-im/profanity.git
1
0
Fork 0
Code

Start new cycle

This commit is contained in:
Michael Vetter 2023-08-03 08:06:05 +02:00
parent 6b0fddd925
commit b223b7ebac
105 changed files with 1 additions and 6169 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
configure.ac
View File

@ -24,7 +24,7 @@ AS_CASE([$target_os],
AM_INIT_AUTOMAKE([foreign subdir-objects])
PACKAGE_STATUS="release"
PACKAGE_STATUS="development"
## Get git branch and revision if in development
if test "x$PACKAGE_STATUS" = xdevelopment; then

12
docs/profanity-about.1
View File

@ -1,12 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/about
.SH DESCRIPTION
Show version and license information.
.SH SYNOPSIS
/about
.LP

388
docs/profanity-account.1
View File

@ -1,388 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/account
.SH DESCRIPTION
Commands for creating and managing accounts. Calling with no arguments will display information for the current account.
.SH SYNOPSIS
/account
.LP
/account list
.LP
/account show <account>
.LP
/account enable|disable <account>
.LP
/account default set <account>
.LP
/account default off
.LP
/account add <account>
.LP
/account remove <account>
.LP
/account rename <account> <newaccount>
.LP
/account set <account> jid <jid>
.LP
/account set <account> server <server>
.LP
/account set <account> port <port>
.LP
/account set <account> status <presence>
.LP
/account set <account> status last
.LP
/account set <account> <presence> <priority>
.LP
/account set <account> resource <resource>
.LP
/account set <account> password <password>
.LP
/account set <account> eval_password <command>
.LP
/account set <account> muc <service>
.LP
/account set <account> nick <nick>
.LP
/account set <account> otr <policy>
.LP
/account set <account> pgpkeyid <pgpkeyid>
.LP
/account set <account> startscript <script>
.LP
/account set <account> clientid "<name> <version>"
.LP
/account set <account> tls force|allow|trust|legacy|disable
.LP
/account set <account> auth default|legacy
.LP
/account set <account> theme <theme>
.LP
/account set <account> session_alarm <max_sessions>
.LP
/account clear <account> password
.LP
/account clear <account> eval_password
.LP
/account clear <account> server
.LP
/account clear <account> port
.LP
/account clear <account> otr
.LP
/account clear <account> pgpkeyid
.LP
/account clear <account> startscript
.LP
/account clear <account> clientid
.LP
/account clear <account> muc
.LP
/account clear <account> resource
.LP
/account clear <account> session_alarm
.LP
.SH ARGUMENTS
.PP
\fBlist\fR
.RS 4
List all accounts.
.RE
.PP
\fBenable <account>\fR
.RS 4
Enable the account, it will be used for autocompletion.
.RE
.PP
\fBshow <account>\fR
.RS 4
Show details for the specified account.
.RE
.PP
\fBdisable <account>\fR
.RS 4
Disable the account.
.RE
.PP
\fBdefault set <account>\fR
.RS 4
Set the default account, used when no argument passed to the /connect command.
.RE
.PP
\fBdefault off\fR
.RS 4
Clear the default account setting.
.RE
.PP
\fBadd <account>\fR
.RS 4
Create a new account.
.RE
.PP
\fBremove <account>\fR
.RS 4
Remove an account.
.RE
.PP
\fBrename <account> <newaccount>\fR
.RS 4
Rename 'account' to 'newaccount'.
.RE
.PP
\fBset <account> jid <jid>\fR
.RS 4
Set the Jabber ID for the account, account name will be used if not set.
.RE
.PP
\fBset <account> server <server>\fR
.RS 4
The chat server, if different to the domainpart of the JID.
.RE
.PP
\fBset <account> port <port>\fR
.RS 4
The port used for connecting if not the default (5222, or 5223 for SSL).
.RE
.PP
\fBset <account> status <presence>\fR
.RS 4
The presence status to use on login.
.RE
.PP
\fBset <account> status last\fR
.RS 4
Use your last status before logging out, when logging in.
.RE
.PP
\fBset <account> <presence> <priority>\fR
.RS 4
Set the priority (-128..127) to use for the specified presence.
.RE
.PP
\fBset <account> resource <resource>\fR
.RS 4
The resource to be used for this account, defaults to 'profanity'.
.RE
.PP
\fBset <account> password <password>\fR
.RS 4
Password for the account, note this is currently stored in plaintext if set.
.RE
.PP
\fBset <account> eval_password <command>\fR
.RS 4
Shell command evaluated to retrieve password for the account. Can be used to retrieve password from keyring.
.RE
.PP
\fBset <account> muc <service>\fR
.RS 4
The default MUC chat service to use, defaults to the servers disco info response.
.RE
.PP
\fBset <account> nick <nick>\fR
.RS 4
The default nickname to use when joining chat rooms.
.RE
.PP
\fBset <account> otr <policy>\fR
.RS 4
Override global OTR policy for this account, see /otr.
.RE
.PP
\fBset <account> pgpkeyid <pgpkeyid>\fR
.RS 4
Set the ID of the PGP key for this account, see /pgp.
.RE
.PP
\fBset <account> startscript <script>\fR
.RS 4
Set the script to execute after connecting.
.RE
.PP
\fBset <account> clientid "<name> <version>"\fR
.RS 4
Set XMPP client name for discovery according to XEP-0092. For privacy geeks. Recommendation to leave as is.
.RE
.PP
\fBset <account> tls force\fR
.RS 4
Force TLS connection, and fail if one cannot be established, this is default behaviour.
.RE
.PP
\fBset <account> tls allow\fR
.RS 4
Use TLS for the connection if it is available.
.RE
.PP
\fBset <account> tls trust\fR
.RS 4
Force TLS connection and trust server's certificate.
.RE
.PP
\fBset <account> tls 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
\fBset <account> tls disable\fR
.RS 4
Disable TLS for the connection.
.RE
.PP
\fBset <account> auth default\fR
.RS 4
Use default authentication process.
.RE
.PP
\fBset <account> auth legacy\fR
.RS 4
Allow legacy authentication.
.RE
.PP
\fBset <account> theme <theme>\fR
.RS 4
Set the UI theme for the account.
.RE
.PP
\fBset <account> session_alarm <max_sessions>\fR
.RS 4
Alarm about suspicious activity if sessions count exceeds max_sessions.
.RE
.PP
\fBclear <account> server\fR
.RS 4
Remove the server setting for this account.
.RE
.PP
\fBclear <account> port\fR
.RS 4
Remove the port setting for this account.
.RE
.PP
\fBclear <account> password\fR
.RS 4
Remove the password setting for this account.
.RE
.PP
\fBclear <account> eval_password\fR
.RS 4
Remove the eval_password setting for this account.
.RE
.PP
\fBclear <account> otr\fR
.RS 4
Remove the OTR policy setting for this account.
.RE
.PP
\fBclear <account> pgpkeyid\fR
.RS 4
Remove pgpkeyid associated with this account.
.RE
.PP
\fBclear <account> startscript\fR
.RS 4
Remove startscript associated with this account.
.RE
.PP
\fBclear <account> clientid\fR
.RS 4
Reset client's name to default.
.RE
.PP
\fBclear <account> theme\fR
.RS 4
Clear the theme setting for the account, the global theme will be used.
.RE
.PP
\fBclear <account> resource\fR
.RS 4
Remove the resource setting for this account.
.RE
.PP
\fBclear <account> muc\fR
.RS 4
Remove the default MUC service setting.
.RE
.PP
\fBclear <account> session_alarm\fR
.RS 4
Disable the session alarm.
.RE
.SH EXAMPLES
/account add me
.LP
/account set me jid ulfhednar@valhalla.edda
.LP
/account set me server talk.chat.com
.LP
/account set me port 5111
.LP
/account set me muc chatservice.mycompany.com
.LP
/account set me nick dennis
.LP
/account set me status dnd
.LP
/account set me dnd -1
.LP
/account set me clientid "Profanity 0.42 (Dev)"
.LP
/account rename me chattyme
.LP
/account clear me pgpkeyid
.LP

43
docs/profanity-affiliation.1
View File

@ -1,43 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/affiliation
.SH DESCRIPTION
Manage room affiliations. Affiliation may be one of owner, admin, member, outcast or none.
.SH SYNOPSIS
/affiliation set <affiliation> <jid> [<reason>]
.LP
/affiliation list [<affiliation>]
.LP
/affiliation request
.LP
/affiliation register
.LP
.SH ARGUMENTS
.PP
\fBset <affiliation> <jid> [<reason>]\fR
.RS 4
Set the affiliation of user with jid, with an optional reason.
.RE
.PP
\fBlist [<affiliation>]\fR
.RS 4
List all users with the specified affiliation, or all if none specified.
.RE
.PP
\fBrequest\fR
.RS 4
Request voice.
.RE
.PP
\fBregister\fR
.RS 4
Register your nickname with the MUC.
.RE

52
docs/profanity-alias.1
View File

@ -1,52 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/alias
.SH DESCRIPTION
Add, remove or list command aliases.
.SH SYNOPSIS
/alias list
.LP
/alias add <name> <value>
.LP
/alias remove <name>
.LP
.SH ARGUMENTS
.PP
\fBlist\fR
.RS 4
List all aliases.
.RE
.PP
\fBadd <name> <value>\fR
.RS 4
Add a new command alias.
.RE
.PP
\fBremove <name>\fR
.RS 4
Remove a command alias.
.RE
.SH EXAMPLES
/alias add friends /who online friends
.LP
/alias add /q /quit
.LP
/alias add a /away "I'm in a meeting."
.LP
/alias remove q
.LP
/alias list
.LP

93
docs/profanity-autoaway.1
View File

@ -1,93 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/autoaway
.SH DESCRIPTION
Manage autoaway settings for idle time.
.SH SYNOPSIS
/autoaway mode idle|away|off
.LP
/autoaway time away|xa <minutes>
.LP
/autoaway message away|xa <message>|off
.LP
/autoaway check on|off
.LP
.SH ARGUMENTS
.PP
\fBmode idle\fR
.RS 4
Sends idle time, status remains online.
.RE
.PP
\fBmode away\fR
.RS 4
Sends away and xa presence as well as idle time.
.RE
.PP
\fBmode off\fR
.RS 4
Disabled (default).
.RE
.PP
\fBtime away <minutes>\fR
.RS 4
Number of minutes before the away presence is sent, default: 15.
.RE
.PP
\fBtime xa <minutes>\fR
.RS 4
Number of minutes before the xa presence is sent, default: 0 (disabled).
.RE
.PP
\fBmessage away <message>\fR
.RS 4
Optional message to send with the away presence, default: off (disabled).
.RE
.PP
\fBmessage xa <message>\fR
.RS 4
Optional message to send with the xa presence, default: off (disabled).
.RE
.PP
\fBmessage away off\fR
.RS 4
Send no message with away presence.
.RE
.PP
\fBmessage xa off\fR
.RS 4
Send no message with xa presence.
.RE
.PP
\fBcheck on|off\fR
.RS 4
When enabled, checks for activity and sends online presence, default: on.
.RE
.SH EXAMPLES
/autoaway mode away
.LP
/autoaway time away 30
.LP
/autoaway message away Away from computer for a while
.LP
/autoaway time xa 120
.LP
/autoaway message xa Away from computer for a very long time
.LP
/autoaway check off
.LP

35
docs/profanity-autoconnect.1
View File

@ -1,35 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/autoconnect
.SH DESCRIPTION
Enable or disable autoconnect on start up. The setting can be overridden by the -a (--account) command line option.
.SH SYNOPSIS
/autoconnect set <account>
.LP
/autoconnect off
.LP
.SH ARGUMENTS
.PP
\fBset <account>\fR
.RS 4
Connect with account on start up.
.RE
.PP
\fBoff\fR
.RS 4
Disable autoconnect.
.RE
.SH EXAMPLES
/autoconnect set ulfhednar@valhalla.edda
.LP
/autoconnect off
.LP

27
docs/profanity-autoping.1
View File

@ -1,27 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/autoping
.SH DESCRIPTION
Set the interval between sending ping requests to the server to ensure the connection is kept alive.
.SH SYNOPSIS
/autoping set <seconds>
.LP
/autoping timeout <seconds>
.LP
.SH ARGUMENTS
.PP
\fBset <seconds>\fR
.RS 4
Number of seconds between sending pings, a value of 0 disables autoping.
.RE
.PP
\fBtimeout <seconds>\fR
.RS 4
Seconds to wait for autoping responses, after which the connection is considered broken.
.RE

57
docs/profanity-avatar.1
View File

@ -1,57 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/avatar
.SH DESCRIPTION
Upload an avatar for yourself, disable your avatar, or download a contact's avatar (XEP-0084). If nothing happens after using this command, the user either doesn't have an avatar set or doesn't use XEP-0084 to publish it.
.SH SYNOPSIS
/avatar set <path>
.LP
/avatar disable
.LP
/avatar get <barejid>
.LP
/avatar open <barejid>
.LP
.SH ARGUMENTS
.PP
\fBset <path>\fR
.RS 4
Set avatar to the image at <path>.
.RE
.PP
\fBdisable\fR
.RS 4
Disable avatar publishing; your avatar will not display to others.
.RE
.PP
\fBget <barejid>\fR
.RS 4
Download the avatar. barejid is the JID to download avatar from.
.RE
.PP
\fBopen <barejid>\fR
.RS 4
Download avatar and open it with command. See /executable.
.RE
.SH EXAMPLES
/avatar set ~/images/avatar.png
.LP
/avatar disable
.LP
/avatar get thor@valhalla.edda
.LP
/avatar open freyja@vanaheimr.edda
.LP

24
docs/profanity-ban.1
View File

@ -1,24 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/ban
.SH DESCRIPTION
Ban user from chat room.
.SH SYNOPSIS
/ban <jid> [<reason>]
.LP
.SH ARGUMENTS
.PP
\fB<jid>\fR
.RS 4
Bare JID of the user to ban from the room.
.RE
.PP
\fB<reason>\fR
.RS 4
Optional reason for banning the user.
.RE

19
docs/profanity-beep.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/beep
.SH DESCRIPTION
Switch the terminal bell on or off. The bell will sound when incoming messages are received. If the terminal does not support sounds, it may attempt to flash the screen instead.
.SH SYNOPSIS
/beep on|off
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable or disable terminal bell.
.RE

57
docs/profanity-blocked.1
View File

@ -1,57 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/blocked
.SH DESCRIPTION
Manage blocked users (XEP-0191), calling with no arguments shows the current list of blocked users. To blog a certain user in a MUC use the following as jid: room@conference.example.org/spammy-userIt is also possible to block and report (XEP-0377) a user with the report-abuse and report-spam commands.
.SH SYNOPSIS
/blocked
.LP
/blocked add [<jid>]
.LP
/blocked report-abuse [<jid>] [<message>]
.LP
/blocked report-spam [<jid>] [<message>]
.LP
/blocked remove <jid>
.LP
.SH ARGUMENTS
.PP
\fBadd [<jid>]\fR
.RS 4
Block the specified Jabber ID. If in a chat window and no jid is specified, the current recipient will be blocked.
.RE
.PP
\fBremove <jid>\fR
.RS 4
Remove the specified Jabber ID from the blocked list.
.RE
.PP
\fBreport-abuse <jid> [<message>]\fR
.RS 4
Report the jid as abuse with an optional message to the service operator.
.RE
.PP
\fBreport-spam <jid> [<message>]\fR
.RS 4
Report the jid as spam with an optional message to the service operator.
.RE
.SH EXAMPLES
/blocked add hel@helheim.edda
.LP
/blocked report-spam hel@helheim.edda Very annoying guy
.LP
/blocked add profanity@rooms.dismail.de/spammy-user
.LP

124
docs/profanity-bookmark.1
View File

@ -1,124 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/bookmark
.SH DESCRIPTION
Manage bookmarks and join bookmarked rooms. If you are in a chat room and no arguments are supplied to `/bookmark add`, autojoin is set to "on". There is also an autojoin ignore list in case you want to autojoin in many clients but not on Profanity.
.SH SYNOPSIS
/bookmark
.LP
/bookmark list [<jid>]
.LP
/bookmark add [<room>] [nick <nick>] [password <password>] [name <roomname>] [autojoin on|off]
.LP
/bookmark update <room> [nick <nick>] [password <password>] [name <roomname>] [autojoin on|off]
.LP
/bookmark remove [<room>]
.LP
/bookmark join <room>
.LP
/bookmark invites on|off
.LP
/bookmark ignore
.LP
/bookmark ignore add <jid>
.LP
/bookmark ignore remove <jid>
.LP
.SH ARGUMENTS
.PP
\fBlist [<jid>]\fR
.RS 4
List all bookmarks. Or the details of one.
.RE
.PP
\fBadd [<room>]\fR
.RS 4
Add a bookmark, passing no room will bookmark the current room, setting autojoin to "on".
.RE
.PP
\fBremove [<room>]\fR
.RS 4
Remove a bookmark, passing no room will remove the bookmark for the current room, if one exists.
.RE
.PP
\fBupdate <room>\fR
.RS 4
Update the properties associated with a bookmark.
.RE
.PP
\fBnick <nick>\fR
.RS 4
Nickname used when joining the chat room.
.RE
.PP
\fBpassword <password>\fR
.RS 4
Password if required, may be stored in plaintext on your server.
.RE
.PP
\fBname <roomname>\fR
.RS 4
Optional name for the bookmark. By default localpart of the JID will be used.
.RE
.PP
\fBautojoin on|off\fR
.RS 4
Whether to join the room automatically on login.
.RE
.PP
\fBjoin <room>\fR
.RS 4
Join room using the properties associated with the bookmark.
.RE
.PP
\fBinvites on|off\fR
.RS 4
Whether or not to bookmark accepted room invites, defaults to 'on'.
.RE
.PP
\fBignore add <barejid>\fR
.RS 4
Add a bookmark to the autojoin ignore list.
.RE
.PP
\fBignore remove <barejid>\fR
.RS 4
Remove a bookmark from the autojoin ignore list.
.RE
.SH EXAMPLES
/bookmark add room@example.com nick YOURNICK
.LP
/bookmark join room@example.com
.LP
/bookmark update room@example.com nick NEWNICK autojoin on
.LP
/bookmark ignore room@example.com
.LP
/bookmark list
.LP
/bookmark list room@example.com
.LP
/bookmark remove room@example.com
.LP

38
docs/profanity-caps.1
View File

@ -1,38 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/caps
.SH DESCRIPTION
Find out a contacts, or room members client software capabilities. If in private chat initiated from a chat room, no parameter is required.
.SH SYNOPSIS
/caps
.LP
/caps <fulljid>|<nick>
.LP
.SH ARGUMENTS
.PP
\fB<fulljid>\fR
.RS 4
If in the console or a chat window, the full JID for which you wish to see capabilities.
.RE
.PP
\fB<nick>\fR
.RS 4
If in a chat room, nickname for which you wish to see capabilities.
.RE
.SH EXAMPLES
/caps ran@cold.sea.org/laptop
.LP
/caps ran@cold.sea.org/phone
.LP
/caps aegir
.LP

19
docs/profanity-carbons.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/carbons
.SH DESCRIPTION
Enable or disable message carbons. Message carbons ensure that both sides of all conversations are shared with all the user's clients that implement this protocol.
.SH SYNOPSIS
/carbons on|off
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable or disable message carbons.
.RE

12
docs/profanity-changepassword.1
View File

@ -1,12 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/changepassword
.SH DESCRIPTION
Change password of logged in account
.SH SYNOPSIS
/changepassword
.LP

12
docs/profanity-charset.1
View File

@ -1,12 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/charset
.SH DESCRIPTION
Display information about the current character set supported by the terminal.
.SH SYNOPSIS
/charset
.LP

33
docs/profanity-clear.1
View File

@ -1,33 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/clear
.SH DESCRIPTION
Clear the current window. If you set persist_history you can still access the history by pressing PAGE UP.
.SH SYNOPSIS
/clear
.LP
/clear persist_history <on|off>
.LP
.SH ARGUMENTS
.PP
\fBpersist_history on|off\fR
.RS 4
Whether or not to clear the screen persistently.
.RE
.SH EXAMPLES
/clear
.LP
/clear persist_history
.LP
/clear persist_history on
.LP

75
docs/profanity-close.1
View File

@ -1,75 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/close
.SH DESCRIPTION
Close windows. Passing no argument closes the current window.
.SH SYNOPSIS
/close
.LP
/close <num>
.LP
/close <barejid>
.LP
/close <nick>
.LP
/close <roomjid>
.LP
/close <roomoccupantjid>
.LP
/close xmlconsole
.LP
/close all|read
.LP
.SH ARGUMENTS
.PP
\fB<num>\fR
.RS 4
Close specified window number.
.RE
.PP
\fB<barejid>\fR
.RS 4
Close chat window with contact by JID if open.
.RE
.PP
\fB<nick>\fR
.RS 4
Close chat window with contact by nickname if open.
.RE
.PP
\fB<roomjid>\fR
.RS 4
Close chat room window with roomjid if open.
.RE
.PP
\fB<roomoccupantjid>\fR
.RS 4
Close private chat roomoccupantjid if open.
.RE
.PP
\fBxmlconsole\fR
.RS 4
Close the XML Console window if open.
.RE
.PP
\fBall\fR
.RS 4
Close all windows.
.RE
.PP
\fBread\fR
.RS 4
Close all windows that have no unread messages.
.RE

35
docs/profanity-cmd.1
View File

@ -1,35 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/cmd
.SH DESCRIPTION
Execute ad hoc commands.
.SH SYNOPSIS
/cmd list [<jid>]
.LP
/cmd exec <command> [<jid>]
.LP
.SH ARGUMENTS
.PP
\fBlist\fR
.RS 4
List supported ad hoc commands.
.RE
.PP
\fBexec <command>\fR
.RS 4
Execute a command.
.RE
.SH EXAMPLES
/cmd list
.LP
/cmd exec ping
.LP

41
docs/profanity-color.1
View File

@ -1,41 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/color
.SH DESCRIPTION
Settings for consistent color generation for nicks (XEP-0392). Including corrections for Color Vision Deficiencies. Your terminal needs to support 256 colors.
.SH SYNOPSIS
/color on|off|redgreen|blue
.LP
/color own on|off
.LP
.SH ARGUMENTS
.PP
\fBon|off|redgreen|blue\fR
.RS 4
Enable or disable nick colorization for MUC nicks. 'redgreen' is for people with red/green blindness and 'blue' for people with blue blindness.
.RE
.PP
\fBown on|off\fR
.RS 4
Enable color generation for own nick. If disabled the color from the color from the theme ('me') will get used.
.RE
.SH EXAMPLES
/color off
.LP
/color on
.LP
/color blue
.LP
/color own off
.LP

98
docs/profanity-connect.1
View File

@ -1,98 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "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. In case you want to connect to a server via SASL ANONYMOUS (c.f. XEP-0175) you can also do that.
.SH SYNOPSIS
/connect [<account>]
.LP
/connect <account> [server <server>] [port <port>] [tls force|allow|trust|legacy|disable] [auth default|legacy]
.LP
/connect <server>
.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
\fB<server>\fR
.RS 4
Connect to said server in an anonymous way. (Be aware: There aren't many servers that support this.)
.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
/connect server.supporting.sasl.anonymous.example
.LP

70
docs/profanity-console.1
View File

@ -1,70 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/console
.SH DESCRIPTION
Configure what is displayed in the console window when messages are received. The default is set to 'all' for all types of messages.
.SH SYNOPSIS
/console chat all|first|none
.LP
/console muc all|first|mention|none
.LP
/console private all|first|none
.LP
.SH ARGUMENTS
.PP
\fBchat all\fR
.RS 4
Indicate all new chat messages in the console.
.RE
.PP
\fBchat first\fR
.RS 4
Indicate only the first new message per chat in the console.
.RE
.PP
\fBchat none\fR
.RS 4
Do not show any new chat messages in the console window.
.RE
.PP
\fBmuc all\fR
.RS 4
Indicate all new chat room messages in the console.
.RE
.PP
\fBmuc first\fR
.RS 4
Indicate only the first new message in each room in the console.
.RE
.PP
\fBmuc mention\fR
.RS 4
Indicate only messages in which you have been mentioned in the console.
.RE
.PP
\fBmuc none\fR
.RS 4
Do not show any new chat room messages in the console window.
.RE
.PP
\fBprivate all\fR
.RS 4
Indicate all new private room messages in the console.
.RE
.PP
\fBprivate first\fR
.RS 4
Indicate only the first private room message in the console.
.RE
.PP
\fBprivate none\fR
.RS 4
Do not show any new private room messages in the console window.
.RE

12
docs/profanity-correct-editor.1
View File

@ -1,12 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/correct-editor
.SH DESCRIPTION
Spawn external editor to correct and resend the last message (XEP-0308). For more information on how to configure corrections, see: /help correction. Use /executable to set your favourite editor.
.SH SYNOPSIS
/correct-editor
.LP

19
docs/profanity-correct.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/correct
.SH DESCRIPTION
Correct and resend the last message (XEP-0308). Use tab completion to get the last sent message. For more information on how to configure corrections, see: /help correction.
.SH SYNOPSIS
/correct <message>
.LP
.SH ARGUMENTS
.PP
\fBmessage\fR
.RS 4
The corrected message.
.RE

27
docs/profanity-correction.1
View File

@ -1,27 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/correction
.SH DESCRIPTION
Settings regarding Last Message Correction (XEP-0308). Corrections will only work in MUC and regular chat windows. MUC PMs won't be allowed. For more information on how to correct messages, see: /help correct.
.SH SYNOPSIS
/correction <on>|<off>
.LP
/correction char <char>
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable/Disable support for last message correction.
.RE
.PP
\fBchar\fR
.RS 4
Set character that will prefix corrected messages. Default: '+'.
.RE

41
docs/profanity-disco.1
View File

@ -1,41 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/disco
.SH DESCRIPTION
Find out information about an entities supported services. Calling with no arguments will query the server you are currently connected to. This includes discovering contact addresses for XMPP services (XEP-0157).
.SH SYNOPSIS
/disco info [<jid>]
.LP
/disco items [<jid>]
.LP
.SH ARGUMENTS
.PP
\fBinfo [<jid>]\fR
.RS 4
List protocols and features supported by an entity.
.RE
.PP
\fBitems [<jid>]\fR
.RS 4
List items associated with an entity.
.RE
.SH EXAMPLES
/disco info
.LP
/disco items myserver.org
.LP
/disco items conference.jabber.org
.LP
/disco info odin@valhalla.edda/laptop
.LP

12
docs/profanity-disconnect.1
View File

@ -1,12 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/disconnect
.SH DESCRIPTION
Disconnect from the current chat service.
.SH SYNOPSIS
/disconnect
.LP

12
docs/profanity-editor.1
View File

@ -1,12 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/editor
.SH DESCRIPTION
Spawn external editor to edit message. After editing the inputline may appear empty. Press enter to send the text anyways. Use /executable to set your favourite editor.
.SH SYNOPSIS
/editor
.LP

120
docs/profanity-executable.1
View File

@ -1,120 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/executable
.SH DESCRIPTION
Configure executable that should be called upon a certain command.
.SH SYNOPSIS
/executable avatar set <cmdtemplate>
.LP
/executable avatar default
.LP
/executable urlopen set <cmdtemplate>
.LP
/executable urlopen default
.LP
/executable urlsave set <cmdtemplate>
.LP
/executable urlsave default
.LP
/executable editor set <cmdtemplate>
.LP
/executable editor default
.LP
/executable vcard_photo set <cmdtemplate>
.LP
/executable vcard_photo default
.LP
.SH ARGUMENTS
.PP
\fBavatar set\fR
.RS 4
Set executable that is run by /avatar open. Use your favorite image viewer.
.RE
.PP
\fBavatar default\fR
.RS 4
Restore to default settings.
.RE
.PP
\fBurlopen set\fR
.RS 4
Set executable that is run by /url open. Takes a command template that replaces %u and %p with the URL and path respectively.
.RE
.PP
\fBurlopen default\fR
.RS 4
Restore to default settings.
.RE
.PP
\fBurlsave set\fR
.RS 4
Set executable that is run by /url save. Takes a command template that replaces %u and %p with the URL and path respectively.
.RE
.PP
\fBurlsave default\fR
.RS 4
Use the built-in download method for saving.
.RE
.PP
\fBeditor set\fR
.RS 4
Set editor to be used with /editor. Needs a terminal editor or a script to run a graphical editor.
.RE
.PP
\fBeditor default\fR
.RS 4
Restore to default settings.
.RE
.PP
\fBvcard_photo set\fR
.RS 4
Set executable that is run by /vcard photo open. Takes a command template that replaces %p with the path
.RE
.PP
\fBvcard_photo default\fR
.RS 4
Restore to default settings.
.RE
.SH EXAMPLES
/executable avatar xdg-open
.LP
/executable urlopen set "xdg-open %u"
.LP
/executable urlopen set "firefox %u"
.LP
/executable urlopen default
.LP
/executable urlsave set "wget %u -O %p"
.LP
/executable urlsave set "curl %u -o %p"
.LP
/executable urlsave default
.LP
/executable vcard_photo set "feh %p"
.LP
/executable editor set "emacsclient -t"
.LP

27
docs/profanity-export.1
View File

@ -1,27 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/export
.SH DESCRIPTION
Exports contacts to a csv file.
.SH SYNOPSIS
/export <filepath>
.LP
.SH ARGUMENTS
.PP
\fB<filepath>\fR
.RS 4
Path to the output file.
.RE
.SH EXAMPLES
/export /path/to/output.csv
.LP
/export ~/contacts.csv
.LP

19
docs/profanity-flash.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/flash
.SH DESCRIPTION
Make the terminal flash when incoming messages are received in another window. If the terminal doesn't support flashing, it may attempt to beep.
.SH SYNOPSIS
/flash on|off
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable or disable terminal flash.
.RE

43
docs/profanity-form.1
View File

@ -1,43 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/form
.SH DESCRIPTION
Form configuration.
.SH SYNOPSIS
/form show
.LP
/form submit
.LP
/form cancel
.LP
/form help [<tag>]
.LP
.SH ARGUMENTS
.PP
\fBshow\fR
.RS 4
Show the current form.
.RE
.PP
\fBsubmit\fR
.RS 4
Submit the current form.
.RE
.PP
\fBcancel\fR
.RS 4
Cancel changes to the current form.
.RE
.PP
\fBhelp [<tag>]\fR
.RS 4
Display help for form, or a specific field.
.RE

19
docs/profanity-gone.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/gone
.SH DESCRIPTION
Send a 'gone' state to the recipient after the specified number of minutes. Chat states (/states) will be enabled if this setting is set.
.SH SYNOPSIS
/gone <minutes>
.LP
.SH ARGUMENTS
.PP
\fB<minutes>\fR
.RS 4
Number of minutes of inactivity before sending the 'gone' state, a value of 0 will disable sending this state.
.RE

48
docs/profanity-help.1
View File

@ -1,48 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/help
.SH DESCRIPTION
Help on using Profanity. Passing no arguments list help areas. For command help, optional arguments are shown using square brackets, arguments representing variables rather than a literal name are surrounded by angle brackets. Arguments that may be one of a number of values are separated by a pipe e.g. val1|val2|val3.
.SH SYNOPSIS
/help [<area>|<command>|search_all|search_any] [<search_terms>]
.LP
.SH ARGUMENTS
.PP
\fB<area>\fR
.RS 4
Summary help for commands in a certain area of functionality.
.RE
.PP
\fB<command>\fR
.RS 4
Full help for a specific command, for example '/help connect'.
.RE
.PP
\fBsearch_all <search_terms>\fR
.RS 4
Search commands for returning matches that contain all of the search terms.
.RE
.PP
\fBsearch_any <search_terms>\fR
.RS 4
Search commands for returning matches that contain any of the search terms.
.RE
.SH EXAMPLES
/help search_all presence online
.LP
/help commands
.LP
/help presence
.LP
/help who
.LP

19
docs/profanity-history.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/history
.SH DESCRIPTION
Switch chat history on or off, /logging chat will automatically be enabled when this setting is on. When history is enabled, previous messages are shown in chat windows.
.SH SYNOPSIS
/history on|off
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable or disable showing chat history.
.RE

35
docs/profanity-info.1
View File

@ -1,35 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/info
.SH DESCRIPTION
Show information about a contact, room, or room member. Passing no argument in a chat window will use the current recipient. Passing no argument in a chat room will display information about the room.
.SH SYNOPSIS
/info
.LP
/info <contact>|<nick>
.LP
.SH ARGUMENTS
.PP
\fB<contact>\fR
.RS 4
The contact you wish to view information about.
.RE
.PP
\fB<nick>\fR
.RS 4
When in a chat room, the occupant you wish to view information about.
.RE
.SH EXAMPLES
/info thor@aasgard.server.org
.LP
/info heimdall
.LP

27
docs/profanity-inpblock.1
View File

@ -1,27 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/inpblock
.SH DESCRIPTION
How long to wait for keyboard input before checking for new messages or checking for state changes such as 'idle'.
.SH SYNOPSIS
/inpblock timeout <millis>
.LP
/inpblock dynamic on|off
.LP
.SH ARGUMENTS
.PP
\fBtimeout <millis>\fR
.RS 4
Time to wait (1-1000) in milliseconds before reading input from the terminal buffer, default: 1000.
.RE
.PP
\fBdynamic on|off\fR
.RS 4
Start with 0 millis and dynamically increase up to timeout when no activity, default: on.
.RE

27
docs/profanity-inputwin.1
View File

@ -1,27 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/inputwin
.SH DESCRIPTION
Move the input window.
.SH SYNOPSIS
/inputwin up
.LP
/inputwin down
.LP
.SH ARGUMENTS
.PP
\fBup\fR
.RS 4
Move the input window up the screen.
.RE
.PP
\fBdown\fR
.RS 4
Move the input window down the screen.
.RE

24
docs/profanity-intype.1
View File

@ -1,24 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/intype
.SH DESCRIPTION
Show when a contact is typing in the console, and in active message window.
.SH SYNOPSIS
/intype console|titlebar on|off
.LP
.SH ARGUMENTS
.PP
\fBtitlebar on|off\fR
.RS 4
Enable or disable contact typing messages notification in titlebar.
.RE
.PP
\fBconsole on|off\fR
.RS 4
Enable or disable contact typing messages notification in console window.
.RE

46
docs/profanity-invite.1
View File

@ -1,46 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/invite
.SH DESCRIPTION
Manage room invites. Send an invite to a contact for the current chat room. List received invites. Decline them using /invite decline and accept them using /join.
.SH SYNOPSIS
/invite send <contact> [<message>]
.LP
/invite list
.LP
/invite decline
.LP
.SH ARGUMENTS
.PP
\fBsend <contact> [<message>]\fR
.RS 4
The contact you wish to invite. And an optional message.
.RE
.PP
\fBlist\fR
.RS 4
Show all rooms that you have been invited to, and not accepted or declined.
.RE
.PP
\fBdecline <room>\fR
.RS 4
Decline a chat room invitation.
.RE
.SH EXAMPLES
/invite send gustavo@pollos.tx
.LP
/invite decline profanity@rooms.dismail.de
.LP
/invite list
.LP

49
docs/profanity-join.1
View File

@ -1,49 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/join
.SH DESCRIPTION
Join a chat room at the conference server. If no room is supplied, a generated name will be used with the format private-chat-[UUID]. If the domain part is not included in the room name, the account preference 'muc.service' will be used. If no nickname is specified the account preference 'muc.nick' will be used which by default is the localpart of your JID. If the room doesn't exist, and the server allows it, a new one will be created. If you join to a room often, you might also want to add a bookmark (see `/help bookmark`), which also allows to set a default nickname. In this case, you should use `/bookmark join`.
.SH SYNOPSIS
/join
.LP
/join <room> [nick <nick>] [password <password>]
.LP
.SH ARGUMENTS
.PP
\fB<room>\fR
.RS 4
The chat room to join.
.RE
.PP
\fBnick <nick>\fR
.RS 4
Nickname to use in the room.
.RE
.PP
\fBpassword <password>\fR
.RS 4
Password if the room requires one.
.RE
.SH EXAMPLES
/join
.LP
/join profanity@rooms.dismail.de
.LP
/join profanity@rooms.dismail.de nick mynick
.LP
/join private@conference.jabber.org nick mynick password mypassword
.LP
/join mychannel
.LP

24
docs/profanity-kick.1
View File

@ -1,24 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/kick
.SH DESCRIPTION
Kick occupant from chat room.
.SH SYNOPSIS
/kick <nick> [<reason>]
.LP
.SH ARGUMENTS
.PP
\fB<nick>\fR
.RS 4
Nickname of the occupant to kick from the room.
.RE
.PP
\fB<reason>\fR
.RS 4
Optional reason for kicking the occupant.
.RE

44
docs/profanity-lastactivity.1
View File

@ -1,44 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/lastactivity
.SH DESCRIPTION
Enable/disable sending last activity, and send last activity requests.
.SH SYNOPSIS
/lastactivity set on|off
.LP
/lastactivity get [<jid>]
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable or disable sending of last activity.
.RE
.PP
\fB<jid>\fR
.RS 4
The JID of the entity to query. Omitting the JID will query your server for its uptime.
.RE
.SH EXAMPLES
/lastactivity get
.LP
/lastactivity set off
.LP
/lastactivity get freyja@asgaard.edda
.LP
/lastactivity get freyja@asgaard.edda/laptop
.LP
/lastactivity get someserver.com
.LP

51
docs/profanity-log.1
View File

@ -1,51 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/log
.SH DESCRIPTION
Manage profanity log settings.
.SH SYNOPSIS
/log where
.LP
/log rotate on|off
.LP
/log maxsize <bytes>
.LP
/log shared on|off
.LP
/log level INFO|DEBUG|WARN|ERROR
.LP
.SH ARGUMENTS
.PP
\fBwhere\fR
.RS 4
Show the current log file location.
.RE
.PP
\fBrotate on|off\fR
.RS 4
Rotate log, default on. Does not take effect if you specified a filename yourself when starting Profanity.
.RE
.PP
\fBmaxsize <bytes>\fR
.RS 4
With rotate enabled, specifies the max log size, defaults to 10485760 (10MB).
.RE
.PP
\fBshared on|off\fR
.RS 4
Share logs between all instances, default: on. When off, the process id will be included in the log filename. Does not take effect if you specified a filename yourself when starting Profanity.
.RE
.PP
\fBlevel INFO|DEBUG|WARN|ERROR\fR
.RS 4
Set the log level. Default is INFO. Only works with default log file, not with user provided log file during startup via -f.
.RE

32
docs/profanity-logging.1
View File

@ -1,32 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/logging
.SH DESCRIPTION
Configure chat logging. Switch logging on or off. Chat logging will be enabled if /history is set to on. When disabling this option, /history will also be disabled.
.SH SYNOPSIS
/logging chat|group on|off
.LP
.SH ARGUMENTS
.PP
\fBchat on|off\fR
.RS 4
Enable/Disable regular chat logging.
.RE
.PP
\fBgroup on|off\fR
.RS 4
Enable/Disable groupchat (room) logging.
.RE
.SH EXAMPLES
/logging chat on
.LP
/logging group off
.LP

27
docs/profanity-mainwin.1
View File

@ -1,27 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/mainwin
.SH DESCRIPTION
Move the main window.
.SH SYNOPSIS
/mainwin up
.LP
/mainwin down
.LP
.SH ARGUMENTS
.PP
\fBup\fR
.RS 4
Move the main window up the screen.
.RE
.PP
\fBdown\fR
.RS 4
Move the main window down the screen.
.RE

19
docs/profanity-mam.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/mam
.SH DESCRIPTION
Enable/Disable Message Archive Management (XEP-0313) Currently MAM in groupchats (MUCs) is not supported.Use the PG UP key to load more history.
.SH SYNOPSIS
/mam <on>|<off>
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable or disable MAM
.RE

46
docs/profanity-mood.1
View File

@ -1,46 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/mood
.SH DESCRIPTION
Set your mood (XEP-0107).
.SH SYNOPSIS
/mood on|off
.LP
/mood set <mood> [text]
.LP
/mood clear
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable or disable displaying the mood of other users. On by default.
.RE
.PP
\fBset <mood> [text]\fR
.RS 4
Set user mood to <mood> with an optional [text]. Use /mood set <tab> to toggle through predefined moods.
.RE
.PP
\fBclear\fR
.RS 4
Clear your user mood.
.RE
.SH EXAMPLES
/mood set happy "So happy to use Profanity!"
.LP
/mood set amazed
.LP
/mood clear
.LP

51
docs/profanity-msg.1
View File

@ -1,51 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/msg
.SH DESCRIPTION
Send a one to one chat message, or a private message to a chat room occupant. If the message is omitted, a new chat window will be opened without sending a message. Use quotes if the nickname includes spaces.
.SH SYNOPSIS
/msg <contact> [<message>]
.LP
/msg <nick> [<message>]
.LP
.SH ARGUMENTS
.PP
\fB<contact>\fR
.RS 4
Open chat window with contact, by JID or nickname.
.RE
.PP
\fB<contact> [<message>]\fR
.RS 4
Send message to contact, by JID or nickname.
.RE
.PP
\fB<nick>\fR
.RS 4
Open private chat window with chat room occupant.
.RE
.PP
\fB<nick> [<message>]\fR
.RS 4
Send a private message to a chat room occupant.
.RE
.SH EXAMPLES
/msg thor@valhalla.edda Hey, here's a message!
.LP
/msg heimdall@valhalla.edda
.LP
/msg Thor Here is a private message
.LP
/msg "My Friend" Hi, how are you?
.LP

19
docs/profanity-nick.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/nick
.SH DESCRIPTION
Change your nickname in the current chat room.
.SH SYNOPSIS
/nick <nickname>
.LP
.SH ARGUMENTS
.PP
\fB<nickname>\fR
.RS 4
Your new nickname.
.RE

240
docs/profanity-notify.1
View File

@ -1,240 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/notify
.SH DESCRIPTION
Configure desktop notifications. To configure presence update messages in the console, chat and chat room windows, see '/help presence'.
.SH SYNOPSIS
/notify chat on|off
.LP
/notify chat current on|off
.LP
/notify chat text on|off
.LP
/notify room on|off
.LP
/notify room mention on|off
.LP
/notify room mention case_sensitive|case_insensitive
.LP
/notify room mention word_whole|word_part
.LP
/notify room offline on|off
.LP
/notify room current on|off
.LP
/notify room text on|off
.LP
/notify room trigger add <text>
.LP
/notify room trigger remove <text>
.LP
/notify room trigger list
.LP
/notify room trigger on|off
.LP
/notify on|off
.LP
/notify mention on|off
.LP
/notify trigger on|off
.LP
/notify reset
.LP
/notify remind <seconds>
.LP
/notify typing on|off
.LP
/notify typing current on|off
.LP
/notify invite on|off
.LP
/notify sub on|off
.LP
.SH ARGUMENTS
.PP
\fBchat on|off\fR
.RS 4
Notifications for regular chat messages.
.RE
.PP
\fBchat current on|off\fR
.RS 4
Whether to show regular chat message notifications when the window is focused.
.RE
.PP
\fBchat text on|off\fR
.RS 4
Show message text in regular message notifications.
.RE
.PP
\fBroom on|off\fR
.RS 4
Notifications for all chat room messages.
.RE
.PP
\fBroom mention on|off\fR
.RS 4
Notifications for chat room messages when your nick is mentioned.
.RE
.PP
\fBroom mention case_sensitive\fR
.RS 4
Set room mention notifications as case sensitive.
.RE
.PP
\fBroom mention case_insensitive\fR
.RS 4
Set room mention notifications as case insensitive.
.RE
.PP
\fBroom mention word_whole\fR
.RS 4
Set room mention notifications only on whole word match, i.e. when nickname is not part of a larger word.
.RE
.PP
\fBroom mention word_part\fR
.RS 4
Set room mention notifications on partial word match, i.e. nickname may be part of a larger word.
.RE
.PP
\fBroom offline on|off\fR
.RS 4
Notifications for chat room messages that were sent while you were offline.
.RE
.PP
\fBroom current on|off\fR
.RS 4
Whether to show all chat room messages notifications when the window is focused.
.RE
.PP
\fBroom text on|off\fR
.RS 4
Show message text in chat room message notifications.
.RE
.PP
\fBroom trigger add <text>\fR
.RS 4
Notify when specified text included in all chat room messages.
.RE
.PP
\fBroom trigger remove <text>\fR
.RS 4
Remove chat room notification trigger.
.RE
.PP
\fBroom trigger list\fR
.RS 4
List all chat room highlight triggers.
.RE
.PP
\fBroom trigger on|off\fR
.RS 4
Enable or disable all chat room notification triggers.
.RE
.PP
\fBon|off\fR
.RS 4
Override the global message setting for the current chat room.
.RE
.PP
\fBmention on|off\fR
.RS 4
Override the global 'mention' setting for the current chat room.
.RE
.PP
\fBtrigger on|off\fR
.RS 4
Override the global 'trigger' setting for the current chat room.
.RE
.PP
\fBreset\fR
.RS 4
Reset to global notification settings for the current chat room.
.RE
.PP
\fBremind <seconds>\fR
.RS 4
Notification reminder period for unread messages, use 0 to disable.
.RE
.PP
\fBtyping on|off\fR
.RS 4
Notifications when contacts are typing.
.RE
.PP
\fBtyping current on|off\fR
.RS 4
Whether typing notifications are triggered for the current window.
.RE
.PP
\fBinvite on|off\fR
.RS 4
Notifications for chat room invites.
.RE
.PP
\fBsub on|off\fR
.RS 4
Notifications for subscription requests.
.RE
.SH EXAMPLES
/notify chat on
.LP
/notify chat text on
.LP
/notify room mention on
.LP
/notify room offline on
.LP
/notify room trigger add beer
.LP
/notify room trigger on
.LP
/notify room current off
.LP
/notify room text off
.LP
/notify remind 60
.LP
/notify typing on
.LP
/notify invite on
.LP

125
docs/profanity-occupants.1
View File

@ -1,125 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/occupants
.SH DESCRIPTION
Show or hide room occupants, and occupants panel display settings.
.SH SYNOPSIS
/occupants show|hide [jid|offline]
.LP
/occupants char <char>|none
.LP
/occupants color on|off
.LP
/occupants default show|hide [jid|offline]
.LP
/occupants size [<percent>]
.LP
/occupants indent <indent>
.LP
/occupants header char <char>|none
.LP
/occupants wrap on|off
.LP
.SH ARGUMENTS
.PP
\fBshow\fR
.RS 4
Show the occupants panel in current room.
.RE
.PP
\fBchar <char>\fR
.RS 4
Prefix occupants with specified character.
.RE
.PP
\fBchar none\fR
.RS 4
Remove occupants character prefix.
.RE
.PP
\fBcolor on\fR
.RS 4
Enable generated color names (XEP-0392) for occupants
.RE
.PP
\fBcolor off\fR
.RS 4
Disable generated color names (XEP-0392) for occupants
.RE
.PP
\fBhide\fR
.RS 4
Hide the occupants panel in current room.
.RE
.PP
\fBshow jid\fR
.RS 4
Show jid in the occupants panel in current room.
.RE
.PP
\fBhide jid\fR
.RS 4
Hide jid in the occupants panel in current room.
.RE
.PP
\fBshow offline\fR
.RS 4
Show offline occupants panel in current room.
.RE
.PP
\fBhide offline\fR
.RS 4
Hide offline occupants panel in current room.
.RE
.PP
\fBdefault show|hide\fR
.RS 4
Whether occupants are shown by default in new rooms.
.RE
.PP
\fBdefault show|hide jid\fR
.RS 4
Whether occupants jids are shown by default in new rooms.
.RE
.PP
\fBdefault show|hide offline\fR
.RS 4
Whether offline occupants are shown by default in new rooms.
.RE
.PP
\fBsize <percent>\fR
.RS 4
Percentage of the screen taken by the occupants list in rooms (1-99).
.RE
.PP
\fBindent <indent>\fR
.RS 4
Indent contact line by <indent> spaces (0 to 10).
.RE
.PP
\fBheader char <char>\fR
.RS 4
Prefix occupants headers with specified character.
.RE
.PP
\fBheader char none\fR
.RS 4
Remove occupants header character prefix.
.RE
.PP
\fBwrap on|off\fR
.RS 4
Enable or disable line wrapping in occupants panel.
.RE

136
docs/profanity-omemo.1
View File

@ -1,136 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/omemo
.SH DESCRIPTION
OMEMO commands to manage keys, and perform encryption during chat sessions.
.SH SYNOPSIS
/omemo gen
.LP
/omemo log on|off|redact
.LP
/omemo start [<contact>]
.LP
/omemo trust [<contact>] <fingerprint>
.LP
/omemo end
.LP
/omemo fingerprint [<contact>]
.LP
/omemo char <char>
.LP
/omemo trustmode manual|firstusage|blind
.LP
/omemo policy manual|automatic|always
.LP
/omemo clear_device_list
.LP
/omemo qrcode
.LP
.SH ARGUMENTS
.PP
\fBgen\fR
.RS 4
Generate OMEMO crytographic materials for current account.
.RE
.PP
\fBstart [<contact>]\fR
.RS 4
Start an OMEMO session with contact, or current recipient if omitted.
.RE
.PP
\fBend\fR
.RS 4
End the current OMEMO session.
.RE
.PP
\fBlog on|off\fR
.RS 4
Enable or disable plaintext logging of OMEMO encrypted messages.
.RE
.PP
\fBlog redact\fR
.RS 4
Log OMEMO encrypted messages, but replace the contents with [redacted].
.RE
.PP
\fBfingerprint [<contact>]\fR
.RS 4
Show contact fingerprints, or current recipient if omitted.
.RE
.PP
\fBchar <char>\fR
.RS 4
Set the character to be displayed next to OMEMO encrypted messages.
.RE
.PP
\fBtrustmode manual\fR
.RS 4
Set the global OMEMO trust mode to manual, OMEMO keys has to be trusted manually.
.RE
.PP
\fBtrustmode firstusage\fR
.RS 4
Set the global OMEMO trust mode to ToFu, first OMEMO keys trusted automatically.
.RE
.PP
\fBtrustmode blind\fR
.RS 4
Set the global OMEMO trust mode to blind, ALL OMEMO keys trusted automatically.
.RE
.PP
\fBpolicy manual\fR
.RS 4
Set the global OMEMO policy to manual, OMEMO sessions must be started manually.
.RE
.PP
\fBpolicy automatic\fR
.RS 4
Set the global OMEMO policy to opportunistic, an OMEMO session will be attempted upon starting a conversation.
.RE
.PP
\fBpolicy always\fR
.RS 4
Set the global OMEMO policy to always, an error will be displayed if an OMEMO session cannot be initiated upon starting a conversation.
.RE
.PP
\fBclear_device_list\fR
.RS 4
Clear your own device list on server side. Each client will reannounce itself when connected back.
.RE
.PP
\fBqrcode\fR
.RS 4
Display QR code of your OMEMO fingerprint
.RE
.SH EXAMPLES
/omemo gen
.LP
/omemo start odin@valhalla.edda
.LP
/omemo trust c4f9c875-144d7a3b-0c4a05b6-ca3be51a-a037f329-0bd3ae62-07f99719-55559d2a
.LP
/omemo untrust loki@valhalla.edda c4f9c875-144d7a3b-0c4a05b6-ca3be51a-a037f329-0bd3ae62-07f99719-55559d2a
.LP
/omemo char *
.LP

182
docs/profanity-otr.1
View File

@ -1,182 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/otr
.SH DESCRIPTION
Off The Record (OTR) commands to manage keys, and perform OTR encryption during chat sessions.
.SH SYNOPSIS
/otr libver
.LP
/otr gen
.LP
/otr myfp|theirfp
.LP
/otr start [<contact>]
.LP
/otr end
.LP
/otr trust|untrust
.LP
/otr secret <secret>
.LP
/otr question <question> <answer>
.LP
/otr answer <answer>
.LP
/otr policy manual|opportunistic|always [<contact>]
.LP
/otr log on|off|redact
.LP
/otr char <char>
.LP
/otr sendfile on|off
.LP
.SH ARGUMENTS
.PP
\fBlibver\fR
.RS 4
Show which version of the libotr library is being used.
.RE
.PP
\fBgen\fR
.RS 4
Generate your private key.
.RE
.PP
\fBmyfp\fR
.RS 4
Show your fingerprint.
.RE
.PP
\fBtheirfp\fR
.RS 4
Show contacts fingerprint.
.RE
.PP
\fBstart [<contact>]\fR
.RS 4
Start an OTR session with contact, or current recipient if omitted.
.RE
.PP
\fBend\fR
.RS 4
End the current OTR session.
.RE
.PP
\fBtrust|untrust\fR
.RS 4
Indicate whether or not you trust the contact's fingerprint.
.RE
.PP
\fBsecret <secret>\fR
.RS 4
Verify a contact's identity using a shared secret.
.RE
.PP
\fBquestion <question> <answer>\fR
.RS 4
Verify a contact's identity using a question and expected answer.
.RE
.PP
\fBanswer <answer>\fR
.RS 4
Respond to a question answer verification request with your answer.
.RE
.PP
\fBpolicy manual\fR
.RS 4
Set the global OTR policy to manual, OTR sessions must be started manually.
.RE
.PP
\fBpolicy manual <contact>\fR
.RS 4
Set the OTR policy to manual for a specific contact.
.RE
.PP
\fBpolicy opportunistic\fR
.RS 4
Set the global OTR policy to opportunistic, an OTR session will be attempted upon starting a conversation.
.RE
.PP
\fBpolicy opportunistic <contact>\fR
.RS 4
Set the OTR policy to opportunistic for a specific contact.
.RE
.PP
\fBpolicy always\fR
.RS 4
Set the global OTR policy to always, an error will be displayed if an OTR session cannot be initiated upon starting a conversation.
.RE
.PP
\fBpolicy always <contact>\fR
.RS 4
Set the OTR policy to always for a specific contact.
.RE
.PP
\fBlog on|off\fR
.RS 4
Enable or disable plaintext logging of OTR encrypted messages.
.RE
.PP
\fBlog redact\fR
.RS 4
Log OTR encrypted messages, but replace the contents with [redacted].
.RE
.PP
\fBchar <char>\fR
.RS 4
Set the character to be displayed next to OTR encrypted messages.
.RE
.PP
\fBsendfile on|off\fR
.RS 4
Allow /sendfile to send unencrypted files while in an OTR session.
.RE
.SH EXAMPLES
/otr log off
.LP
/otr policy manual
.LP
/otr policy opportunistic odin@valhalla.edda
.LP
/otr gen
.LP
/otr start odin@valhalla.edda
.LP
/otr myfp
.LP
/otr theirfp
.LP
/otr question "What is the name of my rabbit?" fiffi
.LP
/otr end
.LP
/otr char *
.LP

19
docs/profanity-outtype.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/outtype
.SH DESCRIPTION
Send typing notifications, chat states (/states) will be enabled if this setting is enabled.
.SH SYNOPSIS
/outtype on|off
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable or disable sending typing notifications.
.RE

102
docs/profanity-ox.1
View File

@ -1,102 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/ox
.SH DESCRIPTION
OpenPGP (OX) commands to manage keys, and perform OpenPGP encryption during chat sessions. Your OpenPGP key needs a user-id with your JID URI (xmpp:local@domain.tld). A key can be generated with "gpg --quick-gen-key xmpp:local@domain.tld future-default default 3y". See man profanity-ox-setup for details on how to set up OX the first time.
.SH SYNOPSIS
/ox keys
.LP
/ox contacts
.LP
/ox start [<contact>]
.LP
/ox end
.LP
/ox log on|off|redact
.LP
/ox char <char>
.LP
/ox announce <file>
.LP
/ox discover <jid>
.LP
/ox request <jid> <keyid>
.LP
.SH ARGUMENTS
.PP
\fBkeys\fR
.RS 4
List all keys known to the system.
.RE
.PP
\fBcontacts\fR
.RS 4
Show contacts with assigned public keys.
.RE
.PP
\fBstart [<contact>]\fR
.RS 4
Start PGP encrypted chat, current contact will be used if not specified.
.RE
.PP
\fBend\fR
.RS 4
End PGP encrypted chat with the current recipient.
.RE
.PP
\fBlog on|off\fR
.RS 4
Enable or disable plaintext logging of PGP encrypted messages.
.RE
.PP
\fBlog redact\fR
.RS 4
Log PGP encrypted messages, but replace the contents with [redacted].
.RE
.PP
\fBchar <char>\fR
.RS 4
Set the character to be displayed next to PGP encrypted messages.
.RE
.PP
\fBannounce <file>\fR
.RS 4
Announce a public key by pushing it on the XMPP Server
.RE
.PP
\fBdiscover <jid>\fR
.RS 4
Discover public keys of a jid. The OpenPGP Key IDs will be displayed
.RE
.PP
\fBrequest <jid> <keyid>\fR
.RS 4
Request public key. See /ox discover to to get available key IDs.
.RE
.SH EXAMPLES
/ox log off
.LP
/ox start odin@valhalla.edda
.LP
/ox end
.LP
/ox char X
.LP

12
docs/profanity-paste.1
View File

@ -1,12 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/paste
.SH DESCRIPTION
Paste clipboard.
.SH SYNOPSIS
/paste
.LP

118
docs/profanity-pgp.1
View File

@ -1,118 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/pgp
.SH DESCRIPTION
Open PGP commands to manage keys, and perform PGP encryption during chat sessions. See the /account command to set your own PGP key.
.SH SYNOPSIS
/pgp libver
.LP
/pgp keys
.LP
/pgp contacts
.LP
/pgp setkey <contact> <keyid>
.LP
/pgp start [<contact>]
.LP
/pgp end
.LP
/pgp log on|off|redact
.LP
/pgp char <char>
.LP
/pgp sendfile on|off
.LP
/pgp sendpub [<contact>]
.LP
.SH ARGUMENTS
.PP
\fBlibver\fR
.RS 4
Show which version of the libgpgme library is being used.
.RE
.PP
\fBkeys\fR
.RS 4
List all keys known to the system.
.RE
.PP
\fBcontacts\fR
.RS 4
Show contacts with assigned public keys.
.RE
.PP
\fBsetkey <contact> <keyid>\fR
.RS 4
Manually associate a contact with a public key.
.RE
.PP
\fBstart [<contact>]\fR
.RS 4
Start PGP encrypted chat, current contact will be used if not specified.
.RE
.PP
\fBend\fR
.RS 4
End PGP encrypted chat with the current recipient.
.RE
.PP
\fBlog on|off\fR
.RS 4
Enable or disable plaintext logging of PGP encrypted messages.
.RE
.PP
\fBlog redact\fR
.RS 4
Log PGP encrypted messages, but replace the contents with [redacted]. This is the default.
.RE
.PP
\fBchar <char>\fR
.RS 4
Set the character to be displayed next to PGP encrypted messages.
.RE
.PP
\fBsendfile on|off\fR
.RS 4
Allow /sendfile to send unencrypted files while otherwise using PGP.
.RE
.PP
\fBautoimport on|off\fR
.RS 4
Autoimport PGP keys from messages.
.RE
.PP
\fBsendpub [<contact>]\fR
.RS 4
Sends a message to the current recipient with your PGP public key, current contact will be used if not specified.
.RE
.SH EXAMPLES
/pgp log off
.LP
/pgp setkey odin@valhalla.edda BA19CACE5A9592C5
.LP
/pgp start odin@valhalla.edda
.LP
/pgp end
.LP
/pgp char P
.LP

19
docs/profanity-ping.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/ping
.SH DESCRIPTION
Sends an IQ ping stanza to the specified JID. If no JID is supplied, your chat server will be pinged.
.SH SYNOPSIS
/ping [<jid>]
.LP
.SH ARGUMENTS
.PP
\fB<jid>\fR
.RS 4
The Jabber ID to send the ping request to.
.RE

96
docs/profanity-plugins.1
View File

@ -1,96 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/plugins
.SH DESCRIPTION
Manage plugins. Passing no arguments lists installed plugins and global plugins which are available for local installation. Global directory for Python plugins is /usr/local/share/profanity/plugins and for C Plugins is /usr/local/lib64/profanity/plugins.
.SH SYNOPSIS
/plugins
.LP
/plugins install [<path or URL>]
.LP
/plugins update [<path or URL>]
.LP
/plugins uninstall [<plugin>]
.LP
/plugins unload [<plugin>]
.LP
/plugins load [<plugin>]
.LP
/plugins reload [<plugin>]
.LP
/plugins python_version
.LP
.SH ARGUMENTS
.PP
\fBinstall [<path or URL>]\fR
.RS 4
Install a plugin, or all plugins found in a directory (recursive), or download and install plugin (plugin name is based on basename). And loads it/them.
.RE
.PP
\fBupdate [<path or URL>]\fR
.RS 4
Uninstall and then install the plugin. Plugin name to update is basename.
.RE
.PP
\fBuninstall [<plugin>]\fR
.RS 4
Uninstall a plugin.
.RE
.PP
\fBload [<plugin>]\fR
.RS 4
Load a plugin that already exists in the plugin directory, passing no argument loads all found plugins. It will be loaded upon next start too unless unloaded.
.RE
.PP
\fBunload [<plugin>]\fR
.RS 4
Unload a loaded plugin, passing no argument will unload all plugins.
.RE
.PP
\fBreload [<plugin>]\fR
.RS 4
Reload a plugin, passing no argument will reload all plugins.
.RE
.PP
\fBpython_version\fR
.RS 4
Show the Python interpreter version.
.RE
.SH EXAMPLES
/plugins install /home/steveharris/Downloads/metal.py
.LP
/plugins install https://raw.githubusercontent.com/profanity-im/profanity-plugins/master/stable/sounds.py
.LP
/plugins update /home/steveharris/Downloads/metal.py
.LP
/plugins update https://raw.githubusercontent.com/profanity-im/profanity-plugins/master/stable/sounds.py
.LP
/plugins uninstall browser.py
.LP
/plugins load browser.py
.LP
/plugins unload say.py
.LP
/plugins reload wikipedia.py
.LP

59
docs/profanity-prefs.1
View File

@ -1,59 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/prefs
.SH DESCRIPTION
Show preferences for different areas of functionality. Passing no arguments shows all preferences.
.SH SYNOPSIS
/prefs [ui|desktop|chat|log|conn|presence|otr|pgp|omemo]
.LP
.SH ARGUMENTS
.PP
\fBui\fR
.RS 4
User interface preferences.
.RE
.PP
\fBdesktop\fR
.RS 4
Desktop notification preferences.
.RE
.PP
\fBchat\fR
.RS 4
Chat state preferences.
.RE
.PP
\fBlog\fR
.RS 4
Logging preferences.
.RE
.PP
\fBconn\fR
.RS 4
Connection handling preferences.
.RE
.PP
\fBpresence\fR
.RS 4
Chat presence preferences.
.RE
.PP
\fBotr\fR
.RS 4
Off The Record preferences.
.RE
.PP
\fBpgp\fR
.RS 4
OpenPGP preferences.
.RE
.PP
\fBomemo\fR
.RS 4
OMEMO preferences.
.RE

87
docs/profanity-presence.1
View File

@ -1,87 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/presence
.SH DESCRIPTION
Show the contacts presence in the titlebar and configure presence messages in different window types.
.SH SYNOPSIS
/presence titlebar on|off
.LP
/presence console all|online|none
.LP
/presence chat all|online|none
.LP
/presence room all|online|none
.LP
.SH ARGUMENTS
.PP
\fBtitlebar on|off\fR
.RS 4
Switch display of the contacts presence in the titlebar on or off.
.RE
.PP
\fBconsole all\fR
.RS 4
Show all presence changes in the console window.
.RE
.PP
\fBconsole online\fR
.RS 4
Show only online/offline presence changes in the console window.
.RE
.PP
\fBconsole none\fR
.RS 4
Don't show any presence changes in the console window.
.RE
.PP
\fBchat all\fR
.RS 4
Show all presence changes in the chat windows.
.RE
.PP
\fBchat online\fR
.RS 4
Show only online/offline presence changes in chat windows.
.RE
.PP
\fBchat none\fR
.RS 4
Don't show any presence changes in chat windows.
.RE
.PP
\fBroom all\fR
.RS 4
Show all presence changes in chat room windows.
.RE
.PP
\fBroom online\fR
.RS 4
Show only online/offline presence changes in chat room windows.
.RE
.PP
\fBroom none\fR
.RS 4
Don't show any presence changes in chat room windows.
.RE
.SH EXAMPLES
/presence titlebar off
.LP
/presence console none
.LP
/presence chat online
.LP
/presence room all
.LP

19
docs/profanity-priority.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/priority
.SH DESCRIPTION
Set priority for the current account. See the /account command for specific priority settings per presence status.
.SH SYNOPSIS
/priority <priority>
.LP
.SH ARGUMENTS
.PP
\fB<priority>\fR
.RS 4
Number between -128 and 127, default: 0.
.RE

35
docs/profanity-privacy.1
View File

@ -1,35 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/privacy
.SH DESCRIPTION
Configure privacy settings.Also check the the following settings in /account: clientid to set the client identification namesession_alarm to configure an alarm when more clients log in.
.SH SYNOPSIS
/privacy logging on|redact|off
.LP
/privacy os on|off
.LP
.SH ARGUMENTS
.PP
\fBlogging on|redact|off\fR
.RS 4
Switch chat logging. This will also disable logging in the internally used SQL database. Your messages will not be saved anywhere locally. This might have unintended consequences, such as not being able to decrypt OMEMO encrypted messages received later via MAM, and should be used with caution.
.RE
.PP
\fBos on|off\fR
.RS 4
Choose whether to include the OS name if a user asks for software information (XEP-0092).
.RE
.SH EXAMPLES
/privacy logging off
.LP
/privacy os off
.LP

19
docs/profanity-privileges.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/privileges
.SH DESCRIPTION
Group occupants panel by role, and show role information in chat rooms.
.SH SYNOPSIS
/privileges on|off
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable or disable privilege information.
.RE

12
docs/profanity-quit.1
View File

@ -1,12 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/quit
.SH DESCRIPTION
Logout of any current session, and quit Profanity.
.SH SYNOPSIS
/quit
.LP

27
docs/profanity-receipts.1
View File

@ -1,27 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/receipts
.SH DESCRIPTION
Enable or disable message delivery receipts. The interface will indicate when a message has been received.
.SH SYNOPSIS
/receipts request on|off
.LP
/receipts send on|off
.LP
.SH ARGUMENTS
.PP
\fBrequest on|off\fR
.RS 4
Whether or not to request a receipt upon sending a message.
.RE
.PP
\fBsend on|off\fR
.RS 4
Whether or not to send a receipt if one has been requested with a received message.
.RE

27
docs/profanity-reconnect.1
View File

@ -1,27 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/reconnect
.SH DESCRIPTION
Set the reconnect attempt interval for when the connection is lost or immediately trigger a reconnect.
.SH SYNOPSIS
/reconnect <seconds>
.LP
/reconnect now
.LP
.SH ARGUMENTS
.PP
\fB<seconds>\fR
.RS 4
Number of seconds before attempting to reconnect, a value of 0 disables reconnect.
.RE
.PP
\fBnow\fR
.RS 4
Immediately trigger a reconnect.
.RE

68
docs/profanity-register.1
View File

@ -1,68 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "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

12
docs/profanity-reload.1
View File

@ -1,12 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/reload
.SH DESCRIPTION
Reload preferences from configuration file.
.SH SYNOPSIS
/reload
.LP

43
docs/profanity-resource.1
View File

@ -1,43 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/resource
.SH DESCRIPTION
Override chat session resource, and manage resource display settings.
.SH SYNOPSIS
/resource set <resource>
.LP
/resource off
.LP
/resource title on|off
.LP
/resource message on|off
.LP
.SH ARGUMENTS
.PP
\fBset <resource>\fR
.RS 4
Set the resource to which messages will be sent.
.RE
.PP
\fBoff\fR
.RS 4
Let the server choose which resource to route messages to.
.RE
.PP
\fBtitle on|off\fR
.RS 4
Show or hide the current resource in the titlebar.
.RE
.PP
\fBmessage on|off\fR
.RS 4
Show or hide the resource when showing an incoming message.
.RE

27
docs/profanity-role.1
View File

@ -1,27 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/role
.SH DESCRIPTION
Manage room roles. Role may be one of moderator, participant, visitor or none.
.SH SYNOPSIS
/role set <role> <nick> [<reason>]
.LP
/role list [<role>]
.LP
.SH ARGUMENTS
.PP
\fBset <role> <nick> [<reason>]\fR
.RS 4
Set the role of occupant with nick, with an optional reason.
.RE
.PP
\fBlist [<role>]\fR
.RS 4
List all occupants with the specified role, or all if none specified.
.RE

29
docs/profanity-room.1
View File

@ -1,29 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/room
.SH DESCRIPTION
Chat room configuration.
.SH SYNOPSIS
/room accept|destroy|config
.LP
.SH ARGUMENTS
.PP
\fBaccept\fR
.RS 4
Accept default room configuration.
.RE
.PP
\fBdestroy\fR
.RS 4
Reject default room configuration, and destroy the room.
.RE
.PP
\fBconfig\fR
.RS 4
Edit room configuration.
.RE

60
docs/profanity-rooms.1
View File

@ -1,60 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "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

546
docs/profanity-roster.1
View File

@ -1,546 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/roster
.SH DESCRIPTION
Manage your roster, and roster display settings. Passing no arguments lists all contacts in your roster.
.SH SYNOPSIS
/roster
.LP
/roster online
.LP
/roster show [offline|resource|presence|status|empty|priority|contacts|rooms]
.LP
/roster hide [offline|resource|presence|status|empty|priority|contacts|rooms]
.LP
/roster by group|presence|none
.LP
/roster count unread|items|off
.LP
/roster count zero on|off
.LP
/roster color on|off
.LP
/roster order name|presence
.LP
/roster unread before|after|off
.LP
/roster room char <char>|none
.LP
/roster room private char <char>|none
.LP
/roster room position first|last
.LP
/roster room by service|none
.LP
/roster room order name|unread
.LP
/roster room unread before|after|off
.LP
/roster room show server
.LP
/roster room hide server
.LP
/roster room use name|jid
.LP
/roster private room|group|off
.LP
/roster private char <char>|none
.LP
/roster header char <char>|none
.LP
/roster presence indent <indent>
.LP
/roster contact char <char>|none
.LP
/roster contact indent <indent>
.LP
/roster resource char <char>|none
.LP
/roster resource indent <indent>
.LP
/roster resource join on|off
.LP
/roster size <percent>
.LP
/roster wrap on|off
.LP
/roster add <jid> [<nick>]
.LP
/roster remove <contact>
.LP
/roster remove_all contacts
.LP
/roster nick <jid> <nick>
.LP
/roster clearnick <jid>
.LP
/roster group
.LP
/roster group show <group>
.LP
/roster group add <group> <contat>
.LP
/roster group remove <group> <contact>
.LP
.SH ARGUMENTS
.PP
\fBonline\fR
.RS 4
Show all online contacts in console.
.RE
.PP
\fBshow\fR
.RS 4
Show the roster panel.
.RE
.PP
\fBshow offline\fR
.RS 4
Show offline contacts in roster panel.
.RE
.PP
\fBshow resource\fR
.RS 4
Show contact's connected resources in roster panel.
.RE
.PP
\fBshow presence\fR
.RS 4
Show contact's presence in roster panel.
.RE
.PP
\fBshow status\fR
.RS 4
Show contact's status message in roster panel.
.RE
.PP
\fBshow empty\fR
.RS 4
Show empty groups in roster panel.
.RE
.PP
\fBshow priority\fR
.RS 4
Show resource priority in roster panel.
.RE
.PP
\fBshow contacts\fR
.RS 4
Show contacts in roster panel.
.RE
.PP
\fBshow rooms\fR
.RS 4
Show chat rooms in roster panel.
.RE
.PP
\fBhide\fR
.RS 4
Hide the roster panel.
.RE
.PP
\fBhide offline\fR
.RS 4
Hide offline contacts in roster panel.
.RE
.PP
\fBhide resource\fR
.RS 4
Hide contact's connected resources in roster panel.
.RE
.PP
\fBhide presence\fR
.RS 4
Hide contact's presence in roster panel.
.RE
.PP
\fBhide status\fR
.RS 4
Hide contact's status message in roster panel.
.RE
.PP
\fBhide empty\fR
.RS 4
Hide empty groups in roster panel.
.RE
.PP
\fBhide priority\fR
.RS 4
Hide resource priority in roster panel.
.RE
.PP
\fBhide contacts\fR
.RS 4
Hide contacts in roster panel.
.RE
.PP
\fBhide rooms\fR
.RS 4
Hide chat rooms in roster panel.
.RE
.PP
\fBby group\fR
.RS 4
Group contacts in roster panel by roster group.
.RE
.PP
\fBby presence\fR
.RS 4
Group contacts in roster panel by presence.
.RE
.PP
\fBby none\fR
.RS 4
No grouping in roster panel.
.RE
.PP
\fBcount unread\fR
.RS 4
Show unread message count with roster headers.
.RE
.PP
\fBcount items\fR
.RS 4
Show item count with roster headers.
.RE
.PP
\fBcount off\fR
.RS 4
Do not show any count with roster headers.
.RE
.PP
\fBcount zero on\fR
.RS 4
Show roster header count when 0.
.RE
.PP
\fBcount zero off\fR
.RS 4
Hide roster header count when 0.
.RE
.PP
\fBcolor on\fR
.RS 4
Enable generated color names (XEP-0392)
.RE
.PP
\fBcolor off\fR
.RS 4
Disable generated color names (XEP-0392)
.RE
.PP
\fBorder name\fR
.RS 4
Order roster contacts by name only.
.RE
.PP
\fBorder presence\fR
.RS 4
Order roster contacts by presence, and then by name.
.RE
.PP
\fBunread before\fR
.RS 4
Show unread message count before contact.
.RE
.PP
\fBunread after\fR
.RS 4
Show unread message count after contact.
.RE
.PP
\fBunread off\fR
.RS 4
Do not show unread message count for contacts.
.RE
.PP
\fBroom char <char>\fR
.RS 4
Prefix rooms with specified character.
.RE
.PP
\fBroom char none\fR
.RS 4
Remove room character prefix.
.RE
.PP
\fBroom private char <char>\fR
.RS 4
Prefix private room chat with specified character when displayed with room.
.RE
.PP
\fBroom private char none\fR
.RS 4
Remove private room chat character prefix when displayed with room.
.RE
.PP
\fBroom position first\fR
.RS 4
Show rooms first in roster.
.RE
.PP
\fBroom position last\fR
.RS 4
Show rooms last in roster.
.RE
.PP
\fBroom by service\fR
.RS 4
Group rooms by chat service.
.RE
.PP
\fBroom by none\fR
.RS 4
Do not group rooms.
.RE
.PP
\fBroom order name\fR
.RS 4
Order rooms by name.
.RE
.PP
\fBroom order unread\fR
.RS 4
Order rooms by unread messages, and then by name.
.RE
.PP
\fBroom unread before\fR
.RS 4
Show unread message count before room.
.RE
.PP
\fBroom unread after\fR
.RS 4
Show unread message count after room.
.RE
.PP
\fBroom unread off\fR
.RS 4
Do not show unread message count for rooms.
.RE
.PP
\fBroom show server\fR
.RS 4
Show the conference server with room JIDs.
.RE
.PP
\fBroom hide server\fR
.RS 4
Do not show the conference server with room JIDs.
.RE
.PP
\fBroom use name\fR
.RS 4
Use the MUC name as room name.
.RE
.PP
\fBroom use jid\fR
.RS 4
Use the JID as room name.
.RE
.PP
\fBprivate room\fR
.RS 4
Show room private chats with the room.
.RE
.PP
\fBprivate group\fR
.RS 4
Show room private chats as a separate roster group.
.RE
.PP
\fBprivate off\fR
.RS 4
Do not show room private chats.
.RE
.PP
\fBprivate char <char>\fR
.RS 4
Prefix private room chats with specified character when displayed in separate group.
.RE
.PP
\fBprivate char none\fR
.RS 4
Remove private room chat character prefix.
.RE
.PP
\fBheader char <char>\fR
.RS 4
Prefix roster headers with specified character.
.RE
.PP
\fBheader char none\fR
.RS 4
Remove roster header character prefix.
.RE
.PP
\fBcontact char <char>\fR
.RS 4
Prefix roster contacts with specified character.
.RE
.PP
\fBcontact char none\fR
.RS 4
Remove roster contact character prefix.
.RE
.PP
\fBcontact indent <indent>\fR
.RS 4
Indent contact line by <indent> spaces (0 to 10).
.RE
.PP
\fBresource char <char>\fR
.RS 4
Prefix roster resources with specified character.
.RE
.PP
\fBresource char none\fR
.RS 4
Remove roster resource character prefix.
.RE
.PP
\fBresource indent <indent>\fR
.RS 4
Indent resource line by <indent> spaces (0 to 10).
.RE
.PP
\fBresource join on|off\fR
.RS 4
Join resource with previous line when only one available resource.
.RE
.PP
\fBpresence indent <indent>\fR
.RS 4
Indent presence line by <indent> spaces (-1 to 10), a value of -1 will show presence on the previous line.
.RE
.PP
\fBsize <percent>\fR
.RS 4
Percentage of the screen taken up by the roster (1-99).
.RE
.PP
\fBwrap on|off\fR
.RS 4
Enable or disable line wrapping in roster panel.
.RE
.PP
\fBadd <jid> [<nick>]\fR
.RS 4
Add a new item to the roster.
.RE
.PP
\fBremove <jid>\fR
.RS 4
Removes an item from the roster.
.RE
.PP
\fBremove_all contacts\fR
.RS 4
Remove all items from roster.
.RE
.PP
\fBnick <jid> <nick>\fR
.RS 4
Change a contacts nickname.
.RE
.PP
\fBclearnick <jid>\fR
.RS 4
Removes the current nickname.
.RE
.PP
\fBgroup show <group>\fR
.RS 4
List all roster items in a group.
.RE
.PP
\fBgroup add <group> <contact>\fR
.RS 4
Add a contact to a group.
.RE
.PP
\fBgroup remove <group> <contact>\fR
.RS 4
Remove a contact from a group.
.RE
.SH EXAMPLES
/roster
.LP
/roster add odin@valhalla.edda
.LP
/roster add odin@valhalla.edda Allfather
.LP
/roster remove loki@ownserver.org
.LP
/roster nick odin@valhalla.edda "All Father"
.LP
/roster clearnick thor@valhalla.edda
.LP
/roster size 15
.LP
/roster group
.LP
/roster group show friends
.LP
/roster group add friends fenris@ownserver.org
.LP
/roster group add family Brother
.LP
/roster group remove colleagues boss@work.com
.LP

12
docs/profanity-save.1
View File

@ -1,12 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/save
.SH DESCRIPTION
Save preferences to configuration file.
.SH SYNOPSIS
/save
.LP

46
docs/profanity-script.1
View File

@ -1,46 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/script
.SH DESCRIPTION
Run command scripts. Scripts are stored in $XDG_DATA_HOME/profanity/scripts/ which is usually $HOME/.local/share/profanity/scripts/.
.SH SYNOPSIS
/script run <script>
.LP
/script list
.LP
/script show <script>
.LP
.SH ARGUMENTS
.PP
\fBscript run <script>\fR
.RS 4
Execute a script.
.RE
.PP
\fBscript list\fR
.RS 4
List all scripts TODO.
.RE
.PP
\fBscript show <script>\fR
.RS 4
Show the commands in script TODO.
.RE
.SH EXAMPLES
/script list
.LP
/script run myscript
.LP
/script show somescript
.LP

27
docs/profanity-sendfile.1
View File

@ -1,27 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/sendfile
.SH DESCRIPTION
Send a file using XEP-0363 HTTP file transfer.
.SH SYNOPSIS
/sendfile <file>
.LP
.SH ARGUMENTS
.PP
\fB<file>\fR
.RS 4
Path to the file.
.RE
.SH EXAMPLES
/sendfile /etc/hosts
.LP
/sendfile ~/images/sweet_cat.jpg
.LP

27
docs/profanity-serversoftware.1
View File

@ -1,27 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/serversoftware
.SH DESCRIPTION
Find server or component software version information.
.SH SYNOPSIS
/serversoftware <domain>
.LP
.SH ARGUMENTS
.PP
\fB<domain>\fR
.RS 4
The jid of your server or component.
.RE
.SH EXAMPLES
/serversoftware valhalla.edda
.LP
/serversoftware xmpp.vanaheimr.edda
.LP

12
docs/profanity-silence.1
View File

@ -1,12 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/silence
.SH DESCRIPTION
Let's you silence all message attempts from people who are not in your roster.
.SH SYNOPSIS
/silence on|off
.LP

19
docs/profanity-slashguard.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/slashguard
.SH DESCRIPTION
Slashguard won't accept a slash in the first 4 characters of your input field. It tries to protect you from typing ' /quit' and similar things in chats.
.SH SYNOPSIS
/slashguard on|off
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable or disable slashguard.
.RE

38
docs/profanity-software.1
View File

@ -1,38 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/software
.SH DESCRIPTION
Find out a contact, or room members software version information. If in private chat initiated from a chat room, no parameter is required. If the contact's software does not support software version requests, nothing will be displayed.
.SH SYNOPSIS
/software
.LP
/software <fulljid>|<nick>
.LP
.SH ARGUMENTS
.PP
\fB<fulljid>\fR
.RS 4
If in the console or a chat window, the full JID for which you wish to see software information.
.RE
.PP
\fB<nick>\fR
.RS 4
If in a chat room, nickname for which you wish to see software information.
.RE
.SH EXAMPLES
/software odin@valhalla.edda/laptop
.LP
/software odin@valhalla.edda/phone
.LP
/software thor
.LP

19
docs/profanity-splash.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/splash
.SH DESCRIPTION
Switch on or off the ascii logo on start up and when the /about command is called.
.SH SYNOPSIS
/splash on|off
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable or disable splash logo.
.RE

46
docs/profanity-stamp.1
View File

@ -1,46 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/stamp
.SH DESCRIPTION
Set chat window stamp. The format of line in the chat window is: "<timestamp> <encryption sign> <stamp> <message>" where <stamp> is "me:" for incoming messages or "username@server/resource" for outgoing messages. This command allows to change <stamp> value.
.SH SYNOPSIS
/stamp outgoing <string>
.LP
/stamp incoming <string>
.LP
/stamp unset outgoing|incoming
.LP
.SH ARGUMENTS
.PP
\fBoutgoing\fR
.RS 4
Set outgoing stamp
.RE
.PP
\fBincoming\fR
.RS 4
Set incoming stamp
.RE
.PP
\fBunset outgoing|incoming\fR
.RS 4
Use the defaults
.RE
.SH EXAMPLES
/stamp outgoing -->
.LP
/stamp incoming <--
.LP
/stamp unset incoming
.LP

19
docs/profanity-states.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/states
.SH DESCRIPTION
Send chat state notifications to recipient during chat sessions, such as typing, paused, active, gone.
.SH SYNOPSIS
/states on|off
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable or disable sending of chat state notifications.
.RE

48
docs/profanity-status.1
View File

@ -1,48 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/status
.SH DESCRIPTION
/status get: Find out a contact, or room members presence information. /status set: set own status.
.SH SYNOPSIS
/status set <state> ["<message>"]
.LP
/status get <contact>|<nick>
.LP
.SH ARGUMENTS
.PP
\fB<state>\fR
.RS 4
Own status. Possible values: chat, online, away, dnd, xa
.RE
.PP
\fB<message>\fR
.RS 4
Optional message to use with the status. Needs quotation marks if it's more than one word.
.RE
.PP
\fB<contact>\fR
.RS 4
The contact who's presence you which to see.
.RE
.PP
\fB<nick>\fR
.RS 4
If in a chat room, the occupant who's presence you wish to see.
.RE
.SH EXAMPLES
/status get odin@valhalla.edda
.LP
/status get jon
.LP
/status set online
.LP

124
docs/profanity-statusbar.1
View File

@ -1,124 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/statusbar
.SH DESCRIPTION
Manage statusbar display preferences.
.SH SYNOPSIS
/statusbar show name|number|read
.LP
/statusbar hide name|number|read
.LP
/statusbar maxtabs <value>
.LP
/statusbar tablen <value>
.LP
/statusbar tabmode default|actlist
.LP
/statusbar self user|barejid|fulljid|off
.LP
/statusbar chat user|jid
.LP
/statusbar room room|jid
.LP
/statusbar up
.LP
/statusbar down
.LP
.SH ARGUMENTS
.PP
\fBmaxtabs <value>\fR
.RS 4
Set the maximum number of tabs to display, <value> must be between 0 and 10.
.RE
.PP
\fBtablen <value>\fR
.RS 4
Set the maximum number of characters to show as the tab name, 0 sets to unlimited.
.RE
.PP
\fBtabmode default|actlist\fR
.RS 4
Set the mode how the 'active tabs' are shown.
.RE
.PP
\fBshow|hide name\fR
.RS 4
Show or hide names in tabs.
.RE
.PP
\fBshow|hide number\fR
.RS 4
Show or hide numbers in tabs.
.RE
.PP
\fBshow|hide read\fR
.RS 4
Show or hide inactive tabs.
.RE
.PP
\fBself user|barejid|fulljid\fR
.RS 4
Show account user name, barejid, fulljid as status bar title.
.RE
.PP
\fBself off\fR
.RS 4
Disable showing self as status bar title.
.RE
.PP
\fBchat user|jid\fR
.RS 4
Show users name, or fulljid. Change needs a redraw/restart to take effect.
.RE
.PP
\fBroom room|jid\fR
.RS 4
Show room name, or the fulljid for room tabs.
.RE
.PP
\fBup\fR
.RS 4
Move the status bar up the screen.
.RE
.PP
\fBdown\fR
.RS 4
Move the status bar down the screen.
.RE
.SH EXAMPLES
/statusbar maxtabs 8
.LP
/statusbar tablen 5
.LP
/statusbar tabmode actlist
.LP
/statusbar self user
.LP
/statusbar chat jid
.LP
/statusbar hide read
.LP
/statusbar hide name
.LP

35
docs/profanity-strophe.1
View File

@ -1,35 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/strophe
.SH DESCRIPTION
Modify libstrophe settings.
.SH SYNOPSIS
/strophe verbosity 0-3
.LP
/strophe sm on|no-resend|off
.LP
.SH ARGUMENTS
.PP
\fBverbosity 0-3\fR
.RS 4
Set libstrophe verbosity level when log level is 'DEBUG'.
.RE
.PP
\fBsm on|no-resend|off\fR
.RS 4
Enable or disable Stream-Management (SM) as of XEP-0198. The 'no-resend' option enables SM, but won't re-send un-ACK'ed messages on re-connect.
.RE
.SH EXAMPLES
/strophe verbosity 3
.LP
/strophe sm no-resend
.LP

73
docs/profanity-sub.1
View File

@ -1,73 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/sub
.SH DESCRIPTION
Manage subscriptions to contact presence. If jid is omitted, the contact of the current window is used.
.SH SYNOPSIS
/sub request [<jid>]
.LP
/sub allow [<jid>]
.LP
/sub deny [<jid>]
.LP
/sub show [<jid>]
.LP
/sub sent
.LP
/sub received
.LP
.SH ARGUMENTS
.PP
\fBrequest [<jid>]\fR
.RS 4
Send a subscription request to the user.
.RE
.PP
\fBallow [<jid>]\fR
.RS 4
Approve a contact's subscription request.
.RE
.PP
\fBdeny [<jid>]\fR
.RS 4
Remove subscription for a contact, or deny a request.
.RE
.PP
\fBshow [<jid>]\fR
.RS 4
Show subscription status for a contact.
.RE
.PP
\fBsent\fR
.RS 4
Show all sent subscription requests pending a response.
.RE
.PP
\fBreceived\fR
.RS 4
Show all received subscription requests awaiting your response.
.RE
.SH EXAMPLES
/sub request odin@valhalla.edda
.LP
/sub allow odin@valhalla.edda
.LP
/sub request
.LP
/sub sent
.LP

59
docs/profanity-subject.1
View File

@ -1,59 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/subject
.SH DESCRIPTION
Set, modify, or clear room subject.
.SH SYNOPSIS
/subject set <subject>
.LP
/subject edit <subject>
.LP
/subject editor
.LP
/subject prepend <text>
.LP
/subject append <text>
.LP
/subject clear
.LP
.SH ARGUMENTS
.PP
\fBset <subject>\fR
.RS 4
Set the room subject.
.RE
.PP
\fBedit <subject>\fR
.RS 4
Edit the current room subject, tab autocompletion will display the subject to edit.
.RE
.PP
\fBeditor\fR
.RS 4
Edit the current room subject in external editor.
.RE
.PP
\fBprepend <text>\fR
.RS 4
Prepend text to the current room subject, use double quotes if a trailing space is needed.
.RE
.PP
\fBappend <text>\fR
.RS 4
Append text to the current room subject, use double quotes if a preceding space is needed.
.RE
.PP
\fBclear\fR
.RS 4
Clear the room subject.
.RE

59
docs/profanity-theme.1
View File

@ -1,59 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/theme
.SH DESCRIPTION
Load a theme, includes colours and UI options.
.SH SYNOPSIS
/theme list
.LP
/theme load <theme>
.LP
/theme full-load <theme>
.LP
/theme colours
.LP
/theme properties
.LP
.SH ARGUMENTS
.PP
\fBlist\fR
.RS 4
List all available themes.
.RE
.PP
\fBload <theme>\fR
.RS 4
Load colours from specified theme. 'default' will reset to the default theme.
.RE
.PP
\fBfull-load <theme>\fR
.RS 4
Same as 'load' but will also load preferences set in the theme, not just colours.
.RE
.PP
\fBcolours\fR
.RS 4
Show colour values as rendered by the terminal.
.RE
.PP
\fBproperties\fR
.RS 4
Show colour settings for current theme.
.RE
.SH EXAMPLES
/theme list
.LP
/theme load forest
.LP

139
docs/profanity-time.1
View File

@ -1,139 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/time
.SH DESCRIPTION
Configure time display preferences. Time formats are strings supported by g_date_time_format. See https://developer.gnome.org/glib/stable/glib-GDateTime.html#g-date-time-format for more details. Setting the format to an unsupported string, will display the string. If the format contains spaces, it must be surrounded with double quotes.
.SH SYNOPSIS
/time all|console|chat|muc|config|private|xml set <format>
.LP
/time all|console|chat|muc|config|private|xml off
.LP
/time statusbar set <format>
.LP
/time statusbar off
.LP
/time lastactivity set <format>
.LP
/time vcard set <format>
.LP
.SH ARGUMENTS
.PP
\fBconsole set <format>\fR
.RS 4
Set time format for console window.
.RE
.PP
\fBconsole off\fR
.RS 4
Do not show time in console window.
.RE
.PP
\fBchat set <format>\fR
.RS 4
Set time format for chat windows.
.RE
.PP
\fBchat off\fR
.RS 4
Do not show time in chat windows.
.RE
.PP
\fBmuc set <format>\fR
.RS 4
Set time format for chat room windows.
.RE
.PP
\fBmuc off\fR
.RS 4
Do not show time in chat room windows.
.RE
.PP
\fBconfig set <format>\fR
.RS 4
Set time format for config windows.
.RE
.PP
\fBconfig off\fR
.RS 4
Do not show time in config windows.
.RE
.PP
\fBprivate set <format>\fR
.RS 4
Set time format for private chat windows.
.RE
.PP
\fBprivate off\fR
.RS 4
Do not show time in private chat windows.
.RE
.PP
\fBxml set <format>\fR
.RS 4
Set time format for XML console window.
.RE
.PP
\fBxml off\fR
.RS 4
Do not show time in XML console window.
.RE
.PP
\fBstatusbar set <format>\fR
.RS 4
Change time format in statusbar.
.RE
.PP
\fBstatusbar off\fR
.RS 4
Do not show time in status bar.
.RE
.PP
\fBlastactivity set <format>\fR
.RS 4
Change time format for last activity.
.RE
.PP
\fBvcard set <format>\fR
.RS 4
Change the time format used to display time/dates in vCard (such as birthdays)
.RE
.PP
\fBall set <format>\fR
.RS 4
Set time for: console, chat, muc, config, private, and xml windows.
.RE
.PP
\fBall off\fR
.RS 4
Do not show time for: console, chat, muc, config, private and xml windows.
.RE
.SH EXAMPLES
/time console set %H:%M:%S
.LP
/time chat set "%d-%m-%y %H:%M:%S"
.LP
/time xml off
.LP
/time statusbar set %H:%M
.LP
/time lastactivity set "%d-%m-%y %H:%M:%S"
.LP
/time all set "%d-%m-%y %H:%M:%S"
.LP

66
docs/profanity-titlebar.1
View File

@ -1,66 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/titlebar
.SH DESCRIPTION
Titlebar settings.
.SH SYNOPSIS
/titlebar up
.LP
/titlebar down
.LP
/titlebar show|hide [encwarn|resource|tls]
.LP
.SH ARGUMENTS
.PP
\fBup\fR
.RS 4
Move the title bar up the screen.
.RE
.PP
\fBdown\fR
.RS 4
Move the title bar down the screen.
.RE
.PP
\fBshow tls\fR
.RS 4
Show or hide TLS indicator in the titlebar.
.RE
.PP
\fBshow encwarn\fR
.RS 4
Enable or disable the unencrypted warning message in the titlebar.
.RE
.PP
\fBshow resource\fR
.RS 4
Show or hide the current resource in the titlebar.
.RE
.PP
\fBshow name\fR
.RS 4
Show the nickname or MUC name in the titlebar.
.RE
.PP
\fBshow jid\fR
.RS 4
Show the JID in the titlebar.
.RE
.SH EXAMPLES
/titlebar up
.LP
/titlebar show tls
.LP
/titlebar hide encwarn
.LP

104
docs/profanity-tls.1
View File

@ -1,104 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/tls
.SH DESCRIPTION
Handle TLS certificates.
.SH SYNOPSIS
/tls allow
.LP
/tls always
.LP
/tls deny
.LP
/tls cert [<fingerprint>]
.LP
/tls trust
.LP
/tls trusted
.LP
/tls revoke <fingerprint>
.LP
/tls certpath
.LP
/tls certpath set <path>
.LP
/tls certpath clear
.LP
/tls certpath default
.LP
.SH ARGUMENTS
.PP
\fBallow\fR
.RS 4
Allow connection to continue with TLS certificate.
.RE
.PP
\fBalways\fR
.RS 4
Always allow connections with TLS certificate.
.RE
.PP
\fBdeny\fR
.RS 4
Abort connection.
.RE
.PP
\fBcert\fR
.RS 4
Show the current TLS certificate.
.RE
.PP
\fBcert <fingerprint>\fR
.RS 4
Show details of trusted certificate.
.RE
.PP
\fBtrust\fR
.RS 4
Add the current TLS certificate to manually trusted certificates.
.RE
.PP
\fBtrusted\fR
.RS 4
List summary of manually trusted certificates (with '/tls always' or '/tls trust').
.RE
.PP
\fBrevoke <fingerprint>\fR
.RS 4
Remove a manually trusted certificate.
.RE
.PP
\fBcertpath\fR
.RS 4
Show the trusted certificate path.
.RE
.PP
\fBcertpath set <path>\fR
.RS 4
Specify filesystem path containing trusted certificates.
.RE
.PP
\fBcertpath clear\fR
.RS 4
Clear the trusted certificate path.
.RE
.PP
\fBcertpath default\fR
.RS 4
Use default system certificate path, if it can be found.
.RE

35
docs/profanity-tray.1
View File

@ -1,35 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/tray
.SH DESCRIPTION
Display an icon in the tray that will indicate new messages.
.SH SYNOPSIS
/tray on|off
.LP
/tray read on|off
.LP
/tray timer <seconds>
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Show tray icon.
.RE
.PP
\fBread on|off\fR
.RS 4
Show tray icon when no unread messages.
.RE
.PP
\fBtimer <seconds>\fR
.RS 4
Set tray icon timer, seconds must be between 1-10.
.RE

35
docs/profanity-url.1
View File

@ -1,35 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/url
.SH DESCRIPTION
Open or save URLs. This works with OMEMO encrypted files as well.
.SH SYNOPSIS
/url open <url>
.LP
/url save <url> [<path>]
.LP
.SH ARGUMENTS
.PP
\fBopen\fR
.RS 4
Open URL with predefined executable.
.RE
.PP
\fBsave\fR
.RS 4
Save URL to optional path, default path is current directory.
.RE
.SH EXAMPLES
/url open https://profanity-im.github.io
.LP
/url save https://profanity-im.github.io/guide/latest/userguide.html /home/user/Download/
.LP

400
docs/profanity-vcard.1
View File

@ -1,400 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/vcard
.SH DESCRIPTION
Read your vCard or a user's vCard, get a user's avatar via their vCard, or modify your vCard. If no arguments are given, your vCard will be displayed in a new window, or an existing vCard window.
.SH SYNOPSIS
/vcard get [<nick|contact>]
.LP
/vcard photo open <nick|contact> [<index>]
.LP
/vcard photo save <nick|contact> [output <filepath>] [index <index>]
.LP
/vcard set fullname <fullname>
.LP
/vcard set name family <family>
.LP
/vcard set name given <given>
.LP
/vcard set name middle <middle>
.LP
/vcard set name prefix <prefix>
.LP
/vcard set name suffix <suffix>
.LP
/vcard set <index> [<value>]
.LP
/vcard set <index> pobox <value>
.LP
/vcard set <index> extaddr <value>
.LP
/vcard set <index> street <value>
.LP
/vcard set <index> locality <value>
.LP
/vcard set <index> region <value>
.LP
/vcard set <index> pocode <value>
.LP
/vcard set <index> country <value>
.LP
/vcard set <index> type domestic|international
.LP
/vcard set <index> home on|off
.LP
/vcard set <index> work on|off
.LP
/vcard set <index> voice on|off
.LP
/vcard set <index> fax on|off
.LP
/vcard set <index> pager on|off
.LP
/vcard set <index> msg on|off
.LP
/vcard set <index> cell on|off
.LP
/vcard set <index> video on|off
.LP
/vcard set <index> bbs on|off
.LP
/vcard set <index> modem on|off
.LP
/vcard set <index> isdn on|off
.LP
/vcard set <index> pcs on|off
.LP
/vcard set <index> preferred on|off
.LP
/vcard set <index> parcel on|off
.LP
/vcard set <index> postal on|off
.LP
/vcard set <index> internet on|off
.LP
/vcard set <index> x400 on|off
.LP
/vcard add nickname <nickname>
.LP
/vcard add birthday <date>
.LP
/vcard add address
.LP
/vcard add tel <number>
.LP
/vcard add email <userid>
.LP
/vcard add jid <jid>
.LP
/vcard add title <title>
.LP
/vcard add role <role>
.LP
/vcard add note <note>
.LP
/vcard add url <url>
.LP
/vcard remove <index>
.LP
/vcard refresh
.LP
/vcard save
.LP
.SH ARGUMENTS
.PP
\fBget [<nick|contact>]\fR
.RS 4
Get your vCard, if a nickname/contact is provided, get that user's vCard
.RE
.PP
\fBphoto open <nick|contact> [<index>]\fR
.RS 4
Download a user's photo from their vCard to a file, and open it. If index is not specified, download the first photo (usually avatar) from their vCard
.RE
.PP
\fBphoto save <nick|contact>\fR
.RS 4
Download a user's photo from their vCard to a file. If index is not specified, download the first photo (usually avatar) from their vCard. If output is not specified, download the photo to profanity's photos directory.
.RE
.PP
\fBphoto open-self [<index>]\fR
.RS 4
Download a photo from your vCard to a file, and open it. If index is not specified, download the first photo (usually avatar) from your vCard
.RE
.PP
\fBphoto save-self\fR
.RS 4
Download a photo from your vCard to a file. If index is not specified, download the first photo (usually avatar) from your vCard. If output is not specified, download the photo to profanity's photos directory. Same arguments as `photo open`
.RE
.PP
\fBset fullname <fullname>\fR
.RS 4
Set your vCard's fullname to the specified value
.RE
.PP
\fBset name family <family>\fR
.RS 4
Set your vCard's family name to the specified value
.RE
.PP
\fBset name given <given>\fR
.RS 4
Set your vCard's given name to the specified value
.RE
.PP
\fBset name middle <middle>\fR
.RS 4
Set your vCard's middle name to the specified value
.RE
.PP
\fBset name prefix <prefix>\fR
.RS 4
Set your vCard's prefix name to the specified value
.RE
.PP
\fBset name suffix <suffix>\fR
.RS 4
Set your vCard's suffix name to the specified value
.RE
.PP
\fBset <index> [<value>]\fR
.RS 4
Set the main field in a element in your vCard to the specified value, or if no value was specified, modify the field in an editor, This only works in elements that have one field.
.RE
.PP
\fBset <index> pobox <value>\fR
.RS 4
Set the P.O. box in an address element in your vCard to the specified value.
.RE
.PP
\fBset <index> extaddr <value>\fR
.RS 4
Set the extended address in an address element in your vCard to the specified value.
.RE
.PP
\fBset <index> street <value>\fR
.RS 4
Set the street in an address element in your vCard to the specified value.
.RE
.PP
\fBset <index> locality <value>\fR
.RS 4
Set the locality in an address element in your vCard to the specified value.
.RE
.PP
\fBset <index> region <value>\fR
.RS 4
Set the region in an address element in your vCard to the specified value.
.RE
.PP
\fBset <index> pocode <value>\fR
.RS 4
Set the P.O. code in an address element in your vCard to the specified value.
.RE
.PP
\fBset <index> type domestic|international\fR
.RS 4
Set the type in an address element in your vCard to either domestic or international.
.RE
.PP
\fBset <index> home on|off\fR
.RS 4
Set the home option in an element in your vCard. (address, telephone, e-mail only)
.RE
.PP
\fBset <index> work on|off\fR
.RS 4
Set the work option in an element in your vCard. (address, telephone, e-mail only)
.RE
.PP
\fBset <index> voice on|off\fR
.RS 4
Set the voice option in a telephone element in your vCard.
.RE
.PP
\fBset <index> fax on|off\fR
.RS 4
Set the fax option in a telephone element in your vCard.
.RE
.PP
\fBset <index> pager on|off\fR
.RS 4
Set the pager option in a telephone element in your vCard.
.RE
.PP
\fBset <index> msg on|off\fR
.RS 4
Set the message option in a telephone element in your vCard.
.RE
.PP
\fBset <index> cell on|off\fR
.RS 4
Set the cellphone option in a telephone element in your vCard.
.RE
.PP
\fBset <index> video on|off\fR
.RS 4
Set the video option in a telephone element in your vCard.
.RE
.PP
\fBset <index> bbs on|off\fR
.RS 4
Set the BBS option in a telephone element in your vCard.
.RE
.PP
\fBset <index> modem on|off\fR
.RS 4
Set the modem option in a telephone element in your vCard.
.RE
.PP
\fBset <index> isdn on|off\fR
.RS 4
Set the ISDN option in a telephone element in your vCard.
.RE
.PP
\fBset <index> pcs on|off\fR
.RS 4
Set the PCS option in a telephone element in your vCard.
.RE
.PP
\fBset <index> preferred on|off\fR
.RS 4
Set the preferred option in an element in your vCard. (address, telephone, e-mail only)
.RE
.PP
\fBset <index> parcel on|off\fR
.RS 4
Set the parcel option in an address element in your vCard.
.RE
.PP
\fBset <index> postal on|off\fR
.RS 4
Set the postal option in an address element in your vCard.
.RE
.PP
\fBset <index> internet on|off\fR
.RS 4
Set the internet option in an e-mail address in your vCard.
.RE
.PP
\fBset <index> x400 on|off\fR
.RS 4
Set the X400 option in an e-mail address in your vCard.
.RE
.PP
\fBadd nickname <nickname>\fR
.RS 4
Add a nickname to your vCard
.RE
.PP
\fBadd birthday <date>\fR
.RS 4
Add a birthday date to your vCard
.RE
.PP
\fBadd address\fR
.RS 4
Add an address to your vCard
.RE
.PP
\fBadd tel <number>\fR
.RS 4
Add a telephone number to your vCard
.RE
.PP
\fBadd email <userid>\fR
.RS 4
Add an e-mail address to your vCard
.RE
.PP
\fBadd jid <jid>\fR
.RS 4
Add a Jabber ID to your vCard
.RE
.PP
\fBadd title <title>\fR
.RS 4
Add a title to your vCard
.RE
.PP
\fBadd role <role>\fR
.RS 4
Add a role to your vCard
.RE
.PP
\fBadd note <note>\fR
.RS 4
Add a note to your vCard
.RE
.PP
\fBadd url <url>\fR
.RS 4
Add a URL to your vCard
.RE
.PP
\fBremove <index>\fR
.RS 4
Remove a element in your vCard by index
.RE
.PP
\fBrefresh\fR
.RS 4
Refreshes the local copy of the current account's vCard (undoes all your unpublished modifications)
.RE
.PP
\fBsave\fR
.RS 4
Save changes to the server
.RE

19
docs/profanity-vercheck.1
View File

@ -1,19 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/vercheck
.SH DESCRIPTION
Check for new versions when Profanity starts, and when the /about command is run.
.SH SYNOPSIS
/vercheck on|off
.LP
.SH ARGUMENTS
.PP
\fBon|off\fR
.RS 4
Enable or disable the version check.
.RE

83
docs/profanity-who.1
View File

@ -1,83 +0,0 @@
.TH man 1 "2023-08-03" "0.13.1" "Profanity XMPP client"
.SH NAME
/who
.SH DESCRIPTION
Show contacts or room occupants with chosen status, role or affiliation.
.SH SYNOPSIS
/who
.LP
/who online|offline|away|dnd|xa|chat|available|unavailable|any [<group>]
.LP
/who moderator|participant|visitor
.LP
/who owner|admin|member|none
.LP
.SH ARGUMENTS
.PP
\fBoffline|away|dnd|xa|chat\fR
.RS 4
Show contacts or room occupants with specified presence.
.RE
.PP
\fBonline\fR
.RS 4
Contacts that are online, chat, away, xa, dnd.
.RE
.PP
\fBavailable\fR
.RS 4
Contacts that are available for chat - online, chat.
.RE
.PP
\fBunavailable\fR
.RS 4
Contacts that are not available for chat - offline, away, xa, dnd.
.RE
.PP
\fBany\fR
.RS 4
Contacts with any status (same as calling with no argument).
.RE
.PP
\fB<group>\fR
.RS 4
Filter the results by the specified roster group, not applicable in chat rooms.
.RE
.PP
\fBmoderator|participant|visitor\fR
.RS 4
Room occupants with the specified role.
.RE
.PP
\fBowner|admin|member|none\fR
.RS 4
Room occupants with the specified affiliation.
.RE
.SH EXAMPLES
/who
.LP
/who xa
.LP
/who online friends
.LP
/who any family
.LP
/who participant
.LP
/who admin
.LP

Some files were not shown because too many files have changed in this diff Show More