Mercurial > hg > graal-compiler

annotate graal/com.oracle.truffle.api.codegen.test/src/com/oracle/truffle/api/codegen/test/package-info.java @ 8238:0b48dc5f37c3

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added truffle.api.codegen.test project with a BultinFunctionTest.
author Christian Humer <christian.humer@gmail.com>
date Fri, 01 Mar 2013 17:05:14 +0100
parents
children 703c09f8640c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
8238
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
1 /*
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
2 * Copyright (c) 2012, 2012, Oracle and/or its affiliates. All rights reserved.
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
4 *
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
5 * This code is free software; you can redistribute it and/or modify it
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
6 * under the terms of the GNU General Public License version 2 only, as
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
7 * published by the Free Software Foundation.
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
8 *
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
9 * This code is distributed in the hope that it will be useful, but WITHOUT
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
12 * version 2 for more details (a copy is included in the LICENSE file that
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
13 * accompanied this code).
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
14 *
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
15 * You should have received a copy of the GNU General Public License version
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
16 * 2 along with this work; if not, write to the Free Software Foundation,
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
18 *
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
20 * or visit www.oracle.com if you need additional information or have any
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
21 * questions.
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
22 */
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
23 /**
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
24 * <p>This package contains basic tests of the Truffle-Source-Code-Generation (short Codegen) API and serves at the same
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
25 * time as an introduction to the Codegen API for language implementors. Every test gives an example on how to use the construct explained in the class description.</p>
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
26 *
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
27 * <p>
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
28 * This API relies heavily on the concepts described in {@link com.oracle.truffle.api.test}. We assume that the
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
29 * reader is already familiarized with those concepts.
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
30 * </p>
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
31 *
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
32 * <p>
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
33 * TODO general description
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
34 * </p>
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
35 *
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
36 * <p>
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
37 * This introduction to Codegen contains items in the following recommended order:
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
38 *
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
39 * <ul>
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
40 * <li>How would you generate builtin functions? {@link com.oracle.truffle.api.codegen.test.BuiltinFunctionTest}</li>
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
41 * </ul>
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
42 * </p>
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
43 *
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
44 */
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
45 package com.oracle.truffle.api.codegen.test;
0b48dc5f37c3 Added truffle.api.codegen.test project with a BultinFunctionTest.
Christian Humer <christian.humer@gmail.com>
parents:
diff changeset
46