[glib] Add a not about arguments beginning with dashes
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glib] Add a not about arguments beginning with dashes
- Date: Thu, 5 Aug 2010 06:25:29 +0000 (UTC)
commit e2657d8dce32e10869ec2b18edc7dbf489dd2941
Author: Matthias Clasen <mclasen redhat com>
Date: Thu Aug 5 02:01:58 2010 -0400
Add a not about arguments beginning with dashes
glib/goption.c | 28 +++++++++++++++-------------
1 files changed, 15 insertions(+), 13 deletions(-)
---
diff --git a/glib/goption.c b/glib/goption.c
index ff762e8..167a7df 100644
--- a/glib/goption.c
+++ b/glib/goption.c
@@ -28,7 +28,7 @@
* following example:
*
* <literal>testtreemodel -r 1 --max-size 20 --rand --display=:1.0 -vb -- file1 file2</literal>
- *
+ *
* The example demonstrates a number of features of the GOption commandline parser
* <itemizedlist><listitem><para>
* Options can be single letters, prefixed by a single dash. Multiple
@@ -36,25 +36,27 @@
* </para></listitem><listitem><para>
* Long options are prefixed by two consecutive dashes.
* </para></listitem><listitem><para>
- * Options can have an extra argument, which can be a number, a string or a
- * filename. For long options, the extra argument can be appended with an
- * equals sign after the option name.
+ * Options can have an extra argument, which can be a number, a string or a
+ * filename. For long options, the extra argument can be appended with an
+ * equals sign after the option name, which is useful if the extra argument
+ * starts with a dash, which would otherwise cause it to be interpreted
+ * as another option.
* </para></listitem><listitem><para>
* Non-option arguments are returned to the application as rest arguments.
* </para></listitem><listitem><para>
- * An argument consisting solely of two dashes turns off further parsing,
- * any remaining arguments (even those starting with a dash) are returned
+ * An argument consisting solely of two dashes turns off further parsing,
+ * any remaining arguments (even those starting with a dash) are returned
* to the application as rest arguments.
* </para></listitem></itemizedlist>
- *
- * Another important feature of GOption is that it can automatically generate
- * nicely formatted help output. Unless it is explicitly turned off with
- * g_option_context_set_help_enabled(), GOption will recognize the
+ *
+ * Another important feature of GOption is that it can automatically generate
+ * nicely formatted help output. Unless it is explicitly turned off with
+ * g_option_context_set_help_enabled(), GOption will recognize the
* <option>--help</option>, <option>-?</option>, <option>--help-all</option>
- * and <option>--help-</option><replaceable>groupname</replaceable> options
- * (where <replaceable>groupname</replaceable> is the name of a #GOptionGroup)
+ * and <option>--help-</option><replaceable>groupname</replaceable> options
+ * (where <replaceable>groupname</replaceable> is the name of a #GOptionGroup)
* and write a text similar to the one shown in the following example to stdout.
- *
+ *
* <informalexample><screen>
* Usage:
* testtreemodel [OPTION...] - test tree model performance
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]