luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-02-23 18:52:09 +01:00
Code Issues Packages Projects Releases Wiki Activity

Documentation improvements

Browse Source
This commit is contained in:
Matthias Clasen 2006-03-26 20:12:56 +00:00
parent 21b05cd677
commit 39119f7dd5
3 changed files with 28 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
ChangeLog
View File

@ -1,3 +1,8 @@
2006-03-26 Matthias Clasen <mclasen@redhat.com>
* glib/goption.c (g_option_context_new): Improve the description
of parameter_string in the docs. (#336085, Claudio Saavedra)
2006-03-24 Martyn Russell <martyn@imendio.com>
* glib/gthreadpool.c: Updated the documentation to explain that
@ -13,7 +18,6 @@
* configure.in: Added "ka" (Georgian) to ALL_LINGUAS
=======
2006-03-20 Matthias Clasen <mclasen@redhat.com>
* glib/gmem.c (profiler_log): use standard_calloc to allocate
@ -34,7 +38,6 @@
* MAINTAINERS: Add this, at the request of the GNOME sysadmin team.
>>>>>>> 1.2267
2006-03-15 Matthias Clasen <mclasen@redhat.com>
* glib/goption.c (g_option_context_parse): Only set the prgname

7
ChangeLog.pre-2-12
View File

@ -1,3 +1,8 @@
2006-03-26 Matthias Clasen <mclasen@redhat.com>
* glib/goption.c (g_option_context_new): Improve the description
of parameter_string in the docs. (#336085, Claudio Saavedra)
2006-03-24 Martyn Russell <martyn@imendio.com>
* glib/gthreadpool.c: Updated the documentation to explain that
@ -13,7 +18,6 @@
* configure.in: Added "ka" (Georgian) to ALL_LINGUAS
=======
2006-03-20 Matthias Clasen <mclasen@redhat.com>
* glib/gmem.c (profiler_log): use standard_calloc to allocate
@ -34,7 +38,6 @@
* MAINTAINERS: Add this, at the request of the GNOME sysadmin team.
>>>>>>> 1.2267
2006-03-15 Matthias Clasen <mclasen@redhat.com>
* glib/goption.c (g_option_context_parse): Only set the prgname

20
glib/goption.c
View File

@ -128,11 +128,27 @@ g_option_error_quark (void)
/**
* g_option_context_new:
* @parameter_string: a string which is displayed in
* the first line of <option>--help</option> output, after
* <literal><replaceable>programname</replaceable> [OPTION...]</literal>
* the first line of <option>--help</option> output, after the
* usage summary
* <literal><replaceable>programname</replaceable> [OPTION...]</literal>.
*
* Creates a new option context.
*
* The @parameter_text can serve multiple purposes. It can be used
* to add descriptions for "rest" arguments, which are not parsed by
* the #GOptionContext, typically something like "FILES" or
* "FILE1 FILE2...". (If you are using #G_OPTION_REMAINING for
* collecting "rest" arguments, GLib handles this automatically by
* using the @arg_description of the corresponding #GOptionEntry in
* the usage summary.)
*
* Another common usage is to give a summary of the program
* functionality. This can be a short summary on the same line,
* like " - frob the strings", or a longer description in a paragraph
* below the usage summary. In this case, @parameter_string should start
* with two newlines, to separate the description from the usage summary:
* "\n\nA program to frob strings, which will..."
*
* Returns: a newly created #GOptionContext, which must be
* freed with g_option_context_free() after use.
*