changeset e84a5b5a5dcd in /home/hg/repos/gajim
branches: gtk3
details:http://hg.gajim.org/gajim?cmd=changeset;node=e84a5b5a5dcd
description: [Darlan] updated man pages. Fixes #7425
diffstat:
data/gajim-history-manager.1 | 105 ++++++++++++++++++++++-----
data/gajim-remote.1 | 152 +++++++++++++++++++++++++++++++++++++---
data/gajim.1 | 159 ++++++++++++++++++++++++++++++++++++------
3 files changed, 356 insertions(+), 60 deletions(-)
diffs (truncated from 428 to 300 lines):
diff -r a3d71616e615 -r e84a5b5a5dcd data/gajim-history-manager.1
--- a/data/gajim-history-manager.1 Sat Aug 24 15:17:45 2013 +0400
+++ b/data/gajim-history-manager.1 Sat Aug 24 17:58:22 2013 +0200
@@ -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(a)conference.gajim.org
-.SH "AUTHORS"
-Written by Yann Le Boulanger <asterix(a)lagaule.org>, Nikos Kouremenos <kourem(a)gmail.com> and Dimitur Kirov <dkirov(a)gmail.com>.
+.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 <https://trac.gajim.org/wiki/LogsDatabase>.
+.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 <http://www.gnu.org/licenses/>.
+.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(a)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 -r a3d71616e615 -r e84a5b5a5dcd data/gajim-remote.1
--- a/data/gajim-remote.1 Sat Aug 24 15:17:45 2013 +0400
+++ b/data/gajim-remote.1 Sat Aug 24 17:58:22 2013 +0200
@@ -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(a)conference.jabber.no
-.SH "AUTHORS"
-Written by Yann Le Boulanger <asterix(a)lagaule.org>, Nikos Kouremenos <kourem(a)gmail.com> and Dimitur Kirov <dkirov(a)gmail.com>.
+.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(a)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 <http://www.gnu.org/licenses/>.
+.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(a)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 -r a3d71616e615 -r e84a5b5a5dcd data/gajim.1
--- a/data/gajim.1 Sat Aug 24 15:17:45 2013 +0400
+++ b/data/gajim.1 Sat Aug 24 17:58:22 2013 +0200
@@ -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(a)conference.gajim.org
-.SH "AUTHORS"
-Written by Yann Le Boulanger <asterix(a)lagaule.org>, Nikos Kouremenos <kourem(a)gmail.com> and Dimitur Kirov <dkirov(a)gmail.com>.
+.Dd August 11, 2013
+.Dt GAJIM 1 URM
+.Os UNIX
+.Sh NAME
+.Nm gajim
+.Nd a Jabber/XMPP client
changeset b5cca6321af8 in /home/hg/repos/gajim
branches: gtk3
details:http://hg.gajim.org/gajim?cmd=changeset;node=b5cca6321af8
description: [axcel] update AcronymsExpanderPlugin
diffstat:
plugins/acronyms_expander/acronyms | 69 ++++++++++++++++++++++++++
plugins/acronyms_expander/acronyms_expander.py | 16 ++++-
2 files changed, 82 insertions(+), 3 deletions(-)
diffs (106 lines):
diff -r 193e9b398e11 -r b5cca6321af8 plugins/acronyms_expander/acronyms
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/plugins/acronyms_expander/acronyms Tue Aug 20 14:08:54 2013 +0400
@@ -0,0 +1,69 @@
+{"afaik": "as far as I know",
+"afaict": "as far as I can tell",
+"afk": "away from keyboard",
+"atm": "at the moment",
+"bbiab": "be back in a bit",
+"bbiaf": "be back in a few (minutes)",
+"bbl": "be back later",
+"bbs": "be back soon",
+"b/c": "because",
+"bf": "boyfriend",
+"bfo": "blinding flash of the obvious",
+"brb": "be right back",
+"bsod": "blue screen of death",
+"btw": "by the way",
+"ciao": "Italian for goodbye",
+"ctrn": "can't talk right now",
+"cul8r": "see you later",
+"cya": "see ya",
+"dhtb": "don't have the bandwidth",
+"f2f": "face to face",
+"fubar": "fucked up beyond all recognition",
+"fwiw": "for what it's worth",
+"fyi": "for your information",
+"gmta": "great minds think alike",
+"iam": "in a meeting",
+"ianal": "I am not a lawyer",
+"ihmb": "I hate my boss",
+"iirc": "if I recall correctly",
+"imho": "in my humble opinion",
+"imo": "in my opinion",
+"iow": "in other words",
+"irl": "in real life",
+"<g>": "grin",
+"*g*": "grin",
+"gf": "girlfriend",
+"gmta": "great minds think alike",
+"g2g": "got to go",
+"jid": "jabber identifier",
+"j/k": "just kidding",
+"ok": "okay",
+"lol": "laugh out loud",
+"l8r": "later",
+"msg": "message",
+"n/m": "never mind",
+"n/p": "no problem",
+"oAo": "over and out!",
+"omg": "oh my god",
+"oob": "out of band",
+"otoh": "on the other hand",
+"oww": "oops, wrong window!",
+"otp": "on the phone",
+"pita": "pain in the ass",
+"pov": "point of view",
+"pw": "password",
+"rotfl": "rolling on the floor laughing",
+"rsn": "real soon now",
+"rtfm": "read the friendly manual",
+"slap": "sounds like a plan",
+"thx": "thanks",
+"tia": "thanks in advance",
+"tla": "three-letter arconym",
+"ttfn": "ta ta for now",
+"ttyl": "talk to you later",
+"wb": "welcome back",
+"wfm": "works for me",
+"wtf": "what the fuck?!",
+"wtg": "way to go!",
+"xfer": "transfer",
+"ymmv": "your mileage may vary",}
diff -r 193e9b398e11 -r b5cca6321af8 plugins/acronyms_expander/acronyms_expander.py
--- a/plugins/acronyms_expander/acronyms_expander.py Mon Aug 19 11:28:50 2013 +0400
+++ b/plugins/acronyms_expander/acronyms_expander.py Tue Aug 20 14:08:54 2013 +0400
@@ -47,16 +47,26 @@
self.config_default_values = {
'INVOKER': (' ', ''),
- 'ACRONYMS': ({'RTFM': 'Read The Friendly Manual',
- '/slap': '/me slaps',
+ 'ACRONYMS': ({'/slap': '/me slaps',
'PS-': 'plug-in system',
'G-': 'Gajim',
'GNT-': 'http://trac.gajim.org/newticket',
'GW-': 'http://trac.gajim.org/',
'GTS-': 'http://trac.gajim.org/report',
},
- ''),
+ ''),
}
+ if 'ACRONYMS' not in self.config:
+ myAcronyms = self.get_own_acronyms_list()
+ self.config['ACRONYMS'].update(myAcronyms)
+
+ @log_calls('AcronymsExpanderPlugin')
+ def get_own_acronyms_list(self):
+ data_file = self.local_file_path('acronyms')
+ data = open(data_file, 'r')
+ acronyms = eval(data.read())
+ data.close()
+ return acronyms
@log_calls('AcronymsExpanderPlugin')
def textbuffer_live_acronym_expander(self, tb):