From 938f1a9a5ae4e9ee61a2779406cb319fb2299535 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Mon, 1 Nov 2004 17:52:02 +0000 Subject: [PATCH] Documentation updates. --- ChangeLog | 2 ++ ChangeLog.pre-2-10 | 2 ++ ChangeLog.pre-2-12 | 2 ++ ChangeLog.pre-2-6 | 2 ++ ChangeLog.pre-2-8 | 2 ++ docs/reference/ChangeLog | 4 ++++ docs/reference/glib/tmpl/option.sgml | 9 ++++++--- glib/goption.c | 5 +++-- 8 files changed, 23 insertions(+), 5 deletions(-) diff --git a/ChangeLog b/ChangeLog index 81b146460..b4eac7363 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,7 @@ 2004-11-01 Matthias Clasen + * glib/goption.c: Documentation updates. + Handle conflicts between options in different groups. (#156808) * glib/goption.c (g_option_context_parse): When a long option does not diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 81b146460..b4eac7363 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,5 +1,7 @@ 2004-11-01 Matthias Clasen + * glib/goption.c: Documentation updates. + Handle conflicts between options in different groups. (#156808) * glib/goption.c (g_option_context_parse): When a long option does not diff --git a/ChangeLog.pre-2-12 b/ChangeLog.pre-2-12 index 81b146460..b4eac7363 100644 --- a/ChangeLog.pre-2-12 +++ b/ChangeLog.pre-2-12 @@ -1,5 +1,7 @@ 2004-11-01 Matthias Clasen + * glib/goption.c: Documentation updates. + Handle conflicts between options in different groups. (#156808) * glib/goption.c (g_option_context_parse): When a long option does not diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index 81b146460..b4eac7363 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,5 +1,7 @@ 2004-11-01 Matthias Clasen + * glib/goption.c: Documentation updates. + Handle conflicts between options in different groups. (#156808) * glib/goption.c (g_option_context_parse): When a long option does not diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index 81b146460..b4eac7363 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,5 +1,7 @@ 2004-11-01 Matthias Clasen + * glib/goption.c: Documentation updates. + Handle conflicts between options in different groups. (#156808) * glib/goption.c (g_option_context_parse): When a long option does not diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 6b52be4e4..4543059ee 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,7 @@ +2004-11-01 Matthias Clasen + + * glib/tmpl/option.sgml: Updates + 2004-10-31 Matthias Clasen * glib/tmpl/windows.sgml: Document G_WIN32_IS_NT_BASED, diff --git a/docs/reference/glib/tmpl/option.sgml b/docs/reference/glib/tmpl/option.sgml index 2a92f7a7b..2f8956845 100644 --- a/docs/reference/glib/tmpl/option.sgml +++ b/docs/reference/glib/tmpl/option.sgml @@ -53,7 +53,7 @@ and write a text similar to the one shown in the following example to stdout. Usage: - testtreemodel [OPTION...] + testtreemodel [OPTION...] - test tree model performance Help Options: --help Show help options @@ -109,7 +109,7 @@ main (int argc, char *argv[]) { GError *error = NULL; - context = g_option_context_new ("[OPTION...]"); + context = g_option_context_new ("- test tree model performance"); g_option_context_add_main_entries (context, entries, GETTEXT_PACKAGE); g_option_context_add_group (context, gtk_get_option_group (TRUE)); g_option_context_parse (context, &argc, &argv, &error); @@ -291,7 +291,10 @@ g_option_context_add_main_entries() or g_option_group_add_entries(). @long_name: The long name of an option can be used to specify it in a commandline as --long_name. Every - option must have a long name. + option must have a long name. To resolve conflicts if multiple + option groups contain the same long name, it is also possible to + specify the option as + --groupname-long_name. @short_name: If an option has a short name, it can be specified -short_name in a commandline. @flags: Flags from #GOptionEntryFlags. diff --git a/glib/goption.c b/glib/goption.c index 99ad65c11..960a09738 100644 --- a/glib/goption.c +++ b/glib/goption.c @@ -116,8 +116,9 @@ g_option_error_quark (void) /** * g_option_context_new: - * @parameter_string: the parameter string to be used in - * output. + * @parameter_string: a string which is displayed in + * the first line of output, after + * programname [OPTION...] * * Creates a new option context. *