Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm
Precedence: bulk
Reply-To: <derby-dev@db.apache.org>
Received-SPF: pass (athena.apache.org: domain of m.v.lunteren@gmail.com
 designates 209.85.160.44 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <50198852.6070805@oracle.com>
References: <50198852.6070805@oracle.com>
Date: Wed, 1 Aug 2012 15:03:56 -0700
Message-ID: 
 <CADjEm_Ugm_t=khWArjr8C-yfQvQVJ2UzjBWxZO-M48b893K_iw@mail.gmail.com>
Subject: Re: ij EXPECT command
From: Myrna van Lunteren <m.v.lunteren@gmail.com>
To: derby-dev@db.apache.org
Content-Type: text/plain; charset=ISO-8859-1

On Wed, Aug 1, 2012 at 12:49 PM, Rick Hillegas <rick.hillegas@oracle.com> wrote:
> The localization audit has stumbled across a message related to the ij
> EXPECT command. I don't understand this command so I don't know what to tell
> the translators. The command is not otherwise documented and is a NOP unless
> the undocumented ij.expect property is set to true. I am unable to make any
> sense of the header comment for this command in the ij grammar:
>
> "Will eventually detect the lines that the strings are without special
> literals, but for now this is expedient (except for the doubling of
> quotes...)
>
> Used to test the previous statement's output. Note that ij must be in
> "expect" mode to use this statement, otherwise it is just ignored. This is
> due to the overhead of tracking the prior statement's output."
>
> The command and the ij.expect property do not appear in the documentation
> for Cloudscape 3.5. It seems that:
>
> 1) The command was added after IBM acquired Cloudscape.
>
> 2) The command was disabled (by not being documented) at least by the time
> that Derby was open-sourced.
>
> Does anyone know what this command is for and whether it is still needed?
>
> Thanks,
> -Rick

I checked the ancient version control records for cloudscape for
hints...This section of ij.jj has remained untouched since it was
first put in, in April 1998.
(for reference, the branch for 1.5 of Cloudscape was created Sept
1998, the branch for 3.6 was created Oct 2000).

The comment for the check-in was:
"new ij commands: set connection, connect as, disconnect all,
	show connections, protocol; and property ij.protocol.
	prototype of expect, not yet fully implemented (always passes).
	new ij entry point"

So looks like the expect command was never finished.

Myrna