Philipp Hörist pushed to branch master at gajim / gajim

Commits:

5 changed files:

Changes:

  • CONTRIBUTING.md
    ... ... @@ -58,3 +58,15 @@ # Commit Messages
    58 58
     Example:
    
    59 59
     
    
    60 60
     `feat: New Button which does something`
    
    61
    +
    
    62
    +# Man Pages
    
    63
    +
    
    64
    +Man pages are written in markdown and converted with pandoc
    
    65
    +
    
    66
    +While developing this command is useful to preview the manpage
    
    67
    +
    
    68
    +    $ pandoc gajim.1.md -s -t man | /usr/bin/man -l -
    
    69
    +
    
    70
    +To convert the markdown
    
    71
    +
    
    72
    +    $ pandoc gajim.1.md -s -t man -o gajim.1

  • data/gajim-remote.1
    1
    -.Dd January 21, 2018
    
    2
    -.Dt GAJIM-REMOTE 1 URM
    
    3
    -.Os UNIX
    
    4
    -.Sh NAME
    
    5
    -.Nm gajim-remote
    
    6
    -.Nd a remote control utility for
    
    7
    -.Xr gajim 1
    
    8
    -.Sh SYNOPSIS
    
    9
    -.Nm
    
    10
    -.Ar command
    
    11
    -.Sh DESCRIPTION
    
    12
    -.Nm
    
    13
    -is a script to control and communicate with a running instance of
    
    14
    -.Xr gajim 1
    
    15
    -by D-Bus.
    
    16
    -.Sh OPTIONS
    
    17
    -.Bl -tag -width Ds
    
    18
    -.It Available commands
    
    19
    -.El
    
    20
    -.Ss account_info Aq account
    
    21
    -Gets detailed info on a account
    
    22
    -.Ss change_status Bo status Bc Bo message Bc Bq account
    
    23
    -Changes the status of account or accounts
    
    24
    -.Ss check_gajim_running
    
    25
    -Check if Gajim is running
    
    26
    -.Ss contact_info Aq jid
    
    27
    -Gets detailed info on a contact
    
    28
    -.Ss get_status Bq account
    
    29
    -Returns current status (the global one unless account is specified)
    
    30
    -.Ss get_status_message Bq account
    
    31
    -Returns current status message (the global one unless account is specified)
    
    32
    -.Ss get_unread_msgs_number
    
    33
    -Returns number of unread messages
    
    34
    -.Ss help Bq command 
    
    35
    -Shows a help on specific command
    
    36
    -.Ss list_accounts
    
    37
    -Prints a list of registered accounts
    
    38
    -.Ss list_contacts Bq account
    
    39
    -Prints a list of all contacts in the roster. Each contact appears on a separate line
    
    40
    -.Ss remove_contact Ao jid Ac Bq account
    
    41
    -Removes contact from roster
    
    42
    -.Ss send_chat_message Ao jid Ac Ao message Ac Bo PGP key Bc Bq account
    
    43
    -Sends new chat message to a contact in the roster. Both OpenPGP key and account are optional. If you want to set only 'account', without 'OpenPGP key', just set 'OpenPGP key' to ''.
    
    44
    -.Ss send_file Ao file Ac Ao jid Ac Bq account
    
    45
    -Sends file to a contact
    
    46
    -.Ss send_groupchat_message Ao room_jid Ac Ao message Ac Bq account
    
    47
    -Sends new message to a groupchat you've joined.
    
    48
    -.Ss send_single_message Ao jid subject Ac Ao message Ac Bo PGP key Bc Bq account
    
    49
    -Sends new single message to a contact in the roster. Both OpenPGP key and account are optional. If you want to set only 'account', without 'OpenPGP key', just set 'OpenPGP key' to ''.
    
    50
    -.Ss send_xml Ao xml Ac Bq account
    
    51
    -Sends custom XML
    
    52
    -.Ss set_priority Ao priority Ac Bq account
    
    53
    -Changes the priority of account or accounts
    
    54
    -.Ss show_next_pending_event
    
    55
    -Pops up a window with the next pending event
    
    56
    -.Ss toggle_roster_appearance
    
    57
    -Shows or hides the roster window
    
    58
    -.Sh EXAMPLES
    
    59
    -Open a URI of group chat gajim
    
    60
    -.Pp
    
    61
    -.Dl $ gajim-remote handle_uri xmpp:gajim@conference.gajim.org?join
    
    62
    -.Pp
    
    63
    -Send custom XML
    
    64
    -.Pp
    
    65
    -.Dl $ gajim-remote send_xml $(cat Pa filename.xml ) Qq your@jabber.id
    
    66
    -.Sh AUTHORS
    
    67
    -.An -nosplit
    
    68
    -.Nm
    
    69
    -is written and maintained by
    
    70
    -.An Yann Leboulanger ,
    
    71
    -and
    
    72
    -.An Denis Fomin ,
    
    73
    -with contributions and patches merged from many individuals around the world.
    
    74
    -See files
    
    75
    -.Pa AUTHORS
    
    76
    -and
    
    77
    -.Pa THANKS ,
    
    78
    -for a complete list.
    
    79
    -.Sh COPYRIGHT
    
    80
    -Copyright (C) 2003-2022 Gajim Team
    
    81
    -.Pp
    
    82
    -.Nm
    
    83
    -is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 3 only.
    
    84
    -.Pp
    
    85
    -.Nm
    
    86
    -is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
    
    87
    -.Pp
    
    88
    -You should have received a copy of the GNU General Public License along with
    
    89
    -.Nm .
    
    90
    -If not, see <https://www.gnu.org/licenses/>.
    
    91
    -.Sh FEEDBACK
    
    92
    -You can report bugs or feature requests in our bug tracker at
    
    93
    -.Em https://dev.gajim.org/gajim/gajim/issues
    
    94
    -or in the
    
    95
    -.Em gajim-devel
    
    96
    -mailing list; if you want to send us a patch, please do so in our bug tracker.
    
    97
    -You can also find us in our chat room.
    
    98
    -.Sh WWW
    
    99
    -https://www.gajim.org/
    
    100
    -.Sh XMPP
    
    101
    -You are welcome to join us at gajim@conference.gajim.org
    
    102
    -.Sh MAILING LIST
    
    103
    -Below are public mailing lists on lists.gajim.org
    
    104
    -.Bd -literal -offset indent
    
    105
    -https://lists.gajim.org/cgi-bin/listinfo/gajim-devel
    
    106
    -https://lists.gajim.org/cgi-bin/listinfo/translators
    
    107
    -.Ed
    
    108
    -.Pp
    
    109
    -More mailing lists at
    
    110
    -.Bd -literal -offset indent
    
    111
    -https://lists.gajim.org/cgi-bin/listinfo
    
    112
    -.Ed
    
    113
    -.Sh BUGS
    
    114
    -Please submit bugs at https://dev.gajim.org/gajim/gajim/issues
    
    115
    -.Sh SEE ALSO
    
    116
    -.Xr gajim 1
    1
    +.\" Automatically generated by Pandoc 2.9.2.1
    
    2
    +.\"
    
    3
    +.TH "gajim-remote" "1" "August 2022" "" "Manual"
    
    4
    +.hy
    
    5
    +.SH NAME
    
    6
    +.PP
    
    7
    +gajim-remote - a remote control utility for \f[B]gajim\f[R](1)
    
    8
    +.SH SYNOPSIS
    
    9
    +.PP
    
    10
    +gajim-remote -h
    
    11
    +.PD 0
    
    12
    +.P
    
    13
    +.PD
    
    14
    +gajim-remote \f[I]command\f[R] [arguments \&...]
    
    15
    +.SH DESCRIPTION
    
    16
    +.PP
    
    17
    +gajim-remote is an application to control and communicate with a running
    
    18
    +instance of \f[B]gajim\f[R](1) via dbus.
    
    19
    +.SH OPTIONS
    
    20
    +.TP
    
    21
    +\f[B]\f[CB]-h, --help\f[B]\f[R]
    
    22
    +Display the help
    
    23
    +.TP
    
    24
    +\f[B]\f[CB]--app-id\f[B]\f[R] APP_ID
    
    25
    +The application id of the running \f[B]gajim\f[R](1) instance
    
    26
    +.SH COMMANDS
    
    27
    +.TP
    
    28
    +\f[B]\f[CB]list_contacts\f[B]\f[R] account
    
    29
    +Get all roster contacts
    
    30
    +.TP
    
    31
    +\f[B]\f[CB]list_accounts\f[B]\f[R]
    
    32
    +Get the list of accounts
    
    33
    +.TP
    
    34
    +\f[B]\f[CB]change_status\f[B]\f[R] {offline,online,away,xa,dnd} message account
    
    35
    +Change the status
    
    36
    +.TP
    
    37
    +\f[B]\f[CB]send_chat_message\f[B]\f[R] address message account
    
    38
    +Send a chat message to a contact
    
    39
    +.TP
    
    40
    +\f[B]\f[CB]send_groupchat_message\f[B]\f[R] address message account
    
    41
    +Send a chat message to a group chat
    
    42
    +.TP
    
    43
    +\f[B]\f[CB]account_info\f[B]\f[R] account
    
    44
    +Get account details
    
    45
    +.TP
    
    46
    +\f[B]\f[CB]get_status\f[B]\f[R] account
    
    47
    +Get the current status
    
    48
    +.TP
    
    49
    +\f[B]\f[CB]get_status_message\f[B]\f[R] account
    
    50
    +Get the current status message
    
    51
    +.TP
    
    52
    +\f[B]\f[CB]get_unread_msgs_number\f[B]\f[R]
    
    53
    +Get the unread message count
    
    54
    +.SH BUGS
    
    55
    +.PP
    
    56
    +Please submit bugs at https://dev.gajim.org/gajim/gajim/issues.
    
    57
    +.SH SUPPORT
    
    58
    +.PP
    
    59
    +You are welcome to join us at xmpp:gajim\[at]conference.gajim.org?join.
    
    60
    +.SH COPYRIGHT
    
    61
    +.PP
    
    62
    +gajim is free software; you can redistribute it and/or modify it under
    
    63
    +the terms of the GNU General Public License as published by the Free
    
    64
    +Software Foundation; version 3 only.
    
    65
    +.PP
    
    66
    +gajim is distributed in the hope that it will be useful, but WITHOUT ANY
    
    67
    +WARRANTY; without even the implied warranty of MERCHANTABILITY or
    
    68
    +FITNESS FOR A PARTICULAR PURPOSE.
    
    69
    +See the GNU General Public License for more details.
    
    70
    +.SH AUTHORS
    
    71
    +Philipp H\[:o]rist, Yann Leboulanger.

  • data/gajim-remote.1.md
    1
    +% gajim-remote(1) | Manual
    
    2
    +% Philipp Hörist, Yann Leboulanger
    
    3
    +% August 2022
    
    4
    +
    
    5
    +# NAME
    
    6
    +
    
    7
    +gajim-remote - a remote control utility for **gajim**(1)
    
    8
    +
    
    9
    +# SYNOPSIS
    
    10
    +
    
    11
    +gajim-remote -h\
    
    12
    +gajim-remote *command* [arguments ...]
    
    13
    +
    
    14
    +# DESCRIPTION
    
    15
    +
    
    16
    +gajim-remote is an application to control and communicate with a running instance of **gajim**(1) via dbus.
    
    17
    +
    
    18
    +# OPTIONS
    
    19
    +
    
    20
    +`-h, --help`
    
    21
    +: Display the help
    
    22
    +
    
    23
    +`--app-id` APP_ID
    
    24
    +: The application id of the running **gajim**(1) instance
    
    25
    +
    
    26
    +# COMMANDS
    
    27
    +
    
    28
    +`list_contacts` account
    
    29
    +: Get all roster contacts
    
    30
    +
    
    31
    +`list_accounts`
    
    32
    +: Get the list of accounts
    
    33
    +
    
    34
    +`change_status` {offline,online,away,xa,dnd} message account
    
    35
    +: Change the status
    
    36
    +
    
    37
    +`send_chat_message` address message account
    
    38
    +: Send a chat message to a contact
    
    39
    +
    
    40
    +`send_groupchat_message` address message account
    
    41
    +: Send a chat message to a group chat
    
    42
    +
    
    43
    +`account_info` account
    
    44
    +: Get account details
    
    45
    +
    
    46
    +`get_status` account
    
    47
    +: Get the current status
    
    48
    +
    
    49
    +`get_status_message` account
    
    50
    +: Get the current status message
    
    51
    +
    
    52
    +`get_unread_msgs_number`
    
    53
    +: Get the unread message count
    
    54
    +
    
    55
    +# BUGS
    
    56
    +
    
    57
    +Please submit bugs at https://dev.gajim.org/gajim/gajim/issues.
    
    58
    +
    
    59
    +# SUPPORT
    
    60
    +
    
    61
    +You are welcome to join us at xmpp:gajim@conference.gajim.org?join.
    
    62
    +
    
    63
    +# COPYRIGHT
    
    64
    +
    
    65
    +gajim is free software; you can redistribute it and/or modify it under the
    
    66
    +terms of the GNU General Public License as published by the
    
    67
    +Free Software Foundation; version 3 only.
    
    68
    +
    
    69
    +gajim is distributed in the hope that it will be useful, but
    
    70
    +WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
    
    71
    +or FITNESS FOR A PARTICULAR PURPOSE.
    
    72
    +See the GNU General Public License for more details.

  • data/gajim.1
    1
    -.Dd January 21, 2018
    
    2
    -.Dt GAJIM 1 URM
    
    3
    -.Os UNIX
    
    4
    -.Sh NAME
    
    5
    -.Nm gajim
    
    6
    -.Nd A fully-featured XMPP chat client
    
    7
    -.Sh SYNOPSIS
    
    8
    -.Nm
    
    9
    -.Fl h
    
    10
    -.Nm
    
    11
    -.Op Fl q
    
    12
    -.Op Fl v
    
    13
    -.Op Fl w
    
    14
    -.Op Fl l Ar subsystem=level
    
    15
    -.Op Fl p Ar name
    
    16
    -.Op Fl s
    
    17
    -.Op Fl c Ar directory
    
    18
    -.Sh DESCRIPTION
    
    19
    -.Nm
    
    20
    -aims to be an easy to use and fully-featured XMPP client.
    
    21
    -Just chat with your friends or family, easily share pictures and thoughts or
    
    22
    -discuss the news with your groups.
    
    1
    +.\" Automatically generated by Pandoc 2.9.2.1
    
    2
    +.\"
    
    3
    +.TH "gajim" "1" "August 2022" "" "Manual"
    
    4
    +.hy
    
    5
    +.SH NAME
    
    6
    +.PP
    
    7
    +gajim - a fully-featured XMPP chat client
    
    8
    +.SH SYNOPSIS
    
    9
    +.PP
    
    10
    +gajim -h
    
    11
    +.PD 0
    
    12
    +.P
    
    13
    +.PD
    
    14
    +gajim --show
    
    15
    +.PD 0
    
    16
    +.P
    
    17
    +.PD
    
    18
    +gajim --start-chat
    
    19
    +.PD 0
    
    20
    +.P
    
    21
    +.PD
    
    22
    +gajim [-q] [-v] [-w] [-l subsystem=level] [-p name] [-s] [-c directory]
    
    23
    +[--gdebug] [--cprofile]
    
    24
    +.SH DESCRIPTION
    
    25
    +.PP
    
    26
    +\f[B]gajim\f[R] aims to be an easy to use and fully-featured XMPP
    
    27
    +client.
    
    28
    +Just chat with your friends or family, easily share pictures and
    
    29
    +thoughts or discuss the news with your groups.
    
    23 30
     Chat securely with End-to-End encryption via OMEMO or OpenPGP.
    
    24
    -.Nm
    
    25
    -integrates well with your other devices:
    
    26
    -simply continue conversations on your mobile device.
    
    27
    -.Pp
    
    31
    +gajim integrates well with your other devices: simply continue
    
    32
    +conversations on your mobile device.
    
    33
    +.PP
    
    28 34
     XMPP is the Extensible Messaging and Presence Protocol, a set of open
    
    29 35
     technologies for instant messaging, presence, multi-party chat, voice
    
    30
    -and video calls, collaboration, lightweight middleware, content
    
    31
    -syndication, and generalized routing of XML data. For more information
    
    32
    -on the XMPP protocol see <https://xmpp.org/about/>.
    
    33
    -.Sh OPTIONS
    
    34
    -.Bl -tag -width Ds
    
    35
    -.It Fl h Fl Fl help
    
    36
    +and video calls, collaboration, lightweight middle\[hy] ware, content
    
    37
    +syndication, and generalized routing of XML data.
    
    38
    +For more information on the XMPP protocol see https://xmpp.org/about/.
    
    39
    +.SH OPTIONS
    
    40
    +.TP
    
    41
    +\f[B]\f[CB]-h, --help\f[B]\f[R]
    
    36 42
     Show help options
    
    37
    -.It Fl q Fl Fl quiet
    
    43
    +.TP
    
    44
    +\f[B]\f[CB]-V, --version\f[B]\f[R]
    
    45
    +Show the application\[cq]s version
    
    46
    +.TP
    
    47
    +\f[B]\f[CB]-q, --quiet\f[B]\f[R]
    
    38 48
     Show only critical errors
    
    39
    -.It Fl s Fl Fl separate
    
    40
    -Separate profiles completely (even history db and plugins)
    
    41
    -.It Fl v Fl Fl verbose
    
    42
    -Print xml stanzas and other debug information
    
    43
    -.It Fl w Fl Fl warnings
    
    44
    -Show all GTK warnings with traceback
    
    45
    -.It Fl l Fl Fl loglevel Em subsystem=level Bq , Em subsystem=level Bq Em ...
    
    46
    -Configure logging system.
    
    47
    -Subsystem can be
    
    48
    -.Em gajim.c.preview ,
    
    49
    -.Em gajim.gui.preview ,
    
    50
    -.Em .nbxmpp.stream ,
    
    51
    -etc.
    
    52
    -.Pp
    
    53
    -Level can be
    
    54
    -.Em DEBUG ,
    
    55
    -.Em INFO ,
    
    56
    -.Em WARNING ,
    
    57
    -.Em ERROR
    
    58
    -or
    
    59
    -.Em CRITICAL .
    
    60
    -.It Fl p Fl Fl profile Em name
    
    61
    -Run
    
    62
    -.Nm
    
    63
    -using
    
    64
    -.Pa config.name
    
    65
    -in configuration directory
    
    66
    -.It Fl c Fl Fl config-path Em directory
    
    67
    -Where to look for configuration files
    
    68
    -.El
    
    69
    -.Sh FILES
    
    70
    -.Bl -tag -width Ds
    
    71
    -.It $XDG_CACHE_HOME/gajim/cache.db
    
    72
    -Cache database file of transports, caps, roster entry, and roster group.
    
    73
    -.It $XDG_CACHE_HOME/gajim/avatars/
    
    74
    -Cache directory of avatars.
    
    75
    -.It $XDG_CONFIG_HOME/gajim/
    
    76
    -The config-path used when
    
    77
    -.Op Fl c
    
    78
    -is not specified.
    
    79
    -.It $XDG_DATA_HOME/gajim/certs/
    
    80
    -Directory where certificates are stored.
    
    81
    -.It $XDG_DATA_HOME/gajim/logs.db
    
    82
    -The history database log file.
    
    83
    -For more information on database logs see
    
    84
    -<https://dev.gajim.org/gajim/gajim/wikis/development/LogsDatabase>.
    
    85
    -.El
    
    86
    -.Sh AUTHORS
    
    87
    -.An -nosplit
    
    88
    -.Nm
    
    89
    -is written and maintained by
    
    90
    -.An Yann Leboulanger 
    
    91
    -and
    
    92
    -.An Philipp Hörist ,
    
    93
    -with contributions and patches merged from many individuals around the world.
    
    94
    -See the About Dialog for a complete list.
    
    95
    -.Sh COPYRIGHT
    
    96
    -Copyright (C) 2003-2022 Gajim Team
    
    97
    -.Pp
    
    98
    -.Nm
    
    99
    -is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 3 only.
    
    100
    -.Pp
    
    101
    -.Nm
    
    102
    -is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
    
    103
    -.Pp
    
    104
    -You should have received a copy of the GNU General Public License along with
    
    105
    -.Nm .
    
    106
    -If not, see <https://www.gnu.org/licenses/>.
    
    107
    -.Sh FEEDBACK
    
    108
    -You can report bugs or feature requests in our bug tracker at
    
    109
    -.Em https://dev.gajim.org/gajim/gajim/issues
    
    110
    -or in the
    
    111
    -.Em gajim-devel
    
    112
    -mailing list; if you want to send us a patch, please do so in our bug tracker.
    
    113
    -You can also find us in our chat room.
    
    114
    -.Sh WWW
    
    115
    -https://www.gajim.org/
    
    116
    -.Sh XMPP
    
    117
    -You are welcome to join us at gajim@conference.gajim.org
    
    118
    -.Sh MAILING LIST
    
    119
    -Below are public mailing lists on lists.gajim.org
    
    120
    -.Bd -literal -offset indent
    
    121
    -https://lists.gajim.org/cgi-bin/listinfo/gajim-devel
    
    122
    -https://lists.gajim.org/cgi-bin/listinfo/translators
    
    123
    -.Ed
    
    124
    -.Pp
    
    125
    -More mailing lists at
    
    126
    -.Bd -literal -offset indent
    
    127
    -https://lists.gajim.org/cgi-bin/listinfo
    
    128
    -.Ed
    
    129
    -.Sh BUGS
    
    130
    -Please submit bugs at
    
    131
    -.Bd -literal -offset indent
    
    132
    -https://dev.gajim.org/gajim/gajim/issues
    
    133
    -https://dev.gajim.org/gajim/gajim-plugins/issues
    
    134
    -https://dev.gajim.org/gajim/python-nbxmpp/issues
    
    135
    -.Ed
    
    136
    -.Sh SEE ALSO
    
    137
    -.Xr gajim-remote 1
    49
    +.TP
    
    50
    +\f[B]\f[CB]-s, --separate\f[B]\f[R]
    
    51
    +Separate profile files completely (even history database and plugins)
    
    52
    +.TP
    
    53
    +\f[B]\f[CB]-v, --verbose\f[B]\f[R]
    
    54
    +Print XML stanzas and other debug information
    
    55
    +.TP
    
    56
    +\f[B]\f[CB]-p, --profile=NAME\f[B]\f[R]
    
    57
    +Use defined profile in configuration directory
    
    58
    +.TP
    
    59
    +\f[B]\f[CB]-c, --config-path=PATH\f[B]\f[R]
    
    60
    +Set configuration directory
    
    61
    +.TP
    
    62
    +\f[B]\f[CB]-l, --loglevel=SUBSYSTEM=LEVEL\f[B]\f[R]
    
    63
    +Configure logging.
    
    64
    +.RS
    
    65
    +.PP
    
    66
    +SUBSYSTEM e.g.\ gajim.c.m
    
    67
    +.PD 0
    
    68
    +.P
    
    69
    +.PD
    
    70
    +LEVEL (DEBUG, INFO, WARNING, ERROR, CRITICAL)
    
    71
    +.PP
    
    72
    +Example: gajim.c.m=DEBUG
    
    73
    +.RE
    
    74
    +.TP
    
    75
    +\f[B]\f[CB]-w, --warnings\f[B]\f[R]
    
    76
    +Show all warnings
    
    77
    +.TP
    
    78
    +\f[B]\f[CB]--gdebug\f[B]\f[R]
    
    79
    +Sets an environment variable so GLib debug messages are printed
    
    80
    +.TP
    
    81
    +\f[B]\f[CB]--cprofile\f[B]\f[R]
    
    82
    +Profile application with cprofile
    
    83
    +.TP
    
    84
    +\f[B]\f[CB]--start-chat\f[B]\f[R]
    
    85
    +Start a new chat
    
    86
    +.TP
    
    87
    +\f[B]\f[CB]--show\f[B]\f[R]
    
    88
    +Show Gajim
    
    89
    +.SH FILES
    
    90
    +.TP
    
    91
    +$XDG_CACHE_HOME/gajim/
    
    92
    +The directory for cached data.
    
    93
    +.TP
    
    94
    +$XDG_CONFIG_HOME/gajim/
    
    95
    +The directory where settings and configurations are stored.
    
    96
    +.TP
    
    97
    +$XDG_DATA_HOME/gajim/
    
    98
    +The directory where all persistent data, e.g.\ the message database, is
    
    99
    +stored.
    
    100
    +.SH BUGS
    
    101
    +.PP
    
    102
    +Please submit bugs at https://dev.gajim.org/gajim/gajim/issues.
    
    103
    +.SH SUPPORT
    
    104
    +.PP
    
    105
    +You are welcome to join us at xmpp:gajim\[at]conference.gajim.org?join.
    
    106
    +.SH COPYRIGHT
    
    107
    +.PP
    
    108
    +gajim is free software; you can redistribute it and/or modify it under
    
    109
    +the terms of the GNU General Public License as published by the Free
    
    110
    +Software Foundation; version 3 only.
    
    111
    +.PP
    
    112
    +gajim is distributed in the hope that it will be useful, but WITHOUT ANY
    
    113
    +WARRANTY; without even the implied warranty of MERCHANTABILITY or
    
    114
    +FITNESS FOR A PARTICULAR PURPOSE.
    
    115
    +See the GNU General Public License for more details.
    
    116
    +.SH AUTHORS
    
    117
    +Philipp H\[:o]rist, Daniel Br\[:o]tzmann, Yann Leboulanger.

  • data/gajim.1.md
    1
    +% gajim(1) | Manual
    
    2
    +% Philipp Hörist, Daniel Brötzmann, Yann Leboulanger
    
    3
    +% August 2022
    
    4
    +
    
    5
    +# NAME
    
    6
    +
    
    7
    +gajim - a fully-featured XMPP chat client
    
    8
    +
    
    9
    +# SYNOPSIS
    
    10
    +
    
    11
    +gajim -h\
    
    12
    +gajim \--show\
    
    13
    +gajim \--start-chat\
    
    14
    +gajim [-q] [-v] [-w] [-l subsystem=level] [-p name] [-s] [-c directory] [\--gdebug] [\--cprofile]
    
    15
    +
    
    16
    +# DESCRIPTION
    
    17
    +
    
    18
    +**gajim** aims to be an easy to use and fully-featured XMPP client. Just chat with your friends or
    
    19
    +family, easily share pictures and thoughts or discuss the news with your groups. Chat securely
    
    20
    +with End-to-End encryption via OMEMO or OpenPGP.  gajim integrates well with your other devices:
    
    21
    +simply continue conversations on your mobile device.
    
    22
    +
    
    23
    +XMPP is the Extensible Messaging and Presence Protocol, a set of open technologies for instant
    
    24
    +messaging, presence, multi-party chat, voice and video calls, collaboration, lightweight middle‐
    
    25
    +ware, content syndication, and generalized routing of XML data. For more information on the XMPP
    
    26
    +protocol see https://xmpp.org/about/.
    
    27
    +
    
    28
    +# OPTIONS
    
    29
    +
    
    30
    +`-h, --help`
    
    31
    +
    
    32
    +: Show help options
    
    33
    +
    
    34
    +`-V, --version`
    
    35
    +: Show the application's version
    
    36
    +
    
    37
    +`-q, --quiet`
    
    38
    +: Show only critical errors
    
    39
    +
    
    40
    +`-s, --separate`
    
    41
    +: Separate profile files completely (even history database and plugins)
    
    42
    +
    
    43
    +`-v, --verbose`
    
    44
    +: Print XML stanzas and other debug information
    
    45
    +
    
    46
    +`-p, --profile=NAME`
    
    47
    +: Use defined profile in configuration directory
    
    48
    +
    
    49
    +`-c, --config-path=PATH`
    
    50
    +: Set configuration directory
    
    51
    +
    
    52
    +`-l, --loglevel=SUBSYSTEM=LEVEL`
    
    53
    +: Configure logging.
    
    54
    +
    
    55
    +    SUBSYSTEM e.g. gajim.c.m\
    
    56
    +    LEVEL (DEBUG, INFO, WARNING, ERROR, CRITICAL)
    
    57
    +
    
    58
    +    Example: gajim.c.m=DEBUG
    
    59
    +
    
    60
    +`-w, --warnings`
    
    61
    +: Show all warnings
    
    62
    +
    
    63
    +`--gdebug`
    
    64
    +: Sets an environment variable so GLib debug messages are printed
    
    65
    +
    
    66
    +`--cprofile`
    
    67
    +: Profile application with cprofile
    
    68
    +
    
    69
    +`--start-chat`
    
    70
    +: Start a new chat
    
    71
    +
    
    72
    +`--show`
    
    73
    +: Show Gajim
    
    74
    +
    
    75
    +# FILES
    
    76
    +
    
    77
    +$XDG_CACHE_HOME/gajim/
    
    78
    +: The directory for cached data.
    
    79
    +
    
    80
    +$XDG_CONFIG_HOME/gajim/
    
    81
    +: The directory where settings and configurations are stored.
    
    82
    +
    
    83
    +$XDG_DATA_HOME/gajim/
    
    84
    +: The directory where all persistent data, e.g. the message database, is stored.
    
    85
    +
    
    86
    +# BUGS
    
    87
    +
    
    88
    +Please submit bugs at https://dev.gajim.org/gajim/gajim/issues.
    
    89
    +
    
    90
    +# SUPPORT
    
    91
    +
    
    92
    +You are welcome to join us at xmpp:gajim@conference.gajim.org?join.
    
    93
    +
    
    94
    +# COPYRIGHT
    
    95
    +
    
    96
    +gajim is free software; you can redistribute it and/or modify it under the
    
    97
    +terms of the GNU General Public License as published by the
    
    98
    +Free Software Foundation; version 3 only.
    
    99
    +
    
    100
    +gajim is distributed in the hope that it will be useful, but
    
    101
    +WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
    
    102
    +or FITNESS FOR A PARTICULAR PURPOSE.
    
    103
    +See the GNU General Public License for more details.