1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/rt/vmtest/src/main/java/org/apidesign/bck2brwsr/vmtest/Compare.java	Tue Feb 26 16:54:16 2013 +0100
     1.3 @@ -0,0 +1,45 @@
     1.4 +/**
     1.5 + * Back 2 Browser Bytecode Translator
     1.6 + * Copyright (C) 2012 Jaroslav Tulach <jaroslav.tulach@apidesign.org>
     1.7 + *
     1.8 + * This program is free software: you can redistribute it and/or modify
     1.9 + * it under the terms of the GNU General Public License as published by
    1.10 + * the Free Software Foundation, version 2 of the License.
    1.11 + *
    1.12 + * This program is distributed in the hope that it will be useful,
    1.13 + * but WITHOUT ANY WARRANTY; without even the implied warranty of
    1.14 + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    1.15 + * GNU General Public License for more details.
    1.16 + *
    1.17 + * You should have received a copy of the GNU General Public License
    1.18 + * along with this program. Look for COPYING file in the top folder.
    1.19 + * If not, see http://opensource.org/licenses/GPL-2.0.
    1.20 + */
    1.21 +package org.apidesign.bck2brwsr.vmtest;
    1.22 +
    1.23 +import java.lang.annotation.ElementType;
    1.24 +import java.lang.annotation.Retention;
    1.25 +import java.lang.annotation.RetentionPolicy;
    1.26 +import java.lang.annotation.Target;
    1.27 +
    1.28 +/** Can be applied on a method that yields a return value. 
    1.29 + * Together with {@link VMTest#create} it can be used to write
    1.30 + * methods which are executed in real VM as well as JavaScript VMs and
    1.31 + * their results are compared.
    1.32 + *
    1.33 + * @author Jaroslav Tulach <jtulach@netbeans.org>
    1.34 + */
    1.35 +@Retention(RetentionPolicy.RUNTIME)
    1.36 +@Target(ElementType.METHOD)
    1.37 +public @interface Compare {
    1.38 +    /** Specifies whether the system should internal JavaScript interpreter
    1.39 +     * as available via {@link javax.script.ScriptEngine}. Defaults to true,
    1.40 +     * but in some situations (benchmarking comes to my mind), one may set this
    1.41 +     * to <code>false</code>. In such case only browsers provided via
    1.42 +     * <code>vmtest.brwsrs</code> property are used. For example
    1.43 +     * <code>"vmtest.brwsrs=firefox,google-chrome"</code> would run the test
    1.44 +     * in HotSpot VM, firefox and chrome and would compare the results.
    1.45 +     * @return 
    1.46 +     */
    1.47 +    boolean scripting() default true;
    1.48 +}