| version 1.11, 2002/10/07 10:54:40 |
version 1.12, 2003/03/01 02:26:20 |
|
|
| <!-- $Platon: usage.context-flags.sgml,v 1.9 2002/10/04 11:58:55 nepto Exp $ --> |
<!-- $Platon: libcfg+/doc/sgml/usage.context-flags.sgml,v 1.11 2002/10/07 10:54:40 rajo Exp $ --> |
| |
|
| <!-- MAN: |
<!-- MAN: |
| <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ |
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ |
| Line 95 List of setable context flags is describ |
|
| Line 95 List of setable context flags is describ |
|
| </para> |
</para> |
| <para> |
<para> |
| |
|
| <table id="usage.context-flags.table" frame=top> |
<variablelist> |
| <title id="usage.context-flags.table.title">Context flags</title> |
<title id="usage.context-flags.table.title">Context flags</title> |
| <tgroup cols=2> |
|
| <thead> |
<varlistentry><term><constant>CFG_IGNORE_MULTI</constant></term> |
| <row> |
<listitem> |
| <entry>Flag</entry> |
<para>Ignore multiple arguments for single option. First one will be used |
| <entry>Description</entry> |
to store option value, furthers are skipped.</para> |
| <entry>Default behaviour</entry> |
<para>By default, multiple arguments for option that has not allowed them, |
| </row> |
cause <constant>CFG_ERROR_MULTI</constant> error.</para> |
| </thead> |
</listitem></varlistentry> |
| <tbody> |
|
| <row> |
<varlistentry><term><constant>CFG_IGNORE_UNKNOWN</constant></term> |
| <entry><constant>CFG_IGNORE_MULTI</constant></entry> |
<listitem> |
| <entry><!-- MAN: Description: --> Ignore multiple arguments for single |
<para>Ignore all unknown options.</para> |
| option. First one will be used to store option value, furthers are skipped.</entry> |
<para>The default behaviour is, that any unknown option causes |
| <entry><!-- MAN: Default behaviour: --> Multiple arguments for option that |
<constant>CFG_ERROR_UNKNOWN</constant> error.</para> |
| has not allowed them, causes <constant>CFG_ERROR_MULTI</constant> |
</listitem></varlistentry> |
| error.</entry> |
|
| </row> |
<varlistentry><term><constant>CFG_SKIP_FIRST</constant></term> |
| <row> |
<listitem> |
| <entry><constant>CFG_IGNORE_UNKNOWN</constant></entry> |
<para>Processing of the first argument on command line is skipped. This flag |
| <entry><!-- MAN: Description: --> Ignore all unknown options.</entry> |
affects only command line related context.</para> |
| <entry><!-- MAN: Default behaviour: --> Any unknown option causes <constant>CFG_ERROR_UNKNOWN</constant> |
<para>By default is also the first argument on command line |
| error.</entry> |
processed.</para> |
| </row> |
</listitem></varlistentry> |
| <row> |
|
| <entry><constant>CFG_SKIP_FIRST</constant></entry> |
<varlistentry><term><constant>CFG_ADVANCED_LEFTOVERS</constant></term> |
| <entry><!-- MAN: Description: --> Processing of the first argument on command line is skipped. |
<listitem> |
| Flag affects only command line related context.</entry> |
<para>Advanced leftover arguments. It means that leftover arguments do not |
| <entry><!-- MAN: Default behaviour: --> Process also the first argument on command line.</entry> |
need to be be posixly correct.</para> |
| </row> |
<para>The default behaviour is, that leftover arguments have to be posixly |
| <row> |
correct. Thus all options must go before any leftover argument. Once the |
| <entry><constant>CFG_ADVANCED_LEFTOVERS</constant></entry> |
first leftover argument is found, all further arguments are considered as |
| <entry><!-- MAN: Description: --> Advanced leftover arguments. It means that |
leftovers.</para> |
| leftover arguments must not be posixly correct.</entry> |
</listitem></varlistentry> |
| <entry><!-- MAN: Default behaviour: --> Leftover arguments must be posixly |
|
| correct. That means all options must go before any leftover argument. Once |
<varlistentry><term><constant>CFG_STRICT_LEFTOVERS</constant></term> |
| the first leftover argument is found, all further arguments are considered |
<listitem> |
| as leftover.</entry> |
<para>Strict leftover arguments initialization in file.</para> |
| |
<para>By default are leftover arguments in file initialized in normal way |
| </row> |
(as they are).</para> |
| <row> |
</listitem></varlistentry> |
| <entry><constant>CFG_STRICT_LEFTOVERS</constant></entry> |
|
| <entry><!-- MAN: Description: --> Strict leftover arguments initialization in file.</entry> |
<varlistentry><term><constant>CFG_FILE_LINE_POS_USAGE</constant></term> |
| <entry><!-- MAN: Default behaviour: --> Leftover arguments initialization in file are normal (as-is).</entry> |
<listitem> |
| </row> |
<para>Positions and size in configuration file are specified in lines |
| <row> |
starting from 0.</para> |
| <entry><constant>CFG_FILE_LINE_POS_USAGE</constant></entry> |
<para>The default behaviour is, that positions and size in configuration |
| <entry><!-- MAN: Description: --> Positions and size in configuration file are specified in lines |
file are specified in bytes starting from 0.</para> |
| starting from 0.</entry> |
</listitem></varlistentry> |
| <entry><!-- MAN: Default behaviour: --> Positions and size in configuration file are specified in bytes |
|
| starting from 0.</entry> |
</variablelist> |
| </row> |
|
| </tbody> |
|
| </tgroup> |
|
| </table> |
|
| </para> |
</para> |
| |
|
| <para> |
<para> |