SYNOPSIS

golo [options] command [arguments]

DESCRIPTION

Golo is a simple dynamic, weakly-typed language that favours explicit over implicit. For an introduction to programming in Golo, see the Golo Guide. The built-in modules and types are documented in the Golo and Java API documentation. These documents can be viewed at http://golo-lang.org/documentation/.

The golo command can be used to compile or run Golo program, generate documentation, and initialize new Golo projects.

OPTIONS

--help

Prints the help message.

--usage command

Print the usage of the given command.

COMMANDS

Each command is documented in its own manpage. For instance, the compile command is documented in golo-compile(1).

compile

compiles Golo source files

diagnose

prints compiler internal diagnosis information

doc

generates documentation from Golo source files

golo

dynamically loads and runs from Golo source files

new

generates new Golo projects

run

runs compiled Golo code

version

queries the Golo version

check

checks Golo source files for correctness

shebang

dynamically loads and runs from Golo source files

ENVIRONMENT VARIABLES AND PROPERTIES

The behavior of the golo compiler or runtime can be tuned using some environment variables or java properties.

GOLO_DEBUG or golo.debug

Activate debug mode. The value must be true or false

GOLO_DEBUG_TRACE or golo.debug.trace

Show stack traces when an internal error occurs.

GOLOPATH or golo.class.path

Defines the search path for golo module files. The format is the same as the Java CLASSPATH.

GOLO_OPTS

Defines additional JVM options. For instance, to trace the class loaded, one can define GOLO_OPTS="-verbose:class"

JAVA_HOME

Defines the location of the Java installation to use.

JAVA_OPTS

Defines additional JVM options.

CLASSPATH

Defines the search path for java classes. Also used for golo modules.

PERFORMANCE TUNING

The golo script comes with JVM tuning settings that may not be appropriate to your environment. We also provide a vanilla-golo script with no tuning. You may use the JAVA_OPTS or GOLO_OPTS environment variable to provide custom JVM tuning to vanilla-golo.

EXECUTING GOLO PROGRAMS

Golo programs can be executed directly from source code (see golo-golo(1))

$ golo golo --files lib1.golo lib2.golo script.golo --args arg1 arg2

or compiled into classes or jar archive (see golo-compile(1) and golo-run(1))

$ golo compile --output bin lib1.golo lib2.golo script.golo
$ golo run --classpath bin my.script.Module

SEE ALSO

java(1), golo-debug(1)

BUGS

AUTHOR

See https://github.com/eclipse/golo-lang/graphs/contributors or the CONTRIBUTORS file in the golo source distribution.

This work is made available under the terms of the Eclipse Public License 2.0. See http://www.eclipse.org/legal/epl-2.0 or the LICENCE file in the golo source distribution.