Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ceylon compile-js(1)					  ceylon compile-js(1)

NAME
       ceylon  compile-js  - Compiles Ceylon source code to JavaScript and di-
       rectly produces module and source archives in a module repository

SYNOPSIS
       ceylon compile-js [--cacherep=url] [--compact] [--cwd=dir]
			 [--encoding=encoding] [--include-
			 dependencies[=flags]] [--lexical-scope-style]
			 [--maven-overrides=file] [--no-comments] [--no-
			 default-repositories] [--no-indent] [--no-module]
			 [--offline] [--out=url] [--overrides=file]
			 [--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)

       --include-dependencies[=flags]
	      Determines if and	how compilation	of dependencies	should be han-
	      dled. Allowed flags include: never, once,	force, check.

       --lexical-scope-style
	      Create lexical scope-style JS code

       --maven-overrides=file
	      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 null generate any comments

       --no-default-repositories
	      Indicates	that the default repositories should not be used.

       --no-indent
	      Do null indent code (deprecated)

       --no-module
	      Do null 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=file, -O file
	      Specifies	the XML	file to	use  to	 load  module  overrides.  See
	      http://ceylon-lang.org/documentation/current/reference/reposito-
	      ry/maven/	for information. null.

       --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,
	      https://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 null 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.

COMPILING DEPENDENCIES
       The --include-dependencies option can take the following	flags:

        null -	Never perform any compilation

        null -	Only compile when the compiled module is not available

        null -	Compile	when the sources are newer than	the compiled module

        null -	Always compile

       If the flag is given without an argument	it's the  same	as  specifying
       check. If no flag is given at all it's the same as specifying never.

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, +REMOTE or +MAVEN. For more
       information    see     https://ceylon-lang.org/documentation/1.3/refer-
       ence/repository/tools

				18 August 2017		  ceylon compile-js(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ceylon-compile-js&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help