Skip to content

Commit

Permalink
Backport Text and versions updates for 22.0 release PR to this branch…
Browse files Browse the repository at this point in the history
… > Truffle
  • Loading branch information
olyagpl authored and gilles-duboscq committed Jan 15, 2022
1 parent 8f99228 commit d64f93b
Show file tree
Hide file tree
Showing 6 changed files with 10 additions and 10 deletions.
2 changes: 1 addition & 1 deletion truffle/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
## Introduction

Truffle is an Open Source library for building programming language implementations as interpreters for self-modifying Abstract Syntax Trees.
Together with the Open Source [GraalVM compiler](../compiler), Truffle represents a significant step
Together with the Open Source [Graal Compiler](../compiler), Truffle represents a significant step
forward in programming language implementation technology in the current era of dynamic languages.

A growing body of shared implementation code and services
Expand Down
2 changes: 1 addition & 1 deletion truffle/docs/NFI.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ NFI is intended to be used, for example, to implement a language's FFI, or to ca

NFI uses `libffi`.
On a standard JVM it calls it using JNI, and on GraalVM Native Image it uses system Java.
In the future it may be optimised by the GraalVM compiler in native executables so that native calls are made directly from the compiled code.
In the future it may be optimised by the Graal Compiler in native executables so that native calls are made directly from the compiled code.

## Stability

Expand Down
2 changes: 1 addition & 1 deletion truffle/docs/Optimizing.md
Original file line number Diff line number Diff line change
Expand Up @@ -608,7 +608,7 @@ The `--engine.TraceCompilation` option also shows CallTarget invalidations with
## Ideal Graph Visualizer
The [Ideal Graph Visualizer (IGV)](../../docs/tools/ideal-graph-visualizer.md) is a tool to understand Truffle ASTs and the GraalVM compiler graphs.
The [Ideal Graph Visualizer (IGV)](../../docs/tools/ideal-graph-visualizer.md) is a tool to understand Truffle ASTs and the Graal Compiler graphs.
A typical usage is to run with `--vm.Dgraal.Dump=Truffle:1 --vm.Dgraal.PrintGraph=Network`, which will show you Truffle ASTs, guest-language call graphs, and the Graal graphs as they leave the Truffle phase.
If the `-Dgraal.PrintGraph=Network` flag is omitted then the dump files are placed in the `graal_dumps` directory, which you should then open in IGV.
Expand Down
4 changes: 2 additions & 2 deletions truffle/docs/Options.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,12 +18,12 @@ Or, for options only relevant for Truffle language implementers:
language-launcher --help:internal
```

In addition, the GraalVM compiler options can be listed with:
In addition, the Graal Compiler options can be listed with:

```shell
language-launcher --jvm --vm.XX:+JVMCIPrintProperties
```
See [graalvm_ce_jdk8_options](https://chriswhocodes.com/graalvm_ce_jdk8_options.html) for a list of GraalVM compiler options.
See [graalvm_ce_jdk8_options](https://chriswhocodes.com/graalvm_ce_jdk8_options.html) for a list of Graal Compiler options.

## Default Language Launcher Options

Expand Down
2 changes: 1 addition & 1 deletion truffle/docs/Profiling.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ See `language-launcher --help:tools` for more `--cpusampler` options.

### Getting compilation data from the CPU Sampler

Since versions 21.3.0 the CPU sampler CLI output was simplified to not include information about time spent in compiled code. This was, at least in part, motivated by the introduction of multi-tier compilation where "compiled code" was not descriptive enough.
Since version 21.3.0 the CPU sampler CLI output was simplified to not include information about time spent in compiled code. This was, at least in part, motivated by the introduction of multi-tier compilation where "compiled code" was not descriptive enough.
Using the `--cpusampler.ShowTiers` option allows users to control whether they wish to see compilation data at all, as well as to specify exactly which compilation tiers should be considered in the report.
For example, adding `--cpusampler.ShowTiers=true` will show all the compilation tiers encountered during execution as shown bellow.

Expand Down
8 changes: 4 additions & 4 deletions truffle/docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ permalink: /graalvm-as-a-platform/language-implementation-framework/
# Truffle Language Implementation Framework

The Truffle language implementation framework (henceforth "Truffle") is an open source library for building tools and programming languages implementations as interpreters for self-modifying Abstract Syntax Trees.
Together with the open source [GraalVM compiler](https://github.com/oracle/graal/tree/master/compiler), Truffle represents a significant step
Together with the open source [Graal Compiler](https://github.com/oracle/graal/tree/master/compiler), Truffle represents a significant step
forward in programming language implementation technology in the current era of dynamic languages.

The Truffle bits are uploaded to [Maven central](https://mvnrepository.com/artifact/org.graalvm.truffle). You can use them from your
Expand All @@ -17,12 +17,12 @@ The Truffle bits are uploaded to [Maven central](https://mvnrepository.com/artif
<dependency>
<groupId>org.graalvm.truffle</groupId>
<artifactId>truffle-api</artifactId>
<version>21.3.0</version> <!-- or any later version -->
<version>22.0.0</version> <!-- or any later version -->
</dependency>
<dependency>
<groupId>org.graalvm.truffle</groupId>
<artifactId>truffle-dsl-processor</artifactId>
<version>21.3.0</version>
<version>22.0.0<</version>
<scope>provided</scope>
</dependency>
```
Expand All @@ -37,7 +37,7 @@ It simplifies language implementation by automatically deriving high-performance
Information on how to get starting building your language can be found in the [Language Implementation Tutorial](./LanguageTutorial.md).
The reference API documentation is available as part of the [Truffle Javadoc](http://graalvm.org/truffle/javadoc/).
Start with looking at the [TruffleLanguage](http://www.graalvm.org/truffle/javadoc/com/oracle/truffle/api/TruffleLanguage.html) class, which one should subclass to start developing a language.
Truffle comes prebuilt with the GraalVM compiler and several language implementations as part of GraalVM.
Truffle comes prebuilt with the Graal Compiler and several language implementations as part of GraalVM.

A good way to start implementing your language with Truffle is to fork the [SimpleLanguage](https://github.com/graalvm/simplelanguage) project and start hacking.
SimpleLanguage is a relatively small language implementation, well-documented, and designed to demonstrate most of the Truffle features.
Expand Down

0 comments on commit d64f93b

Please sign in to comment.