NAME

ceylon bootstrap - Generates a Ceylon bootstrap script in the current directory

SYNOPSIS

ceylon bootstrap
[--cwd=dir] [--force] [--installation=path] [--sha-sum=sum] [--verbose[=flags]] [--] [distribution]

DESCRIPTION

This tool generates a ceylonb bootstrap shell script (and a ceylonb.bat batch file for Windows) that functions exactly like the normal ceylon command, except that it is not necessary to install Ceylon yourself. On first execution the scripts will check if the required Ceylon distribution is already available locally and if not they will download and install it.

A bootstrap script can be used to make it very easy for authors of Ceylon projects to distribute their code to users without them having to install Ceylon. It is also useful for making sure that users use the exact same version of Ceylon the code was tested with without forcing them to install that exact same version themselves.

The distribution argument determines which distribution the bootstrap script will install. It can either be a version string, which will then be combined with the URL to the official Ceylon download site, or it can be a URL pointing directly to the desired Ceylon distribution download. If this option is not specified the current version will be used (default: 1.3.3)

OPTIONS

--cwd=dir: Specifies the current working directory for this tool. (default: the directory where the tool is run from)
--force: Create the bootstrap files even if they already exist
--installation=path: Determines where the bootstrap script will install the distribution. This can either be a path that starts with ~ or ${user.home} to indicate a location in the user's home directory or it can start with ${ceylon.user.dir} to indicate a location in the user's Ceylon directory. (default: ${ceylon.user.dir}/dists/)
--sha-sum=sum: The SHA-256 sum to be included for the bootstrap script (default: no sum)
--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.