.ec _
.ll 76
.ad b
.in 4
.\"====================================================================
.ti -4
1 Language
.ce
TASK_\ Command Language Summary
  
Define and specify the input parameters of tasks. Only available
in a Library mode, not to be used interactively.

.nf
CHARACTER :  Define a character string parameter
FILE      :  Define a filename
GO        :  Activate the task
HELP      :  Show the help
INTEGER   :  Define an integer parameter
LOGICAL   :  Define a logical parameter
MORE      :  Show a separator in a widget
REAL      :  Define a real parameter
VALUES    :  Define a real parameter through a variable length expression
WRITE     :  Write parameter value to task parameter file.
.fi
.\"====================================================================
.ti -4
1 CHARACTER
.ti +4
TASK_\CHARACTER "Prompt_ text" Name = [Value] [/CHOICE List]

Define the parameter Name of Character type (C*256), and assign it a
value if specified. Otherwise, prompt with the text for a value.

A list of predefined values can be provided with the option /CHOICE. If
a wildcard (*) is present in the list, a custom value can also be set
by the user.
.\"====================================================================
.ti -4
1 FILE
.ti +4
TASK_\FILE "Prompt_ text" Name = [Filename] [/OLD] [/NEW]

Define the parameter Name of Character type, and assign it a filename.
Otherwise, prompt with the text for a content. 
In Windows mode, launch a file browser to get the filename. 

NOT IMPLEMENTED: if option /OLD (resp. /NEW) is present, the file must
(resp. must not) already exist.
.\"====================================================================
.ti -4
1 GO
.ti +4
TASK_\GO

In a .init file, activate the Widget if in Windows mode, or finish
parameter entry and activate the task checker. 

In a .check file, launch the Task.
 .\"====================================================================
.ti -4
1 INTEGER
.ti +4
TASK_\INTEGER "Prompt_ text" Name[Ndim] = [Value .. Value__Ndim] [/RANGE] 
  [/INDEX String1 ... StringN [*]] [/CHOICE Value1 ... ValueN [*]]

Define the parameter Name of Integer type and dimension Ndim (or
scale), and assign it a value if specified. Otherwise, prompt with the
text for value(s). Both I*4 and I*8 parameters are supported by this
command.

The /RANGE option restrict the valid range for the values. In Windows mode,
it activates a slider.

A list of character strings can be provided with the option /INDEX. This
/INDEX option means to return the rank of the given string among the 
available choices.  A * as the
last choice means any other value is also valid.

A list of predefined values can be provided with the option /CHOICE. If
a wildcard (*) is present in the list, a custom value can also be set
by the user.
.\"====================================================================
.ti -4
1 LOGICAL
.ti +4
TASK_\LOGICAL "Prompt_ text" Name = [YES|NO] 

Define the parameter Name of Logical type, and assign it a value if
specified. Otherwise, prompt with the text for a content. 
.\"====================================================================
.ti -4
1 MORE
.ti +4
TASK_\MORE


.\"====================================================================
.ti -4
1 REAL
.ti +4
TASK_\REAL "Prompt_ text" Name[Ndim] = [Value .. Value__Ndim] [/RANGE] 
  [/SEXAGESIMAL] [/CHOICE Value1 ... ValueN [*]] 

Define the parameter Name of Real type and dimension Ndim, and assign
it a value if specified. Otherwise, prompt with the text for
value(s). Both R*4 and R*8 parameters are supported by this command.

The /RANGE option restrict the valid range for the values. In Windows mode,
it activates a slider.

If option /SEXAGESIMAL is present, a sexagesimal string can be
provided: it will be converted to a floating point value.

A list of predefined values can be provided with the option /CHOICE. If
a wildcard (*) is present in the list, a custom value can also be set
by the user.
.\"====================================================================
.ti -4
1 VALUES 
.ti +4
TASK_\VALUES "Prompt_ text" Name = [Value1 ... ValueN] 

Define the parameter Name of Character type, and assign it a string holding
all values specified as further arguments.    Values can be math expression
and will be converted to numerics before assignment.  This command allows
to specify variable dimension numeric arrays as task parameters.
.\"====================================================================
.ti -4
1 WRITE
.ti +4
TASK_\WRITE Name

This command is only valid in a .check file. It writes 
the parameter Name on one line in the .par file, followed by its content
in the next lines.
.\"====================================================================
.ti -4
1 ENDOFHELP
