.\" args - manipulate and output command arguments.
.\" Copyright (C) 2009-2014 David Sugar <dyfet@gnutelephony.org>
.\"
.\" This manual page is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 3 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU Lesser General Public License
.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
.\"
.\" This manual page is written especially for Debian GNU/Linux.
.\"
.TH args "1" "January 2010" "GNU uCommon" "GNU Telephony"
.SH NAME
args \- manipulate and output command arguments.
.SH SYNOPSIS
.B args
.RI [ options ]
.I args...
.br
.SH DESCRIPTION
This command is used to manipulate and echo command line arguments to
standard out.  This can include adding quotes around each argument passed
or a separator, or to output each argument on a separate line.  The program
source also offers a basic example of how to use shell argument parsing and
localization in ucommon.
.SH OPTIONS
.TP
.BI \-\-delim= char
Set a deliminator character, such as ',', to use between each argument when
outputing arguments.
.TP
.B \-\-directory
If argument is a directory, list directory contents as arguments.
.TP
.B \-\-follow
If argument is a directory and a symlink, follow symlinks recursively.
.TP
.B \-\-lines
Output each argument on a separate line.
.TP
.BI \-\-quote= char|pair
Set a quote or special leading and trailing pair of characters to surround
each argument with when output.  A typical use might be --quote=() to surround
arguments in parenthesis.
.TP
.B \-\-recursive
If argument is a directory, recursively scan directory and any subdirectory
contents as arguments.
.TP
.B \-\-reverse
Reverse order of arguments.
.TP
.B \-\-help
Outputs help screen for the user.
.SH AUTHOR
.B args
was written by David Sugar <dyfet@gnutelephony.org>.
.SH "REPORTING BUGS"
Report bugs to bug-commoncpp@gnu.org or bugs@gnutelephony.org.
.SH COPYRIGHT
Copyright \(co 2009-2014 David Sugar, Tycho Softworks.
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.