This is a [teacup] subcommand.

This subcommand provides meta-data information from the [teapot]
repository.


**Information about the default output of teacup describe**

The default is to provide the information available in the '''description''' meta-data. For instance:

 $ teacup describe Expect
Entity        Expect

  Description @ http://teapot.activestate.com
          Expect is a tool for automating interactive applications such as
        telnet, ftp, passwd, fsck, rlogin, tip, etc. Expect really makes
        this stuff trivial. Expect is also useful for testing these same
        applications. And by adding Tk, you can also wrap interactive
        applications in X11 GUIs.


The default output has 3 components:

   1. The word "entity" and the name of the entity being described.

   2. The word "description" and the [URL] of the [teapot] site from which the meta-data is coming.

   3. The short description stored within teapot.

Note that not all packages stored within teapot have descriptions. In those cases, you would see the following:

 $ teacup describe Tk
Tk is not known

Problems which occurred during the operation:
* http://teapot.activestate.com : Tk is not known

**Information about the extended output of teacup describe**

If you add the ''-all'' argument to the subcommand, teacup will report
all the meta-data. For example:

======
$ teacup describe --all Expect
Entity   Expect
Origin @ http://teapot.activestate.com
As::author  : Don Libes
As::origin  : http://expect.nist.gov
            | http://sourceforge.net/projects/expect
            | http://sf.net/projects/expect http://expect.nist.gov
Category    : Automation
Description : Expect is a tool for automating interactive applications
            | such as telnet, ftp, passwd, fsck, rlogin, tip, etc.
            | Expect really makes this stuff trivial. Expect is also
            | useful for testing these same applications. And by
            | adding Tk, you can also wrap interactive applications in
            | X11 GUIs.
Entity      : package
License     : Public Domain
Name        : Expect
Platform    : aix-powerpc hpux-parisc linux-glibc2.2-ix86
            | linux-glibc2.3-ix86 linux-glibc2.3-x86_64
            | macosx-universal solaris2.10-ix86 solaris2.6-sparc
            | solaris2.8-sparc win32-ix86
Require     : {Tcl 8.4}
Subject     : automation interactive automation interactive pty
            | pseudo tty
Summary     : Automating interactive applications
Version     : 5.43 5.43.0 5.44.1 5.44.1.1 5.44.1.2 5.44.1.3 5.44.1.4
            | 5.44.1.5

======

Most of this meta-data should be self-explanatory.


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