Addin Development Kit for 1-2-3 Release 4 for DOS

The files in this kit have the same functionality as the development kit
for 1-2-3 R3.1.   There have been minor changes due to the changes in
1-2-3.


Installation.

To install all of the files, use

INSTALL  TARGET_PATH  123EXE_PATH

where TARGET_PATH is the path where the files are to be and 123EXE_PATH
is the path where the executables for 123 R4 are.  This second argument is
optional.  If it is given, that path will be checked for the presence of
an addin library file, and two sample .cnf files will be written to the
ADKSMPL file.  Additionally, two .bat files, lplenv.bat and stdenv.bat,
will be written to the ADKSMPL file.  Lplenv.bat will set up the environ-
ment variables for addin development.  Stdenv.bat initializes these 
variables to their value at the time of installation.  It is called by
lplenv.bat.  If you wish to do C addin development, and it is not set up
at the time of installation, either stdenv.bat or lplenv.bat will have
to be edited to provide the proper C development environment.

All the files necessary to create LPL addins for 123R4 are in EXE.   They 
should be placed in a directory that will be on your path while developing 
such addins.   These files include the compiler, LPL.exe and the debugger, 
LDEBUG.exe.

Files necessary to create C addins for 123R4 are in CEXE, INCLUDE, LIB and 
RATIONAL.  Executable files are in CEXE and in RATIONAL   Files in INCLUDE 
will be included in the sources for C addins.   There are two types of 
files in LIB - standard libraries and a few .obj files.   These last will 
be explicitly linked in to C addins in various circumstances.   The 
RATIONAL directory contains debugging aides including a sample from 
Rational Systems, whose extended memory manager is used by 123R4.

The files in SAMPLES include sample LPL addins and sample C addins.

One convenient organization would keep the same directory structure.  
Another would place the contents of EXE, CEXE and RATIONAL in one 
subdirectory, e.g ADKEXE.   The contents of INCLUDE would go in ADKINC, 
those of LIB into ADKLIB and those of SAMPLES into ADKSMPL.   In this 
scheme ADKEXE would be added to the path during development, ADKINC would 
be added to the INCLUDE environment variable and ADKLIB would be added to 
the LIB environment variable.   The OBJ files in ADKLIB would be copied 
into the work directory.   For example they would be copied into ADKSMPL 
while trying sample development and debug.   The batch file INSTALL.BAT 
will do this.  It is a simple process - it does minor checks but does not 
check for adequate disk space.  About 2.5 MB is required for everything.

If you wish to install by hand, check instcopy.bat to see if a compression
scheme was used in this file set.  If not, simply copy the files you wish;
otherwise consult install.bat and use instcopy to extract the desired files.

None of the addin libraries are included in this file set.  These libraries
are part of and included with 123R4.


Changes

The basic memory block size has changed from 16366 bytes to 16306 bytes.
This might have effects on R3.1 C addins that make memory allocations of
more than 16306 bytes, or by LPL addins that push resource limits that
depend on this quantity.  Most R3.1 addins will not notice.

Due to changes between R4 and R3.1 some macro strings may behave differ-
ently.  Consult the R4 reference manual for more details.

Since Release 4 for DOS is a completely DOS product, no OS/2 LPL support
is included in this file set.


No editor is included in this file set.
