diff --git a/.travis.yml b/.travis.yml new file mode 100644 index 0000000000000000000000000000000000000000..45e9d6b58303079261f0de4db6b8c60df52fe955 --- /dev/null +++ b/.travis.yml @@ -0,0 +1,4 @@ +language: java + +jdk: + - oraclejdk8 diff --git a/README.md b/README.md index 01bc600e24d020c9baa758ad0eb7e9488317abac..35ad8cd417da5256763d2283e5cbd656c65a5a7c 100644 --- a/README.md +++ b/README.md @@ -1,18 +1,10 @@ # RagDoc Builder -This is a tool for building documentation metadata about JastAdd applications. +This is a tool for building documentation metadata for JastAdd projects. +RD-Builder outputs JSON files with documentation metadata. The documentation +can be viewed with RagDoc Viewer. -Run RD-Builder on the generated Java code of your JastAdd project as if -compiling the code. RD-Builder outputs a bunch of JSON files describing the -structure of the input classes. The generated documentation can be viewed with -RagDoc Viewer. - -RagDoll depends on the following projects: - -* `extendj` -* `se.llbit:jo-json` - ## Building Build the tool with Gradle: @@ -23,8 +15,8 @@ Build the tool with Gradle: ## Usage -Run RagDoc Builder just like a regular Java compiler. The output is written to -the path specified by the `-d` option: +Run RagDoc Builder on the generated JastAdd code, just like a regular Java compiler. +The output is written to the path specified by the `-d` option: java -jar rd-builder.jar -d docs -classpath $CLASSPATH File1.java ... @@ -32,3 +24,7 @@ the path specified by the `-d` option: The documentation is generated as a set of `.json` files containing information about the classes and attributes in the input sources. This information can be viewed on a webpage using RagDoc Viewer. + +RagDoc Builder can also be run using JastAddGradle. By running RagDoc Builder +this way, you won't have to set up the full compile path because JastAddGradle +knows how to compile the generated JastAdd code.