Add descriptions for the commandline arguments. The actual descriptions

Sun Sep  5 17:14:16 2004  Matthias Clasen  <maclas@gmx.de>

	* gtk/gtkmain.c:
	* gdk/gdk.c:
	* gdk/x11/gdkmain-x11.c:
	* gdk/win32/gdkmain-win32.c: Add descriptions for the
	commandline arguments. The actual descriptions are mostly
	taken from libbonoboui, so translators should be able to
	copy existing translations from there.

8 files changed, 87 insertions, 18 deletions

diff --git a/ChangeLog b/ChangeLog
index 2b453deb2..a1e89f1be 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+Sun Sep  5 17:14:16 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkmain.c: 
+	* gdk/gdk.c: 
+	* gdk/x11/gdkmain-x11.c: 
+	* gdk/win32/gdkmain-win32.c: Add descriptions for the 
+	commandline arguments. The actual descriptions are mostly 
+	taken from libbonoboui, so translators should be able to 
+	copy existing translations from there.
+
 2004-09-05  Anders Carlsson  <andersca@gnome.org>
 
 	* gdk/gdk.symbols:
diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index 2b453deb2..a1e89f1be 100644
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,13 @@
+Sun Sep  5 17:14:16 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkmain.c: 
+	* gdk/gdk.c: 
+	* gdk/x11/gdkmain-x11.c: 
+	* gdk/win32/gdkmain-win32.c: Add descriptions for the 
+	commandline arguments. The actual descriptions are mostly 
+	taken from libbonoboui, so translators should be able to 
+	copy existing translations from there.
+
 2004-09-05  Anders Carlsson  <andersca@gnome.org>
 
 	* gdk/gdk.symbols:
diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index 2b453deb2..a1e89f1be 100644
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,13 @@
+Sun Sep  5 17:14:16 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkmain.c: 
+	* gdk/gdk.c: 
+	* gdk/x11/gdkmain-x11.c: 
+	* gdk/win32/gdkmain-win32.c: Add descriptions for the 
+	commandline arguments. The actual descriptions are mostly 
+	taken from libbonoboui, so translators should be able to 
+	copy existing translations from there.
+
 2004-09-05  Anders Carlsson  <andersca@gnome.org>
 
 	* gdk/gdk.symbols:
diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index 2b453deb2..a1e89f1be 100644
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,13 @@
+Sun Sep  5 17:14:16 2004  Matthias Clasen  <maclas@gmx.de>
+
+	* gtk/gtkmain.c: 
+	* gdk/gdk.c: 
+	* gdk/x11/gdkmain-x11.c: 
+	* gdk/win32/gdkmain-win32.c: Add descriptions for the 
+	commandline arguments. The actual descriptions are mostly 
+	taken from libbonoboui, so translators should be able to 
+	copy existing translations from there.
+
 2004-09-05  Anders Carlsson  <andersca@gnome.org>
 
 	* gdk/gdk.symbols:
diff --git a/gdk/gdk.c b/gdk/gdk.c
index 47c8029ff..c1c30b2f0 100644
--- a/gdk/gdk.c
+++ b/gdk/gdk.c
@@ -32,6 +32,7 @@
 #include "gdkalias.h"
 #include "gdk.h"
 #include "gdkinternals.h"
+#include "gdkintl.h"
 
 #ifndef HAVE_XCONVERTCASE
 #include "gdkkeysyms.h"
@@ -112,14 +113,26 @@ gdk_arg_name_cb (const char *key, const char *value, gpointer user_data, GError
 }
 
 static GOptionEntry gdk_args[] = {
-  { "class",        0, 0,                     G_OPTION_ARG_CALLBACK, gdk_arg_class_cb,    NULL, NULL },
-  { "name",         0, 0,                     G_OPTION_ARG_CALLBACK, gdk_arg_name_cb,     NULL, NULL },
-  { "display",      0, G_OPTION_FLAG_IN_MAIN, G_OPTION_ARG_STRING,   &_gdk_display_name,  NULL, NULL },
-  { "screen",       0, 0,                     G_OPTION_ARG_INT,      &_gdk_screen_number, NULL, NULL },
+  { "class",        0, 0,                     G_OPTION_ARG_CALLBACK, gdk_arg_class_cb,
+    /* Description of --class=CLASS in --help output */        N_("Program class as used by the window manager"),
+    /* Placeholder in --class=CLASS in --help output */        N_("CLASS") },
+  { "name",         0, 0,                     G_OPTION_ARG_CALLBACK, gdk_arg_name_cb,
+    /* Description of --name=NAME in --help output */          N_("Program name as used by the window manager"),
+    /* Placeholder in --name=NAME in --help output */          N_("NAME") },
+  { "display",      0, G_OPTION_FLAG_IN_MAIN, G_OPTION_ARG_STRING,   &_gdk_display_name,
+    /* Description of --display=DISPLAY in --help output */    N_("X display to use"),
+    /* Placeholder in --display=DISPLAY in --help output */    N_("DISPLAY") },
+  { "screen",       0, 0, G_OPTION_ARG_INT,      &_gdk_screen_number,
+    /* Description of --screen=SCREEN in --help output */      N_("X screen to use"),
+    /* Placeholder in --screen=SCREEN in --help output */      N_("SCREEN") },
 #ifdef G_ENABLE_DEBUG
-  { "gdk-debug",    0, 0, 		      G_OPTION_ARG_CALLBACK, gdk_arg_debug_cb,    NULL, NULL },
-  { "gdk-no-debug", 0, 0, 		      G_OPTION_ARG_CALLBACK, gdk_arg_no_debug_cb, NULL, NULL },
-#endif /* G_ENABLE_DEBUG */
+  { "gdk-debug",    0, 0, G_OPTION_ARG_CALLBACK, gdk_arg_debug_cb,  
+    /* Description of --gdk-debug=FLAGS in --help output */    N_("Gdk debugging flags to set"),
+    /* Placeholder in --gdk-debug=FLAGS in --help output */    N_("FLAGS") },
+  { "gdk-no-debug", 0, 0, G_OPTION_ARG_CALLBACK, gdk_arg_no_debug_cb, 
+    /* Description of --gdk-no-debug=FLAGS in --help output */ N_("Gdk debugging flags to unset"), 
+    /* Placeholder in --gdk-no-debug=FLAGS in --help output */ N_("FLAGS") },
+#endif 
   { NULL }
 };
 
diff --git a/gdk/win32/gdkmain-win32.c b/gdk/win32/gdkmain-win32.c
index 7f54dda02..ebe0c1353 100644
--- a/gdk/win32/gdkmain-win32.c
+++ b/gdk/win32/gdkmain-win32.c
@@ -37,6 +37,7 @@
 #include "gdkregion-generic.h"
 #include "gdkkeysyms.h"
 #include "gdkinternals.h"
+#include "gdkintl.h"
 #include "gdkprivate-win32.h"
 #include "gdkinput-win32.h"
 
@@ -53,13 +54,18 @@
 static gboolean gdk_synchronize = FALSE;
 
 GOptionEntry _gdk_windowing_args[] = {
-  { "sync", 0, 0, G_OPTION_ARG_NONE, &_gdk_synchronize, NULL, NULL },
-  { "no-wintab", 0, 0, G_OPTION_ARG_NONE, &_gdk_input_ignore_wintab, NULL, NULL },
-  { "ignore-wintab", 0, 0, G_OPTION_ARG_NONE, &_gdk_input_ignore_wintab, NULL, NULL },
+  { "sync", 0, 0, G_OPTION_ARG_NONE, &_gdk_synchronize, 
+    /* Description of --sync in --help output */              N_("Don't batch GDI requests"), NULL },
+  { "no-wintab", 0, 0, G_OPTION_ARG_NONE, &_gdk_input_ignore_wintab, 
+    /* Description of --no-wintab in --help output */         N_("Don't use the Wintab API for tablet support [default]"), NULL },
+  { "ignore-wintab", 0, 0, G_OPTION_ARG_NONE, &_gdk_input_ignore_wintab, 
+    /* Description of --ignore-wintab in --help output */     N_("Same as --no-wintab"), NULL },
 #if 0
   { "use-wintab", 0, 0, G_OPTION_ARG_NONE, &_gdk_input_ignore_wintab, NULL, NULL },
 #endif
-  { "max-colors", 0, 0, G_OPTION_ARG_INT, &_gdk_max_colors, NULL, NULL },
+  { "max-colors", 0, 0, G_OPTION_ARG_INT, &_gdk_max_colors, 
+    /* Description of --max-colors=COLORS in --help output */ N_("Size of the palette in 8 bit mode"), 
+    /* Placeholder in --max-colors=COLORS in --help output */ N_("COLORS") },
   { NULL }
 };
 
diff --git a/gdk/x11/gdkmain-x11.c b/gdk/x11/gdkmain-x11.c
index c6e7c8bf9..ae9a22200 100644
--- a/gdk/x11/gdkmain-x11.c
+++ b/gdk/x11/gdkmain-x11.c
@@ -47,6 +47,7 @@
 #include "gdkx.h"
 #include "gdkdisplay-x11.h"
 #include "gdkinternals.h"
+#include "gdkintl.h"
 #include "gdkregion-generic.h"
 #include "gdkinputprivate.h"
 
@@ -87,7 +88,8 @@ static GSList *gdk_error_traps = NULL;               /* List of error traps */
 static GSList *gdk_error_trap_free_list = NULL;      /* Free list */
 
 GOptionEntry _gdk_windowing_args[] = {
-  { "sync", 0, 0, G_OPTION_ARG_NONE, &_gdk_synchronize, NULL, NULL },
+  { "sync", 0, 0, G_OPTION_ARG_NONE, &_gdk_synchronize, 
+    /* Description of --sync in --help output */ N_("Make X calls synchronous"), NULL },
   { NULL }
 };
 
diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c
index d699c9672..9f2baa483 100644
--- a/gtk/gtkmain.c
+++ b/gtk/gtkmain.c
@@ -399,12 +399,19 @@ gtk_arg_warnings_cb (const char *key, const char *value, gpointer user_data)
 }
 
 static GOptionEntry gtk_args[] = {
-  { "gtk-module",       0, 0, G_OPTION_ARG_CALLBACK, gtk_arg_module_cb,   NULL, NULL },
-  { "g-fatal-warnings", 0, 0, G_OPTION_ARG_CALLBACK, gtk_arg_warnings_cb, NULL, NULL },
+  { "gtk-module",       0, 0, G_OPTION_ARG_CALLBACK, gtk_arg_module_cb,   
+    /* Description of --gtk-module=MODULES in --help output */ N_("Load additional GTK+ modules"), 
+    /* Placeholder in --gtk-module=MODULES in --help output */ N_("MODULES") },
+  { "g-fatal-warnings", 0, 0, G_OPTION_ARG_CALLBACK, gtk_arg_warnings_cb, 
+    /* Description of --g-fatal-warnings in --help output */   N_("Make all warnings fatal"), NULL },
 #ifdef G_ENABLE_DEBUG
-  { "gtk-debug",        0, 0, G_OPTION_ARG_CALLBACK, gtk_arg_debug_cb,    NULL, NULL },
-  { "gtk-no-debug",     0, 0, G_OPTION_ARG_CALLBACK, gtk_arg_no_debug_cb, NULL, NULL },
-#endif /* G_ENABLE_DEBUG */
+  { "gtk-debug",        0, 0, G_OPTION_ARG_CALLBACK, gtk_arg_debug_cb,    
+    /* Description of --gtk-debug=FLAGS in --help output */    N_("GTK+ debugging flags to set"), 
+    /* Placeholder in --gtk-debug=FLAGS in --help output */    N_("FLAGS") },
+  { "gtk-no-debug",     0, 0, G_OPTION_ARG_CALLBACK, gtk_arg_no_debug_cb, 
+    /* Description of --gtk-no-debug=FLAGS in --help output */ N_("GTK+ debugging flags to unset"), 
+    /* Placeholder in --gtk-no-debug=FLAGS in --help output */ N_("FLAGS") },
+#endif 
   { NULL }
 };
 
@@ -543,6 +550,7 @@ gtk_get_option_group (gboolean open_default_display)
 
   gdk_add_option_entries_libgtk_only (group);
   g_option_group_add_entries (group, gtk_args);
+  g_option_group_set_translation_domain (group, GETTEXT_PACKAGE);
   
   return group;
 }
@@ -613,7 +621,7 @@ gtk_parse_args (int    *argc,
   g_option_context_set_ignore_unknown_options (option_context, TRUE);
   g_option_context_set_help_enabled (option_context, FALSE);
   
-  g_option_context_add_main_entries (option_context, gtk_args, NULL);
+  g_option_context_add_main_entries (option_context, gtk_args, GETTEXT_PACKAGE);
 
   g_option_context_parse (option_context, argc, argv, NULL);
   g_option_context_free (option_context);