This [teacup] subcommand fetches and installs a [package] for you.

It is important to note that there is a syntactical distinction between
installing a package (aka an extension), and an application.

[AK]: Since build 284134 teacup is able to work out on its own what FOO is, package, application, or profile, as long as the name FOO is unambiguous. That means that in most cases the '-is TYPE' arguments in the examples below are not necessary. Only if FOO is ambiguous, for example because the archives contain both an application FOO and a package FOO is the option '-is' required, and teacup will ask the user for it. More concrete example:

----
 % teacup install FOO
 Resolving FOO ... Cannot resolve ambiguous reference.
        entity      name  version platform
        ----------- ----- ------- --------
        application FOO 2.5     tcl
        package     FOO 2.5     tcl
        ----------- ----- ------- --------
        2 entities found


        Aborting installation. Please add the option '-is ENTITYTYPE' to
        the command line to unambiguously specify which of the found
        entities you wish to install. You _cannot_ --force this.
----

For example:

======
$ teacup install sqlite3
======

is what you would type to install a package.

======
$ teacup install tkcon -is application
======

is what you would type to install an application like [tkcon].

'''SPECIAL NOTE'''

If you are wanting to use teacup to install [tcllib], it too takes the
special syntax:

======
$ teacup install tcllib -is profile
======

This is because tcllib is '''NOT''' a package - it is a collection of
packages.

If you are wanting to install the [batteries included] set of packages
that came with ActiveTcl 8.4 (and to some degree, earlier), then you would
use

======
$ teacup install ActiveState::ActiveTcl -is profile
======

Now, some people may find they need to run [teacup timeout] to lengthen
the amount of time teacup waits for completion. And others may need to look
into teacup's ''-proxy'' argument.

----
!!!!!!
%| [Category Repository] |%
!!!!!!