diff --git a/data/gajim-history-manager.1 b/data/gajim-history-manager.1 index 5500b9f86..48677bc05 100644 --- a/data/gajim-history-manager.1 +++ b/data/gajim-history-manager.1 @@ -1,21 +1,84 @@ -.\" 20050901 -.TH "Gajim-history-manager" "1" "September 01, 2005" "Gajim dev team" "" -.SH "NAME" -Gajim-history-manager \- Tool to manage gajim logs -.SH "SYNOPSIS" -.B gajim-history-manager [\-c config-path] [\-h] -.SH "DESCRIPTION" -.B Gajim-history-manager -is a tool to manage (do some cleanup) log file of Gajim jabber client. -.PP -.SH "OPTIONS" -.TP -\fB\-c\fR, \fB\-\-config-path\fR path -Path where logs.db is located. ~/.gajim by default. -.TP -\fB\-h\fR, \fB\-\-help\fR -Print this help. -.SH "FEEDBACK" -You can report bugs or feature requests in http://trac.gajim.org or in the mailing list: http://lists.gajim.org/cgi\-bin/listinfo/gajim\-devel. You can also find us in our room gajim@conference.gajim.org -.SH "AUTHORS" -Written by Yann Le Boulanger , Nikos Kouremenos and Dimitur Kirov . +.Dd August 11, 2013 +.Dt GAJIM-HISTORY-MANAGER 1 URM +.Os UNIX +.Sh NAME +.Nm gajim-history-manager +.Nd a tool to manage +.Xr gajim 1 +logs +.Sh SYNOPSIS +.Nm +.Fl h +.Nm +.Op Fl c Ar directory +.Sh DESCRIPTION +.Nm +is a tool to manage +.Po do some cleanup Pc log file of +.Xr gajim 1 . +Use this program to delete or export logs. +For more information on database logs see . +.Sh OPTIONS +.Bl -tag -width Ds +.It Fl h Fl Fl help +Show help options +.It Fl c Fl Fl config-path Em directory +Where to look for logs file +.Sh FILES +.Bl -tag -width Ds +.It ~/.local/share/gajim/logs.db +The history database log file used when +.Op Fl c +is not specified. +.Sh AUTHORS +.An -nosplit +.Nm +is written and maintained by +.An Yann Leboulanger , +and +.An Denis Fomin , +with contributions and patches merged from many individuals around the world. +See files +.Pa AUTHORS +and +.Pa THANKS , +for a complete list. +.Sh COPYRIGHT +Copyright (C) 2003-2013 Gajim Team +.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 . +If not, see . +.Sh FEEDBACK +You can report bugs or feature requests in our bug tracker at +.Em trac.gajim.org +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 +http://www.gajim.org/ +.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 +http://lists.gajim.org/cgi-bin/listinfo/gajim-devel +http://lists.gajim.org/cgi-bin/listinfo/translators +.Ed +.Pp +More mailing lists at +.Bd -literal -offset indent +http://lists.gajim.org/cgi-bin/listinfo +.Ed +.Sh BUGS +Please submit bugs at https://trac.gajim.org/ +.Sh SEE ALSO +.Xr gajim 1 +.Xr gajim-remote 1 diff --git a/data/gajim-remote.1 b/data/gajim-remote.1 index 9bbbc7214..ceeb845cb 100644 --- a/data/gajim-remote.1 +++ b/data/gajim-remote.1 @@ -1,14 +1,138 @@ -.\" 20050818 -.TH "Gajim-remote" "1" "August 18, 2005" "Gajim dev team" "" -.SH "NAME" -Gajim-remote \- tool to communicate with a running instance of Gajim -.SH "SYNOPSIS" -.B gajim-remote [help] [toggle_roster_appearance] [show_next_unread] [list_contacts] [list_accounts] [change_status] [open_chat] [send_message] [send_file] [contact_info] [account_info] [send_file] [prefs_list] [prefs_put] [prefs_del] [prefs_store] [remove_contact] [add_contact] [get_status] [get_status_message] [get_unread_msgs_number] [start_chat] -.SH "DESCRIPTION" -.B Gajim-remote -is a script to control Gajim by D-Bus -.PP -.SH "FEEDBACK" -You can report bugs or feature requests in http://trac.gajim.org or in the mailing list: https://lists.gajim.org/cgi\-bin/listinfo/gajim\-devel. You can also find us in our room gajim@conference.jabber.no -.SH "AUTHORS" -Written by Yann Le Boulanger , Nikos Kouremenos and Dimitur Kirov . +.Dd August 11, 2013 +.Dt GAJIM-REMOTE 1 URM +.Os UNIX +.Sh NAME +.Nm gajim-remote +.Nd a remote control utility for +.Xr gajim 1 +.Sh SYNOPSIS +.Nm +.Ar command +.Sh DESCRIPTION +.Nm +is a script to control and communicate with a running instance of +.Xr gajim 1 +by D-Bus. +.Sh OPTIONS +.Bl -tag -width Ds +.It Available commands +.Ss account_info Aq account +Gets detailed info on a account +.Ss add_contact Ao jid Ac Bq account +Adds contact to roster +.Ss change_avatar Ao picture Ac Bq account +Change the avatar +.Ss change_status Bo status Bc Bo message Bc Bq account +Changes the status of account or accounts +.Ss check_gajim_running +Check if Gajim is running +.Ss contact_info Aq jid +Gets detailed info on a contact +.Ss get_status Bq account +Returns current status (the global one unless account is specified) +.Ss get_status_message Bq account +Returns current status message (the global one unless account is specified) +.Ss get_unread_msgs_number +Returns number of unread messages +.Ss handle_uri Ao uri Ac Bo account Bc Bq message +Handle a xmpp:/ uri +.Ss help Bq command +Shows a help on specific command +.Ss join_room Ao room Ac Bo nick Bc Bo password Bc Bq account +Join a MUC room +.Ss list_accounts +Prints a list of registered accounts +.Ss list_contacts Bq account +Prints a list of all contacts in the roster. Each contact appears on a separate line +.Ss open_chat Ao jid Ac Bo account Bc Bq message +Shows the chat dialog so that you can send messages to a contact +.Ss prefs_del Aq key +Deletes a preference item +.Ss prefs_list +Lists all preferences and their values +.Ss prefs_put Aq key=value +Sets value of 'key' to 'value'. +.Ss prefs_store +Writes the current state of Gajim preferences to the .config file +.Ss remove_contact Ao jid Ac Bq account +Removes contact from roster +.Ss send_chat_message Ao jid Ac Ao message Ac Bo pgp key Bc Bq account +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 ''. +.Ss send_file Ao file Ac Ao jid Ac Bq account +Sends file to a contact +.Ss send_groupchat_message Ao room_jid Ac Ao message Ac Bq account +Sends new message to a groupchat you've joined. +.Ss send_single_message Ao jid subject Ac Ao message Ac Bo pgp key Bc Bq account +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 ''. +.Ss send_xml Ao xml Ac Bq account +Sends custom XML +.Ss set_priority Ao priority Ac Bq account +Changes the priority of account or accounts +.Ss show_next_pending_event +Pops up a window with the next pending event +.Ss start_chat Aq account +Opens 'Start Chat' dialog +.Ss toggle_ipython +Shows or hides the ipython window +.Ss toggle_roster_appearance +Shows or hides the roster window +.Sh EXAMPLES +Open a URI of group chat gajim +.Pp +.Dl $ gajim-remote handle_uri xmpp:gajim@conferenc.gajim.org?join +.Pp +Send custom XML +.Pp +.Dl $ gajim-remote send_xml $(cat Pa filename.xml ) Qq your@jabber.id +.Sh AUTHORS +.An -nosplit +.Nm +is written and maintained by +.An Yann Leboulanger , +and +.An Denis Fomin , +with contributions and patches merged from many individuals around the world. +See files +.Pa AUTHORS +and +.Pa THANKS , +for a complete list. +.Sh COPYRIGHT +Copyright (C) 2003-2013 Gajim Team +.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 . +If not, see . +.Sh FEEDBACK +You can report bugs or feature requests in our bug tracker at +.Em trac.gajim.org +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 +http://www.gajim.org/ +.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 +http://lists.gajim.org/cgi-bin/listinfo/gajim-devel +http://lists.gajim.org/cgi-bin/listinfo/translators +.Ed +.Pp +More mailing lists at +.Bd -literal -offset indent +http://lists.gajim.org/cgi-bin/listinfo +.Ed +.Sh BUGS +Please submit bugs at https://trac.gajim.org/ +.Sh SEE ALSO +.Xr gajim 1 +.Xr gajim-history-manager 1 diff --git a/data/gajim.1 b/data/gajim.1 index b6351cd4f..c3a3dabb6 100644 --- a/data/gajim.1 +++ b/data/gajim.1 @@ -1,25 +1,134 @@ -.\" 20050901 -.TH "Gajim" "1" "September 01, 2005" "Gajim dev team" "" -.SH "NAME" -Gajim \- a jabber client -.SH "SYNOPSIS" -.B gajim [\-v] [\-p] [\-h] -.SH "DESCRIPTION" -.B Gajim -is a jabber client written in PyGTK and released under the GNU GPL. For more information on jabber, see -http://www.jabber.org and on Gajim see http://www.gajim.org -.PP -.SH "OPTIONS" -.TP -\fB\-p\fR, \fB\-\-profile\fR name -Run Gajim using ~/.gajim/config.name -.TP -\fB\-v\fR, \fB\-\-verbose\fR -Print xml stanzas and other debug information. -.TP -\fB\-h\fR, \fB\-\-help\fR -Print this help. -.SH "FEEDBACK" -You can report bugs or feature requests in http://trac.gajim.org or in the mailing list: https://lists.gajim.org/cgi\-bin/listinfo/gajim\-devel. You can also find us in our room gajim@conference.gajim.org -.SH "AUTHORS" -Written by Yann Le Boulanger , Nikos Kouremenos and Dimitur Kirov . +.Dd August 11, 2013 +.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 +.Op Fl l Ar subsystem=level +.Op Fl p Ar name +.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 +on the XMPP protocol see . +.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 +.It Fl v Fl Fl verbose +Print xml stanzas and other debug information +.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 +.Sh FILES +.Bl -tag -width Ds +.It ~/.cache/gajim/cache.db +Cache database file of transports, caps, roster entry, and roster group. +.It ~/.cache/gajim/avatars/ +Cache directory of avatars. +.It ~/.cache/gajim/vcards/ +Cache directory of vCards (virtual cards). +.It ~/.config/gajim/ +The config-path used when +.Op Fl c +is not specified. +.It ~/.local/share/gajim/certs/ +Directory where certificates are stored. +.It ~/.local/share/gajim/logs.db +The history database log file. +For more information on database logs see . +.El +.Sh AUTHORS +.An -nosplit +.Nm +is written and maintained by +.An Yann Leboulanger , +and +.An Denis Fomin , +with contributions and patches merged from many individuals around the world. +See files +.Pa AUTHORS +and +.Pa THANKS , +for a complete list. +.Sh COPYRIGHT +Copyright (C) 2003-2013 Gajim Team +.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 . +If not, see . +.Sh FEEDBACK +You can report bugs or feature requests in our bug tracker at +.Em trac.gajim.org +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 +http://www.gajim.org/ +.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 +http://lists.gajim.org/cgi-bin/listinfo/gajim-devel +http://lists.gajim.org/cgi-bin/listinfo/translators +.Ed +.Pp +More mailing lists at +.Bd -literal -offset indent +http://lists.gajim.org/cgi-bin/listinfo +.Ed +.Sh BUGS +Please submit bugs at +.Bd -literal -offset indent +https://trac.gajim.org/ +http://trac-plugins.gajim.org/ +http://python-nbxmpp.gajim.org/ +.Ed +.Sh SEE ALSO +.Xr gajim-remote 1 +.Xr gajim-history-manager 1