Release calc version 2.11.1t1

help/argv

@@ -0,0 +1,80 @@
+NAME
+    argv - count or value of a calc command line supplied argument
+
+SYNOPSIS
+    argv([n])
+
+TYPES
+    n		nonnegative integer
+
+    return	any
+
+DESCRIPTION
+    Without args, this builtin returns the number of calc command line
+    strings available.
+
+    If the numeric arg is supplied, then the corresponding command line
+    string is return, if it exists.  Otherwise a nul() value is returned.
+
+    In keeping with the argc/argv convention of C, argv(0) will refer
+    to the 1st argv string, and argv(argv()-1) will refer to the last.
+    This differs from the way the param() builtin works.
+
+    By default, calc will evaluate all of its command line arguments.
+    However, if calc is invoked with -s, all non-dashed options will
+    be left as unevaluated strings.  Thus:
+
+	calc -i 2+2
+
+    will cause calc to print 4 and enter interactive mode.  In this case
+    argv() will return 0.
+
+    On the other hand:
+
+	calc -i -s 2+2
+
+    will cause calc to interactive mode.  The argv() builtin will return 1
+    and argv(0) will return the string "2+2".
+
+EXAMPLE
+    $ calc -s a bb ccc
+    > argc = argv();
+    > for (i = 0; i < argc; i++) print "argv[": i : '] = "': argv(i) : '"';
+    argv[0] = "a"
+    argv[1] = "bb"
+    argv[2] = "ccc"
+
+LIMITS
+    0 <= n < 2^31
+
+LINK LIBRARY
+    none
+
+SEE ALSO
+    param, usage
+
+## Copyright (C) 1999  Landon Curt Noll
+##
+## Calc is open software; you can redistribute it and/or modify it under
+## the terms of the version 2.1 of the GNU Lesser General Public License
+## as published by the Free Software Foundation.
+##
+## Calc 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 Lesser General
+## Public License for more details.
+##
+## A copy of version 2.1 of the GNU Lesser General Public License is
+## distributed with calc under the filename COPYING-LGPL.  You should have
+## received a copy with calc; if not, write to Free Software Foundation, Inc.
+## 59 Temple Place, Suite 330, Boston, MA  02111-1307, USA.
+##
+## @(#) $Revision: 29.1 $
+## @(#) $Id: argv,v 29.1 1999/12/14 09:15:41 chongo Exp $
+## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/argv,v $
+##
+## Under source code control:	1999/11/23 19:45:05
+## File existed as early as:	1999
+##
+## chongo <was here> /\oo/\	http://reality.sgi.com/chongo/
+## Share and enjoy!  :-)	http://reality.sgi.com/chongo/tech/comp/calc/