man clig_Rest (Conventions) - declare command line arguments not associated with any option

NAME

::clig::Rest - declare command line arguments not associated with any option

SYNOPSIS

package require clig
namespace import ::clig::*
setSpec db

Rest name usage [-c lo hi]

DESCRIPTION

The Rest command specifies, what the parser should do with command line arguments not associated with any option. Option -c specifies how man non-option arguments are allowed on the command line (see clig::String(n)). The default values for lo and hi are 0 and oo respectively.

Without a Rest-declaration the parser will generate an error message and terminate the program.

If a Rest is declared, non-option arguments are returned by the parser as described below.

PARSER RESULT

tcl

Within a Tcl-script, the parser will set the variable with name varname in the stack-frame of its caller to the arguments on the command line which are not parameters of any option.

C

Mainly for historical reasons, the structure returned by the parser contains the slots int argc and char **argv. They contain the arguments on the command line which are not parameters of any option.

Example use of Rest: 

Rest infiles {input files} -c 1 oo

SEE ALSO

clig(1), clig_Commandline(7), clig_Description(7), clig_Double(7), clig_Flag(7), clig_Float(7), clig_Int(7), clig_Long(7), clig_Name(7), clig_String(7), clig_Usage(7), clig_Version(7), clig_parseCmdline(7)