When -a is defined as Unit, accepted -a=1.
When -a is defined as Tuple, accepted -a=1 b c as -a b=1 c=1.
When -a is defined as Rest, looped infinitely on -a=1.
Arg.align now optionally uses the tab character '\t' to separate the "unaligned"
and "aligned" parts of the documentation string. If tab is not present, then
space is used as a fallback. Allows to have spaces in the unaligned part, which
is useful for Tuple options.
The parse_expand function does the same as parse and parse_dynamic
but allows Expand. However it does not update current to avoid
the problem that the array is modified.
This function is used for the ocamlopt, ocamlc, ocamlcp,
ocamloptp and ocamldep.
The read_aux function trims the cr character for the new-line
based method and the write functions are simplified without an
additional sep function.
The argument names are changed to match the default naming format
and the documentation is updated to match the implementation
behavior.
Also two new tests for reading and writing empty command lines as
well as a command lines containing empty arguments are added.
The function read_arg, read_arg0, write_arg and write_arg0 read
and write command line arguments to a file which are either
separated by a NUL character or by new lines.
Add the `Arg.Expand` constructor to `Arg.spec`. This new specification allows the user to expand the `argv` array being parsed, for instance to implement responsefile support.
A new function `Arg.parse_and_expand_argv_dynamic` is added. It takes both `current` and `argv` as references and as mandatory arguments. This function allows the user to access the `argv` array after expansion.
To avoid confusion regarding the `?current` argument of the various parsing functions as well as with `Arg.current`, `Arg.Expand` is only allowed with the new function.
Tests for this PR are added to the testsuite.
Allow flags to be followed directly by their argument, separated by an '='
sign. This is consistent with what GNU getopt_long and many other
command line parsing libraries allow.
Fix for the following issue:
http://caml.inria.fr/mantis/view.php?id=5197
The no_arg function in this patch is a no-op. It will do something
useful in the followups.
The get_arg function simple checks the next position on the command
line exists and returns that argument or raises a Arg.Missing.
This patch should introduce no functional change, it is simply code
refactoring.
In particular, this should not change the treatment of Arg.current
(see: http://caml.inria.fr/mantis/view.php?id=5197#c11147)
to warn when the argument is matches against a constant pattern.
This attributes is applied on predefined exception constructors
which take an purely informational (with no stability guarantee)
message.
git-svn-id: http://caml.inria.fr/svn/ocaml/trunk@16502 f963ae5c-01c2-4b8c-9fe0-0dff7051ff02
a boolean as argument, and tuples with spec Tuple of spec list for
functions that takes more than one argument in turn on the command
line. For instance Arg.(Tuple [Arg.Int f; Arg.Bool b; Arg.Int g])
specifies an option that will take 3 elements on the command line and
will call f, b, and g in turn with converted values of the
corresponding types.
git-svn-id: http://caml.inria.fr/svn/ocaml/trunk@5505 f963ae5c-01c2-4b8c-9fe0-0dff7051ff02
Gabriel Scherer
Valentin Gatien-Baron
David Allsopp
alainfrisch
Nicolas Ojeda Bar
Florian Angeletti
Bernhard Schommer
Bernhard Schommer
Damien Doligez
Richard W.M. Jones
Damien Doligez
Jonathan Protzenko
Xavier Leroy
Pierre Weis