Version 2 of teacup install

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.