gajim.1 3.8 KB
Newer Older
Philipp Hörist's avatar
Philipp Hörist committed
1
.Dd September 02, 2017
2
3
4
5
6
7
8
9
10
11
12
.Dt GAJIM 1 URM
.Os UNIX
.Sh NAME
.Nm gajim
.Nd a Jabber/XMPP client
.Sh SYNOPSIS
.Nm
.Fl h
.Nm
.Op Fl q
.Op Fl v
Philipp Hörist's avatar
Philipp Hörist committed
13
.Op Fl w
14
15
.Op Fl l Ar subsystem=level
.Op Fl p Ar name
Philipp Hörist's avatar
Philipp Hörist committed
16
.Op Fl s
17
18
19
20
21
22
23
24
25
26
27
28
29
30
.Op Fl c Ar directory
.Sh DESCRIPTION
.Nm
is a Jabber/XMPP client written in Python and GTK+.
.Nm
works nicely with GNOME, yet it does not require it to run.
.Nm
is designed for novice and advanced users as one, as well for XMPP
server admins.
.Pp
XMPP is the Extensible Messaging and Presence Protocol, a set of open
technologies for instant messaging, presence, multi-party chat, voice
and video calls, collaboration, lightweight middleware, content
syndication, and generalized routing of XML data. For more information
31
on the XMPP protocol see <https://xmpp.org/about-xmpp/>.
32
33
34
35
36
37
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl h Fl Fl help
Show help options
.It Fl q Fl Fl quiet
Show only critical errors
Philipp Hörist's avatar
Philipp Hörist committed
38
39
.It Fl s Fl Fl separate
Separate profiles completely (even history db and plugins)
40
41
.It Fl v Fl Fl verbose
Print xml stanzas and other debug information
Philipp Hörist's avatar
Philipp Hörist committed
42
43
.It Fl w Fl Fl warnings
Show all GTK warnings with traceback
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
.It Fl l Fl Fl loglevel Em subsystem=level Bq , Em subsystem=level Bq Em ...
Configure logging system.
Subsystem can be
.Em gajim.interface ,
.Em gajim.c.connection ,
.Em .nbxmpp.client_nb ,
etc.
Level can be
.Em DEBUG ,
.Em INFO ,
.Em WARNING ,
.Em ERROR
or
.Em CRITICAL .
.It Fl p Fl Fl profile Em name
Run
.Nm
using
.Pa config.name
in configuration directory
.It Fl c Fl Fl config-path Em directory
Where to look for configuration files
Yann Leboulanger's avatar
Yann Leboulanger committed
66
.El
67
68
.Sh FILES
.Bl -tag -width Ds
69
.It $XDG_CACHE_HOME/gajim/cache.db
70
Cache database file of transports, caps, roster entry, and roster group.
71
.It $XDG_CACHE_HOME/gajim/avatars/
72
Cache directory of avatars.
73
.It $XDG_CACHE_HOME/gajim/vcards/
74
Cache directory of vCards (virtual cards).
75
.It $XDG_CONFIG_HOME/gajim/
76
77
78
The config-path used when
.Op Fl c
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.
Philipp Hörist's avatar
Philipp Hörist committed
83
84
For more information on database logs see
<https://dev.gajim.org/gajim/gajim/wikis/development/LogsDatabase>.
85
86
87
88
89
.El
.Sh AUTHORS
.An -nosplit
.Nm
is written and maintained by
Philipp Hörist's avatar
Philipp Hörist committed
90
.An Yann Leboulanger 
91
and
Philipp Hörist's avatar
Philipp Hörist committed
92
.An Philipp Hörist ,
93
with contributions and patches merged from many individuals around the world.
Philipp Hörist's avatar
Philipp Hörist committed
94
See the About Dialog for a complete list.
95
.Sh COPYRIGHT
Philipp Hörist's avatar
Philipp Hörist committed
96
Copyright (C) 2003-2017 Gajim Team
97
98
99
100
101
102
103
104
105
.Pp
.Nm
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.
.Pp
.Nm
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.
.Pp
You should have received a copy of the GNU General Public License along with
.Nm .
106
If not, see <https://www.gnu.org/licenses/>.
107
108
.Sh FEEDBACK
You can report bugs or feature requests in our bug tracker at
Philipp Hörist's avatar
Philipp Hörist committed
109
.Em https://dev.gajim.org/gajim/gajim/issues
110
111
112
113
114
or in the
.Em gajim-devel
mailing list; if you want to send us a patch, please do so in our bug tracker.
You can also find us in our chat room.
.Sh WWW
115
https://www.gajim.org/
116
117
118
119
120
.Sh XMPP
You are welcome to join us at gajim@conference.gajim.org
.Sh MAILING LIST
Below are public mailing lists on lists.gajim.org
.Bd -literal -offset indent
121
122
https://lists.gajim.org/cgi-bin/listinfo/gajim-devel
https://lists.gajim.org/cgi-bin/listinfo/translators
123
124
125
126
.Ed
.Pp
More mailing lists at
.Bd -literal -offset indent
127
https://lists.gajim.org/cgi-bin/listinfo
128
129
130
131
.Ed
.Sh BUGS
Please submit bugs at
.Bd -literal -offset indent
Philipp Hörist's avatar
Philipp Hörist committed
132
133
134
https://dev.gajim.org/gajim/gajim/issues
https://dev.gajim.org/gajim/gajim-plugins
https://dev.gajim.org/gajim/python-nbxmpp
135
136
137
138
.Ed
.Sh SEE ALSO
.Xr gajim-remote 1
.Xr gajim-history-manager 1