.\"----------------------------------------------------------------------------
.\"-- This text was extracted using the following command:
.\"--   xdoc -man -n -p '[ \t]*' -I DESCRIPTION -f sparseargs ../xparse.c
.\"----------------------------------------------------------------------------
.PP
Given a single string and an argdesc array, \fIsparseargs\fP
will parse arguments from a string in much the same manner as \fIparseargs\fP.
.I Sparseargs
will split the given string up into a vector of whitespace
separated tokens and then attempt to parse the resultant vector as
if it were given as \fIargv[]\fP on the command-line.
NO special treatment is given to characters such as single-quotes,
double-quotes, or anything else. \fISparseargs\fP will always assume that
any whitespace characters are intended as argument separators.