Creates a new option context.
parameter_string can serve multiple purposes. It can be used
to add descriptions for “rest” arguments, which are not parsed by
GOptionContext, typically something like “FILES” or
“FILE1 FILE2…”. If you are using
collecting “rest” arguments, GLib handles this automatically by
arg_description of the corresponding
the usage summary.
Another usage is to give a short summary of the program functionality, like ” - frob the strings”, which will be displayed in the same line as the usage. For a longer description of the program functionality that should be displayed as a paragraph below the usage line, use g_option_context_set_summary().
Note that the
parameter_string is translated using the
function set with g_option_context_set_translate_func(), so
it should normally be passed untranslated.
A string which is displayed in the first line of
--helpoutput, after the usage summary
The argument can be
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string.
A newly created
GOptionContext, which must be
g_option_context_free() after use.
|The data is owned by the called function.|