ceylon compile-js(1) ceylon compile-js(1)NAME
ceylon compile-js - Compiles Ceylon source code to JavaScript and
directly produces module and source archives in a module repository
SYNOPSIS
ceylon compile-js [--cacherep=url] [--compact] [--cwd=dir]
[--encoding=encoding] [--lexical-scope-style]
[--maven-overrides=url] [--no-comments] [--no-
default-repositories] [--no-indent] [--no-module]
[--offline] [--out=url] [--overrides=url]
[--pass=secret] [--profile] [--rep=url...]
[--resource=dirs...] [--resource-root=folder-name]
[--skip-src-archive] [--source=dirs...]
[--src=dirs...] [--suppress-warning[=warnings...]]
[--sysrep=url] [--timeout=seconds] [--user=name]
[--verbose[=flags]] [--] [moduleOrFile]...
OPTIONS
--cacherep=url
Specifies the folder to use for caching downloaded modules. (de‐
fault: ~/.ceylon/cache)
--compact
Equivalent to --no-indent --no-comments
--cwd=dir
Specifies the current working directory for this tool. (default:
the directory where the tool is run from)
--encoding=encoding, -E encoding
Sets the encoding used for reading source files (default: plat‐
form-specific)
--lexical-scope-style
Create lexical scope-style JS code
--maven-overrides=url
Specifies the xml file to use to load Maven artifact overrides.
See http://ceylon-lang.org/documentation/current/refer‐
ence/repository/maven/ for information. Deprecated: use --over‐
rides.
--no-comments
Do not generate any comments
--no-default-repositories
Indicates that the default repositories should not be used.
--no-indent
Do not indent code
--no-module
Do not wrap generated code as CommonJS module
--offline, -L
Enables offline mode that will prevent connections to remote
repositories.
--out=url, -o url
Specifies the output module repository (which must be publish‐
able). (default: ./modules)
--overrides=url
Specifies the xml file to use to load module overrides. See
http://ceylon-lang.org/documentation/current/reference/reposito‐
ry/maven/ for information. Experimental.
--pass=secret
Sets the password for use with an authenticated output reposito‐
ry(no default).
--profile
Time the compilation phases (results are printed to standard er‐
ror)
--rep=url
Specifies a module repository containing dependencies. Can be
specified multiple times. (default: modules, ~/.ceylon/repo,
http://modules.ceylon-lang.org/repo/1)
--resource=dirs, -r dirs
Path to directory containing resource files. Can be specified
multiple times; you can also specify several paths separated by
your operating system's PATH separator. (default: ./resource)
--resource-root=folder-name, -R folder-name
Sets the special resource folder name whose files will end up in
the root of the resulting module CAR file (default: ROOT).
--skip-src-archive
Do not generate .src archive - useful when doing joint compila‐
tion
--source=dirs
An alias for --src (default: ./source)
--src=dirs, -s dirs
Path to source files. Can be specified multiple times; you can
also specify several paths separated by your operating system's
PATH separator. (default: ./source)
--suppress-warning[=warnings], -W
Suppress the reporting of the given warnings. If no warnings are
given then suppresss the reporting of all warnings, otherwise
just suppresss those which are present. Allowed flags include:
filenameNonAscii, filenameClaselessCollision, deprecation, com‐
pilerAnnotation, doclink, expressionTypeNothing, unusedDeclara‐
tion, unusedImport, ceylonNamespace, javaNamespace, sup‐
pressedAlready, suppressesNothing.
--sysrep=url
Specifies the system repository containing essential modules.
(default: $CEYLON_HOME/repo)
--timeout=seconds, -T seconds
Sets the timeout for connections to remote repositories, use 0
for no timeout (default: 20).
--user=name
Sets the user name for use with an authenticated output reposi‐
tory(no default).
--verbose[=flags], -d
Produce verbose output. If no flags are given then be verbose
about everything, otherwise just be verbose about the flags
which are present. Allowed flags include: all, loader, ast,
code, stitcher.
CONFIGURATION FILE
The compile tool accepts the following options from the Ceylon configu‐
ration file: defaults.offline, defaults.encoding, compiler.source, com‐
piler.resource and repositories (the equivalent options on the command
line always have precedence).
REPOSITORIES
Repositories like those specified with the --rep or --out options can
be file paths, HTTP urls to remote servers or can be names of reposito‐
ries when prepended with a + symbol. These names refer to repositories
defined in the configuration file or can be any of the following prede‐
fined names +SYSTEM, +CACHE, +LOCAL, +USER or +REMOTE. For more infor‐
mation see http://ceylon-lang.org/documentation/1.0/reference/tool/con‐
fig
28 October 2015 ceylon compile-js(1)