update readme to fix grammar, spelling, wording (#1058)
I have updated the Readme markdown file to fix certain grammar and spelling issues.
This commit is contained in:
committed by
Nikolay Igotti
parent
783a18fad2
commit
2aa18d5833
@@ -2,51 +2,51 @@
|
||||
|
||||
# Kotlin/Native #
|
||||
|
||||
_Kotlin/Native_ is a LLVM backend for the Kotlin compiler, runtime
|
||||
implementation and native code generation facility using LLVM toolchain.
|
||||
_Kotlin/Native_ is an LLVM backend for the Kotlin compiler, runtime
|
||||
implementation, and native code generation facility using the LLVM toolchain.
|
||||
|
||||
_Kotlin/Native_ is primarily designed to allow compilation for platforms where
|
||||
virtual machines are not desirable or possible (such as iOS, embedded targets),
|
||||
virtual machines are not desirable or possible (such as iOS or embedded targets),
|
||||
or where a developer is willing to produce a reasonably-sized self-contained program
|
||||
without the need to ship an additional execution runtime.
|
||||
|
||||
Prerequesties:
|
||||
Prerequisites:
|
||||
install JDK for your platform, instead of JRE. The build requires ```tools.jar```, which is not included in JRE.
|
||||
|
||||
To compile from sources use following steps.
|
||||
To compile from sources use following steps:
|
||||
|
||||
First download dependencies:
|
||||
First, download dependencies:
|
||||
|
||||
./gradlew dependencies:update
|
||||
|
||||
Then build the compiler and libraries:
|
||||
Then, build the compiler and libraries:
|
||||
|
||||
./gradlew bundle
|
||||
|
||||
The build can take about an hour on a Macbook Pro.
|
||||
To run a shorter build with only host compiler and libraries run:
|
||||
To run a shorter build with only the host compiler and libraries, run:
|
||||
|
||||
./gradlew dist distPlatformLibs
|
||||
|
||||
After that you should be able to compile your programs like that:
|
||||
After that, you should be able to compile your programs like this:
|
||||
|
||||
export PATH=./dist/bin:$PATH
|
||||
kotlinc hello.kt -o hello
|
||||
|
||||
For an optimized compilation use `-opt`:
|
||||
For an optimized compilation, use `-opt`:
|
||||
|
||||
kotlinc hello.kt -o hello -opt
|
||||
|
||||
For some tests, use:
|
||||
For tests, use:
|
||||
|
||||
./gradlew backend.native:tests:run
|
||||
|
||||
To generate interoperability stubs create library definition file
|
||||
(take a look on [`samples/tetris/.../sdl.def`](https://github.com/JetBrains/kotlin-native/blob/master/samples/tetris/src/main/c_interop/sdl.def)) and run `cinterop` tool like this:
|
||||
To generate interoperability stubs, create a library definition file
|
||||
(refer to [`samples/tetris/.../sdl.def`](https://github.com/JetBrains/kotlin-native/blob/master/samples/tetris/src/main/c_interop/sdl.def)), and run the `cinterop` tool like this:
|
||||
|
||||
cinterop -def lib.def
|
||||
|
||||
See provided [samples](https://github.com/JetBrains/kotlin-native/tree/master/samples) and [`INTEROP.md`](https://github.com/JetBrains/kotlin-native/blob/master/INTEROP.md) for more details.
|
||||
See the provided [samples](https://github.com/JetBrains/kotlin-native/tree/master/samples) and [`INTEROP.md`](https://github.com/JetBrains/kotlin-native/blob/master/INTEROP.md) for more details.
|
||||
|
||||
Interop tool generates library in .klib library format, see [`LIBRARIES.md`](https://github.com/JetBrains/kotlin-native/blob/master/LIBRARIES.md)
|
||||
for more details on the file format.
|
||||
The Interop tool generates a library in the `.klib` library format. See [`LIBRARIES.md`](https://github.com/JetBrains/kotlin-native/blob/master/LIBRARIES.md)
|
||||
for more details on this file format.
|
||||
|
||||
Reference in New Issue
Block a user