{
{   This function returns a boolean specifying whether a file reference has
{ been "pre-evaluated".  A check must be made previous to this request to
{ ensure that the file reference begins with a colon.  This routine checks that
{ the first path element does not begin with a '$' and that the file reference
{ is not being evaluated as a command reference or entry point reference.  If
{ TRUE is returned, a call to CLP$PARSE_FILE_REFERENCE can be made as opposed
{ to a call to CLP$COMPLETE_FILE_REF_PARSE, which is more expensive.
{
{       CLP$FILE_REF_IS_PRE_EVALUATED (FILE_REFERENCE_PARSING_OPTIONS, PARSE):
{         BOOLEAN
{
{ FILE_REFERENCE_PARSING_OPTIONS: (input)  This parameter indicates how the
{       file reference is to be evaluated.  If clc$evaluating_command_ref or
{       clc$evaluating_entry_point_ref is specified, FALSE is returned.  The
{       options are:
{
{       clc$use_$local_as_working_cat:  This option specifies that $LOCAL
{             should be used as the working catalog in the event that the file
{             reference is a relative path.  If this option is omitted, the
{             path is considered to be relative to the current working catalog.
{
{       clc$evaluating_command_ref:  This option specifies that the file
{             reference is part of a command reference.  Specifying this option
{             in conjunction with the clc$evaluating_entry_ point_ref option
{             will result in an error.
{
{       clc$evaluating_entry_point_ref:  This option specifies that the file
{             reference is part of an entry point reference.  Specifying this
{             option in conjunction with the clc$evaluating_command_ref option
{             will result in an error.
{
{       clc$multiple_reference_allowed:  This option specifies that the "wild
{             card" notation is to be allowed in the file reference.
{
{       clc$command_file_ref_allowed:  This option specifies that a command
{             file reference (i.e.  $COMMAND or $COMMAND_OF_CALLER) is to be
{             allowed.
{
{       clc$file_ref_evaluation_stage:  This option specifies the extent to
{             which the expression is evaluated.  If this option is specified,
{             the values of any variables or functions in the expression are
{             determined and an absolute path is constructed.  If omitted,
{             additional interpretation of generic path elements and cycle
{             references occurs, which is the case when the file expression is
{             being used to access a file or catalog.
{
{ PARSE: (input)  This parameter specifies the file expression.
{
