Gitiles
Code Review Sign In
review.gerrithub.io / Chessray / ceylon-compiler / refs/heads/overloading
commite410da37aa970865c457df880b39cb06c1343845[log] [tgz]
authorTako Schotanus <tako@ceylon-lang.org>Wed Jan 18 12:38:56 2012 +0100
committerTako Schotanus <tako@ceylon-lang.org>Wed Jan 18 12:38:56 2012 +0100
tree6048b4dea002a5f42ddc6c8d228b4cb67ff351a9
parentf32e743b95eadc029cecd9acbea4016ba27720f5 [diff]
Some changes in the handling of overloaded classes and methods
5 files changed
tree: 6048b4dea002a5f42ddc6c8d228b4cb67ff351a9
  1. bin/
  2. langtools/
  3. lib/
  4. samples/
  5. src/
  6. test-src/
  7. .classpath
  8. .gitignore
  9. .project
  10. build.properties
  11. build.xml
  12. LICENSE
  13. NOTICE
  14. README.eclipse
  15. README.md
  16. README.tests
README.md

Ceylon compiler and tools

License

The content of this repository is released under the GPL v2 + Classpath Exception as provided in the LICENSE file that accompanied this code.

By submitting a "pull request" or otherwise contributing to this repository, you agree to license your contribution under the license mentioned above.

License terms for 3rd Party Works

This software uses a number of other works, the license terms of which are documented in the NOTICE file that accompanied this code.

Directory structure:

  • bin - the Ceylon tools binaries
  • lib - compile/runtime dependencies
  • src - the Ceylon compiler backend sources
  • langtools - the OpenJDK Javac compiler sources
  • test-src - the Ceylon compiler backend unit tests
  • samples - a few sample Ceylon programs

Build the compiler and tools

First you must make sure you have built the ceylon.language and ceylon-spec projects. Go into ceylon.language first and run

ant clean publish

Then go into ceylon-spec and run

ant clean publish

To build and test the compiler return to ceylon-compiler and run

ant clean publish

To run the tests type

ant test

Note that some of the tests currently fail. See more info in README.tests.

Once built, the compiler lives in this jars:

~/ceylon/repo/com/redhat/ceylon/compiler/java/0.1/com.redhat.ceylon.compiler.java-0.1.jar

If you want to build and run the Ceylon compiler in Eclipse then please see README.eclipse for setup instructions.

Running the compiler

The compiler can be run as follows:

bin/ceylonc -src samples -out build/ceylon-cars samples/helloworld.ceylon

The -src argument to the compiler is required in order for the compiler to figure out each class's full name. It is a colon-separated path, much like javac's -sourcepath argument.

You can add -rep arguments to add module repositories. Note that this is currently limited to local folders.

Running your Ceylon program

Right now the Ceylon runner doesn't support module repositories so you have to give it a valid classpath (this will be fixed soon):

bin/ceylon -cp build/ceylon-cars/unversioned/default_module-unversioned.car helloworld

Generating the API documentation

The ceylondoc tool can be run as follows:

bin/ceylond -out api-docs -src ../ceylon.language/languagesrc/current