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

FreeBSD Manual Pages

  
 
  

home | help
ceylon import-jar(1)					  ceylon import-jar(1)

NAME
       ceylon import-jar - Imports a jar file into a Ceylon module repository

SYNOPSIS
       ceylon import-jar [--cacherep=url] [--cwd=dir] [--descriptor=file]
			 [--dry-run] [--force] [--ignore-annotations]
			 [--maven-overrides=file] [--missing-dependency-
			 packages=value...] [--no-default-repositories]
			 [--offline] [--out=url] [--overrides=file]
			 [--pass=secret] [--rep=url...]	[--show-classes]
			 [--show-suggestions] [--sysrep=url]
			 [--timeout=seconds] [--update-descriptor]
			 [--user=name] [--verbose[=flags]] [--]	{module} {jar-
			 file} [source-jar-file]

DESCRIPTION
       Imports the given <jar-file> using the module name and version given by
       <module>	into the repository named by the --out option.

       <module>	is a module name and version separated with a slash, for exam-
       ple com.example.foobar/1.2.0.

       <jar-file> is the name of the Jar file to import.

       <source-jar-file> is an optional	name of	 a  Jar	 file  containing  the
       sources for the Jar file	to import.

OPTIONS
       --cacherep=url
	      Specifies	the folder to use for caching downloaded modules. (de-
	      fault: ~/.ceylon/cache)

       --cwd=dir
	      Specifies	the current working directory for this tool. (default:
	      the directory where the tool is run from)

       --descriptor=file
	      Specify a	module.xml or module.properties	file to	be used	as the
	      module descriptor

       --dry-run
	      Performs all the sanity checks but does not publish the JAR.

       --force
	      Skips sanity checks and forces publication of the	JAR.

       --ignore-annotations
	      Do not check annotations for imports (default: false).

       --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.

       --missing-dependency-packages=value
	      Specifies	 which	packages a missing dependency contains.	Can be
	      specified	 multiple   times.   Format:   module-name/module-ver-
	      sion=package-wildcard(,package-wildcard)*,  where	 package-wild-
	      card supports *, ** and ?	wildcards.

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

       --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).

       --rep=url
	      Specifies	 a  module  repository containing dependencies.	Can be
	      specified	multiple  times.  (default:  modules,  ~/.ceylon/repo,
	      https://modules.ceylon-lang.org/repo/1)

       --show-classes
	      Shows  all external classes that are not declared	as imports in-
	      stead of their packages only.

       --show-suggestions
	      Shows suggestions	for modules based  on  missing	package	 names
	      (this can	take a long time).

       --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).

       --update-descriptor
	      Whenever possible	will create or adjust the descriptor file with
	      the necessary definitions.

       --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.

DESCRIPTORS
       When  the  import-jar  tool analyses the	<jar-file> and complains about
       missing dependencies a module descriptor	file should be	provided.  The
       name  of	 this  file  can be provided using the --descriptor option or,
       when left out, the tool will look for  <jar-file>.module.properties  or
       <jar-file>.module.xml.

       The  format  of	these  .properties or .xml files is documented online:
       http://www.ceylon-lang.org/documentation/1.1/reference/structure/mod-
       ule/#legacy_modules

       If  the option --update-descriptor is given the tool will try to	update
       the given descriptor file with the available information	(for now  this
       only  works for the .properties files). If the file didn't exist	yet it
       will be created.

       If the option --source-jar-file is given	the tool will try  to  include
       the source jar into the module as well, including a SHA1	of that	source
       jar.

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 import-jar(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | DESCRIPTORS | REPOSITORIES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ceylon-import-jar&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help