GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CEYLON-IMPORT-JAR (1)

NAME

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

CONTENTS

Synopsis
Description
Options
Descriptors
Repositories

SYNOPSIS

ceylon import-jar \kx [--cacherep=url] [--cwd=dir] [--descriptor=file] [--dry-run] [--force] [--maven-overrides=url] [--missing-dependency-packages=value...] [--no-default-repositories] [--offline] [--out=url] [--overrides=url] [--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 example 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. (default: ~/.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.
--maven-overrides=url
  Specifies the XML file to use to load Maven artifact overrides. See http://ceylon-lang.org/documentation/current/reference/repository/maven/ for information. Deprecated: use --overrides.
--missing-dependency-packages=value
  Specifies which packages a missing dependency contains. Can be specified multiple times. Format: module-name/module-version=package-wildcard(,package-wildcard)*, where package-wildcard 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 publishable). (default: ./modules)
--overrides=url
  Specifies the XML file to use to load module overrides. See http://ceylon-lang.org/documentation/current/reference/repository/maven/ for information. Experimental.
--pass=secret
  Sets the password for use with an authenticated output repository (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 instead 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 repository (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/module/#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 repositories when prepended with a + symbol. These names refer to repositories defined in the configuration file or can be any of the following predefined names +SYSTEM, +CACHE, +LOCAL, +USER or +REMOTE. For more information see http://ceylon-lang.org/documentation/1.0/reference/tool/config
Search for    or go to Top of page |  Section 1 |  Main Index


CEYLON IMPORT-JAR (1) 10 February 2016

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.