TurboPower Async Professional CLX


Table of contents

1.  Introduction
2.  Package names
3.  Installation
4.  Kylix 3 Issues
5.  Version history
5.1   Release 1.01

==============================================


1. Introduction

Async Professional is a comprehensive communications toolkit for
Borland Delphi, C++Builder, & ActiveX environments. It provides direct
access to serial ports.  It supports terminal emulation, file transfers, 
and more.

This is a source-only release of TurboPower Async Professional CLX 
(APROCLX) for Linux operating systems.  It includes designtime and
runtime packages for Kylix 1 and 2 as well as an experimental package
for Kylix 3.

For help files and a PDF manual, please see the tpaproclx_docs package 
on SourceForge (http://sourceforge.net/projects/tpaproclx).

==============================================

2. Package names


TurboPower APRO package names have the following form:

  tpaproclxVVV_KBB.*
  | |      |   ||
  | |      |   |+-- BB   VCL Version (60=Kylix1, 65=Kylix2, 69=Kylix3)
  | |      |   +--- K    Kind of package (r=runtime, d=designtime)
  | |      +------- VVV  Product version
  | +-------------- xxx  Product Name
  +---------------- tp   Identifies TurboPower product

For example, the APROCLX designtime package files for Kylix 2 have the
filename tpaproclx101_d65.*.

The runtime package contains the core functionality of the product and
is not installed into the IDE. The designtime package references the
runtime package, registers the components, and contains property
editors used in the IDE.

==============================================

3. Installation


To install TurboPower APROCLX into your IDE, take the following steps:

  1. Extract the tarball into a directory.  This will place the release
     files into an aproclx/ directory under that directory.

     Example:
       cd ~
       tar -xvzf tpaproclx_1_01.tar.gz
     This will create an aproclx/ directory off the home directory.
     
  2. Start Kylix.

  3. Add the source subdirectory (e.g., /home/username/aproclx/source) 
     to the IDE's library path.

  4. Open & compile the runtime package specific to the IDE being
     used.

     Note: You may need to create a symbolic link in your kylix/bin
     directory to the runtime .so file.  

     For example: If Kylix is installed in the /kylix directory off
     your home directory and aproclx is at ~/aproclx, the following 
     commands will create the necessary symbolic link:

     Kylix 1
       cd ~/kylix/bin
       ln -s ~/aproclx/packages/bpltpaproclx101_r60.so bpltpaproclx101_r60.so

     Kylix 2 
       cd ~/kylix2/bin
       ln -s ~/aproclx/packages/bpltpaproclx101_r65.so bpltpaproclx101_r65.so
  
  5. Open & install the designtime package specific to the IDE being
     used. The IDE should notify you the components have been
     installed.

==============================================

4. Kylix 3 Issues

This version of APRO CLX contains experimental packages for Kylix 3.
These packages have not been completely tested.  Please report any
issues to the bug tracker for the APRO CLX project.  You can find
this at http://sourceforge.net/projects/tpaproclx/.

==============================================

5. Version history


5.1 Release 1.01
    
    Initial release to SourceForge

