NAME

ceylon version - Shows and updates version numbers in module descriptors

SYNOPSIS

ceylon version
[--confirm=option] [--cwd=dir] [--dependencies] [--encoding=charset] [--no-update-dependencies] [--set=value] [--source=dirs...] [--src=dir...] [--update-distribution] [--verbose[=flags]] [--] [modules]...

DESCRIPTION

If --set is present then update the module versions, otherwise show the module versions.

If --dependencies is present then show the versions of module imports of the given module(s).

<modules> specifies the module names (excluding versions) of the modules to show or whose versions should be updated. If unspecified then all modules are shown/updated.

null Other modules may also be updated unless the --no-update-dependencies option is used, even if they're not listed in <modules>

OPTIONS

--confirm=option

Used with --set, determines which updates require confirmation.

(default: all).

--cwd=dir

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

--dependencies

Display modules who depend on the given module. Only used when displaying modules, not when setting a new version.

--encoding=charset

Used with --set, sets the encoding used for reading and writing the module.ceylon files (default: platform-specific).

--no-update-dependencies

Do not update of the version in module imports of the target module(s) in other modules in the given --src directories. For example:

ceylon version --set 1.1 ceylon.collection
.fi
would update the version of ceylon.collection to 1.1 and update the module import version of all dependent modules in the given --src directories which depended on ceylon.collection null.
Whereas:


ceylon version --set 1.1 --no-update-dependencies ceylon.collection
.fi
would just update the version of ceylon.collection to 1.1, leaving dependent modules depending on the old version.

--set=value

The new version number to set.If unspecified then module versions are shown and not updated.

--source=dirs

An alias for --src (default: ./source)

--src=dir

A directory containing Ceylon and/or Java source code (default: ./source)

--update-distribution

Also set the version of any dependency to the Ceylon distribution modules

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

EXAMPLES

Listing the versions of all the modules in the ceylon SDK:

ceylon version
.fi

Listing the version of ceylon.collection, and modules that depend on it

ceylon version --dependencies ceylon.collection
.fi

Updating the version of ceylon.collection, and the modules that depend on it

ceylon version --set 1.0.1 ceylon.collection