.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.16.
.TH ARG_PARSER "1" "February 2022" "arg_parser 1.17" "User Commands"
.SH NAME
arg_parser \- test program for Arg_parser
.SH SYNOPSIS
.B arg_parser
[\fI\,options\/\fR]
.SH DESCRIPTION
Arg_parser \- POSIX/GNU command line argument parser. (C++ version)
.PP
Arg_parser is an argument parser that follows POSIX and GNU conventions for
command line arguments. There exist C++ and C versions of Arg_parser. The
C++ version is implemented as a C++ class, while the C version is
implemented as a single struct plus associated functions. Both are simpler,
easier to use, and safer than 'getopt_long'.
.PP
For maximum stability, Arg_parser is self\-contained. It extracts all the
information it needs from its arguments to avoid refering to them later.
This avoids index\-out\-of\-bounds errors.
.PP
Arg_parser does not modify its arguments, nor uses any global variables. So
you may create more than one parser in your program if you need or want to.
.PP
The C++ version of Arg_parser can also parse options from configuration
files.
.PP
To use Arg_parser in your own programs simply copy the files 'arg_parser.h'
and 'arg_parser.cc' in your source tree. See the file 'main.cc' for an
example of use.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
display this help and exit
.TP
\fB\-V\fR, \fB\-\-version\fR
output version information and exit
.TP
\fB\-a\fR, \fB\-\-append\fR
example of option with no argument
.TP
\fB\-b\fR, \fB\-\-block=\fR<arg>
example of option with required argument
.TP
\fB\-c\fR, \fB\-\-casual[=\fR<arg>]
example of option with optional argument
.TP
\fB\-o\fR <arg>
example of short only option
.TP
\fB\-\-orphan\fR
example of long only option
.TP
\fB\-q\fR, \fB\-\-quiet\fR
quiet operation
.TP
\fB\-u\fR, \fB\-\-uncaught\fR
example of intentional bug
.TP
\fB\-v\fR, \fB\-\-verbose\fR
verbose operation
.SH "REPORTING BUGS"
Report bugs to arg\-parser\-bug@nongnu.org
.br
Arg_parser home page: http://www.nongnu.org/arg\-parser/arg_parser.html
.SH COPYRIGHT
Copyright \(co 2022 Antonio Diaz Diaz.
License 2\-clause BSD.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B arg_parser
is maintained as a Texinfo manual.  If the
.B info
and
.B arg_parser
programs are properly installed at your site, the command
.IP
.B info arg_parser
.PP
should give you access to the complete manual.