-- $Id: README,v 1.4 2003/12/10 22:42:38 tom Exp $

Cdk Perl5 Extension,
Mike Glover, Copyright 1995-1999
Thomas Dickey modifications copyright 1999-2002, 2003

------------------------------------------------------------------------------

This is the Perl5 extension to the Cdk library written by Mike Glover.
See MANIFEST for a list of files provided with this extension.
See COPYING for the licensing terms for this package.
See
	http://invisible-island.net/cdk/
	ftp://invisible-island.net/cdk/
for the current version of this package.

How to build/install:
---------------------

1.  Make sure that Cdk (the C library libcdk and its header files) are
    installed.  Normally those are
	/usr/local/include/cdk/cdk.h (and other files)
	/usr/local/lib/libcdk.a (and perhaps a shared-library)

2.  Modify Makefile.PL as needed to tell the compiler where to find the Cdk
    library and header files.  In particular, these values may require change:

    * LIBS tells the compiler where to find the Cdk and curses libraries.  Just
      change the -L paths to reflect what is on your system.  Leave the -lcdk
      and -lcurses.  You may have to change -lcurses to -lncurses, for
      instance.

    * INC tells the compiler where to find the header files.  Just change the
      -I paths to reflect what is on your system.

3.  If your version of perl supports dynamic loading, it is simple to
    add new packages.  Run these commands
	perl Makefile.PL
	make install
    to generate a makefile for your configuration, build and install the
    extension.  (The process of building perl with statically loaded extensions
    is more complicated).

Testing the Cdk extension:
--------------------------

There are several examples in the subdirectories of this package:

    demo
	contains a few simple application programs.
    examples
	contains scripts which demonstrate each widget separately.
    fulldemo
	combines all of the widgets into a menu-driven application.