From d0ecafdcc254c26fc6cf355cbdc9176fff9418e2 Mon Sep 17 00:00:00 2001
From: Nikos Kouremenos <kourem@gmail.com>
Date: Sat, 3 Sep 2005 13:48:25 +0000
Subject: [PATCH] add comments for some advanced settings, fix some stuff in
 glade too for that

---
 src/common/config.py     | 28 ++++++++--------
 src/common/connection.py |  4 +--
 src/gtkgui.glade         | 71 ++++++++++++++++++++++------------------
 3 files changed, 55 insertions(+), 48 deletions(-)

diff --git a/src/common/config.py b/src/common/config.py
index 2a9e33c6a2..f74d658946 100644
--- a/src/common/config.py
+++ b/src/common/config.py
@@ -48,7 +48,7 @@ class Config:
 		'ignore_unknown_contacts': [ opt_bool, False ],
 		'showoffline': [ opt_bool, False ],
 		'autoaway': [ opt_bool, True ],
-		'autoawaytime': [ opt_int, 5, 'Time after which you are displayed as being away.' ],
+		'autoawaytime': [ opt_int, 5, _('Time after which you are displayed as being away.') ],
 		'autoaway_message': [ opt_str, _('Away as a result of being idle') ],
 		'autoxa': [ opt_bool, True ],
 		'autoxatime': [ opt_int, 15 ],
@@ -115,27 +115,25 @@ class Config:
 		'change_roster_title': [ opt_bool, True ],
 		'restore_lines': [opt_int, 4],
 		'restore_timeout': [opt_int, 60],
-		'send_on_ctrl_enter': [opt_bool, False], # send on ctrl+enter
+		'send_on_ctrl_enter': [opt_bool, False, _('Send message on Ctrl+Enter.')],
 		'show_roster_on_startup': [opt_bool, True],
-		'key_up_lines': [opt_int, 25],  # how many lines to store for key up
-		'version': [ opt_str, '0.9' ], # what version first created the config
+		'key_up_lines': [opt_int, 25, _('How many lines to store for key up.')],
+		'version': [ opt_str, '0.9' ], # what version created the config
 		'always_compact_view': [opt_bool, False], # initial compact view state
 		'search_engine': [opt_str, 'http://www.google.com/search?&q=%s&sourceid=gajim'],
-		'dictionary_url': [opt_str, 'WIKTIONARY'], # by default use wiktionary
+		'dictionary_url': [opt_str, 'WIKTIONARY', _("Either custom url with %s in it where %s is the word/phrase or 'WIKTIONARY' which means use wiktionary.")],
 		'always_english_wikipedia': [opt_bool, False],
 		'always_english_wiktionary': [opt_bool, False],
-		'use_dbus': [opt_bool, True], # allow control via dbus service
+		'use_dbus': [opt_bool, True, _('Allow controlling Gajim via D-Bus service.')],
 		'chat_state_notifications': [opt_str, 'all'], # 'all', 'composing_only', 'disabled'
 		'autodetect_browser_mailer': [opt_bool, True],
 		'print_ichat_every_foo_minutes': [opt_int, 5],
-		'confirm_close_muc': [opt_bool, True], # confirm closing MUC window
+		'confirm_close_muc': [opt_bool, True, _('Ask before closing a group chat tab/window.')],
 		'notify_on_file_complete': [opt_bool, True], # notif. on file complete
 		'file_transfers_port': [opt_int, 28011],  # port, used for file transfers
-		# override the host we send for FT in case of address translation/port forward
-		'ft_override_host_to_send': [opt_str, ''], 
+		'ft_override_host_to_send': [opt_str, '', _('Overrides the host we send for File Transfer in case of address translation/port forwarding.')], 
 		'conversation_font': [opt_str, ''],
-		# IEC standard says KiB = 1024 bytes KB = 1000 bytes
-		'use_kib_mib': [opt_bool, False],
+		'use_kib_mib': [opt_bool, False, _('IEC standard says KiB = 1024 bytes, KB = 1000 bytes.')],
 		'notify_on_all_muc_messages': [opt_bool, False],
 		'trayicon_notification_on_new_messages': [opt_bool, True],
 		'last_save_dir': [opt_str, ''],
@@ -143,10 +141,10 @@ class Config:
 		'last_emoticons_dir': [opt_str, ''],
 		'last_sounds_dir': [opt_str, ''],
 		#FIXME: add combobox in prefs for this in .9
-		'tabs_position': [opt_str, 'top'], # top, bottom, left, right
-		'tabs_always_visible': [opt_bool, False], # show tab if one tab?
-		'tabs_border': [opt_bool, False], # border if one tab?
-		'tabs_close_button': [opt_bool, True], # close button in tab?
+		'tabs_position': [opt_str, 'top', _('Where to show tabs. Values are:')+" 'top', 'bottom', 'left', 'right'."],
+		'tabs_always_visible': [opt_bool, False, _('Show tab when only one conversation?')],
+		'tabs_border': [opt_bool, False, _('Show tab border if one conversation?')],
+		'tabs_close_button': [opt_bool, True, _('Show close button in tab?')],
 		'avatar_width': [opt_int, 52],
 		'avatar_height': [opt_int, 52],
 	}
diff --git a/src/common/connection.py b/src/common/connection.py
index 539964b171..7f0886aec1 100644
--- a/src/common/connection.py
+++ b/src/common/connection.py
@@ -4,7 +4,7 @@
 ##	- Yann Le Boulanger <asterix@lagaule.org>
 ##	- Vincent Hanquez <tab@snarc.org>
 ##	- Nikos Kouremenos <nkour@jabber.org>
-##  - Dimitur Kirov <dkirov@gmail.com>
+##	- Dimitur Kirov <dkirov@gmail.com>
 ##
 ##	Copyright (C) 2003-2005 Gajim Team
 ##
@@ -166,7 +166,7 @@ class Connection:
 
 	def discoverItems(self, jid, node = None):
 		'''According to JEP-0030: jid is mandatory, 
-											name, node, action is optional.'''
+		name, node, action is optional.'''
 		self._discover(common.xmpp.NS_DISCO_ITEMS, jid, node)
 	
 	def discoverInfo(self, jid, node = None):
diff --git a/src/gtkgui.glade b/src/gtkgui.glade
index ac64ebacc6..6923720fb4 100644
--- a/src/gtkgui.glade
+++ b/src/gtkgui.glade
@@ -12784,8 +12784,8 @@ Status message</property>
   <property name="type">GTK_WINDOW_TOPLEVEL</property>
   <property name="window_position">GTK_WIN_POS_NONE</property>
   <property name="modal">False</property>
-  <property name="default_width">640</property>
-  <property name="default_height">500</property>
+  <property name="default_width">650</property>
+  <property name="default_height">540</property>
   <property name="resizable">True</property>
   <property name="destroy_with_parent">False</property>
   <property name="decorated">True</property>
@@ -12903,45 +12903,56 @@ Status message</property>
       </child>
 
       <child>
-	<widget class="GtkHBox" id="hbox2992">
-	  <property name="border_width">6</property>
+	<widget class="GtkFrame" id="frame36">
+	  <property name="border_width">3</property>
 	  <property name="visible">True</property>
-	  <property name="homogeneous">False</property>
-	  <property name="spacing">12</property>
+	  <property name="label_xalign">0</property>
+	  <property name="label_yalign">0.5</property>
+	  <property name="shadow_type">GTK_SHADOW_NONE</property>
 
 	  <child>
-	    <widget class="GtkLabel" id="label357">
+	    <widget class="GtkAlignment" id="alignment90">
+	      <property name="border_width">6</property>
 	      <property name="visible">True</property>
-	      <property name="label" translatable="yes">Description:</property>
-	      <property name="use_underline">False</property>
-	      <property name="use_markup">False</property>
-	      <property name="justify">GTK_JUSTIFY_LEFT</property>
-	      <property name="wrap">False</property>
-	      <property name="selectable">False</property>
 	      <property name="xalign">0.5</property>
 	      <property name="yalign">0.5</property>
-	      <property name="xpad">0</property>
-	      <property name="ypad">0</property>
-	      <property name="ellipsize">PANGO_ELLIPSIZE_NONE</property>
-	      <property name="width_chars">-1</property>
-	      <property name="single_line_mode">False</property>
-	      <property name="angle">0</property>
+	      <property name="xscale">1</property>
+	      <property name="yscale">1</property>
+	      <property name="top_padding">0</property>
+	      <property name="bottom_padding">0</property>
+	      <property name="left_padding">12</property>
+	      <property name="right_padding">0</property>
+
+	      <child>
+		<widget class="GtkLabel" id="advanced_desc_label">
+		  <property name="visible">True</property>
+		  <property name="label" translatable="yes">(None)</property>
+		  <property name="use_underline">False</property>
+		  <property name="use_markup">False</property>
+		  <property name="justify">GTK_JUSTIFY_LEFT</property>
+		  <property name="wrap">True</property>
+		  <property name="selectable">False</property>
+		  <property name="xalign">0</property>
+		  <property name="yalign">0.5</property>
+		  <property name="xpad">0</property>
+		  <property name="ypad">0</property>
+		  <property name="ellipsize">PANGO_ELLIPSIZE_NONE</property>
+		  <property name="width_chars">-1</property>
+		  <property name="single_line_mode">False</property>
+		  <property name="angle">0</property>
+		</widget>
+	      </child>
 	    </widget>
-	    <packing>
-	      <property name="padding">0</property>
-	      <property name="expand">False</property>
-	      <property name="fill">False</property>
-	    </packing>
 	  </child>
 
 	  <child>
-	    <widget class="GtkLabel" id="advanced_desc_label">
+	    <widget class="GtkLabel" id="label357">
 	      <property name="visible">True</property>
-	      <property name="label" translatable="yes">(None)</property>
+	      <property name="label" translatable="yes">&lt;b&gt;Description&lt;/b&gt;</property>
 	      <property name="use_underline">False</property>
-	      <property name="use_markup">False</property>
+	      <property name="use_markup">True</property>
 	      <property name="justify">GTK_JUSTIFY_LEFT</property>
-	      <property name="wrap">True</property>
+	      <property name="wrap">False</property>
 	      <property name="selectable">False</property>
 	      <property name="xalign">0.5</property>
 	      <property name="yalign">0.5</property>
@@ -12953,9 +12964,7 @@ Status message</property>
 	      <property name="angle">0</property>
 	    </widget>
 	    <packing>
-	      <property name="padding">0</property>
-	      <property name="expand">False</property>
-	      <property name="fill">False</property>
+	      <property name="type">label_item</property>
 	    </packing>
 	  </child>
 	</widget>
-- 
GitLab