@begin(header)
author: Eric Mandel
show_author: ShowNone
author_organization: Smithsonian Astrophysical Observatory
node_expert: eric@cfa.harvard.edu
expiration_date: 12/31/93
last_modifier: eric@cfa.harvard.edu
last_mod_date: 11/24/92
mod_num: 8
@end(header)
@b<This window will tell you about the parameter editor command buttons,
which are used to run commands, view help, etc.>

The @b<parameter editor> can be used to display and edit parameters,
run tasks, display help, and ask questions.  The @b<parameter editor>
consists of two parts: the command strip and the parameter section.

Each command button is a @b<ParamButton> widget.  These widgets have
support for balloon-style help.  Pressing the @b<left> mouse button on
one of these ParamButtons and holding down will bring up a help window
that will describe the command.  If you release the mouse while it is
within the command button (not the balloon-help button), the balloon
help window will disappear and the command will execute.  If you move
the mouse out of the command button and release, the balloon help
window will disappear, but the command will not execute. (In both of
these cases, the behavior is analogous to that of other command
buttons).  However, if you move the mouse @b<into> the balloon help window
and release, the ballon help window will remain.  You can then cancel
the command by pressing the @b<cancel> button in this help window or
run the command by pressing the @b<ok> button.

Some of the ParamButtons (@b<Q&A>, @b<Run>, and @b<RunBkgd>) maintain
parameters associated with that command that can be edited by the
user.  These parameters are displayed and edited in the balloon help
window.  To edit a parameter, press the command button and hold it.
After a fraction of a second, the balloon help window will pop up.
Move the mouse into that window and release it.  The window will stay
up and will display the command description and the current value of
the parameter.  The parameter can be edited using emacs-style
commands.  As described above, to execute the command, press @b<ok>,
to abort press @b<cancel>.

The following commands are available in the command strip:

@b<Close>:
Close the parameter editor.  This is different from iconifying the window.
When a window is closed, it is destroyed.  When it is iconified, it still
exists, but is not shown on the screen (or is shown as an icon).

@b<Help>:
Display the help page for this task (in a separate window).  The type
of help window is determined by the @b<usexih> resource.  If this
resource is set to "True", a window is brought up which displays the
help file using different fonts for italics, bold, etc.  If the
@b<usexih> resource is set to "False", a simple ASCII display window is
brought up.  This latter help window supports a facility to search the
text for keywords.  Typing the control S key (^s) will bring up a
search window.  Note that this facility is disabled if the @b<usexih>
resource is set to display help with fancy fonts.

@b<I'm Unhappy>:
Get help from an expert.  Every ASSIST window contains this
button.  It allows the user to send comments, questions, bug reports,
and enhancement requests to the appropriate expert.  Clicking this
command button with the @b<left> mouse button will bring up a menu
giving the choices noted above.  When a choice of action is made, a
text window is activated in which to compose the comment, bug report,
etc.  Templates are provided for IRAF bug reports and enhancement
requests.  Comments and questions are free form.  Upon completion, the
text is sent to the appropriate expert for further action.  Responses
are sent back to the questioner and also are integrated into the
ASSIST so as to become available to other users.

@b<Q&A>: View the existing comments, bug reports, and enhancement
requests for the current task.  This command sends an rdb-style
command to the target analysis window to access an rdb data base of QA
reports and return all reports for this task. You can add an rdb-style
filter specification to the retrieve command. It should begin with a
boolean such as "&&" or "!!" that will be appended to the default
filter of "package==<package> && task==<task>".  For example, '&&
type=="B"' will only return bug reports, while "&& fixed=="N" will
return all reports that are not fixed.

@b<Run>:
Run the current task.  All parameters are updated as necessary and the
task is run. The @b<mode> of the task set to @b<hidden>, so that no
prompts are issued in the IRAF window.  The IRAF window itself
is raised to the top of the window stack so that it is clearly
visible. (This can be turned off. See below).

This command supports a parameter string that is appended to the
command line for each task.  The default string is "mode=h".  You can
add to the command string by editing the parameter.  For example, if
you add the string ">> foo" to the default parameter string, the task
will redirect its output to the file "foo".  It is recommended that
the "mode=h" default string be part of the command line.

@b<RunBkgd>:
Run the current task in the background.  This option works identically
to @b<Run>, except that the task is run as a background job. This
allows the user to continue working while the task is running.  The
output is sent to a file named uparm$batch_<n>.out, where n is a
number starting from 1.

This command supports a parameter string that is appended to the
command line for each task, @b<after> the "&" character that tells the
command to run in the background.  You can edit this parameter to add
a priority.  For example, if you add the string "16" to the default
parameter string, the task will run in the background with priority
16.  (Note the difference in the meaning of the parameter string
between @b<Run> and @b<RunBkgd>.)

@b<Update>:
Update all parameters, as necessary.  The task is not run.

@b<Reload>:
Reload any unupdated parameter values.  Any parameter value that has
been changed but not updated (using @b<Run> or @b<Update>) is reloaded
with its previous value.  Note that once a parameter has been sent to
IRAF and updated, it cannot be reloaded.  @b<Unlearn>: Use the
IRAF @b<unlearn> command to reset the default parameter values for
this task.

@b<Print>:
Print the help file.

@b<Lock>:
Toggle the lock state of this window. Locked window are not closed to
make room in the window stack for new windows.  To learn more about
@b<Window Management>, see the <Window Management> button below.

@b<Back>:
Bring back the last window in this window stack that was closed in
order to make room for a new window.

To learn more about @b<Window Management>:
@button<Window Management, Stack_Management>

To learn more about editing parameters:
@button<Param Editing, Param_Editing>