Version 1.22 Beta
-----------------

This is a very preliminary copy of version 1.22, but it was important to get
this posted before the holidays.

There are only ONLY two files to download, but as far as I know this
contains EVERYTHING you need to run or rebuild any DOS or Windows DSK app.
(More will be released later)

Read the file _README_.122 and WHATSNEW.TXT in the \dsk3\dsk3\ subdirectory
(after install) for detailed information on what has been done.

General Installation
--------------------
1) Make a X:\DSK3 directory to unzip these files into (X is your drive)

2) In X:\DSK3, unzip the source files including sub-dirs using

   'src_122.exe -d'

3) If you have dowwloaded 'exe_122.exe -d' copy this to the main DSK3
   application directory and expand as shown.  Or, if you have a Borland
   compiler (you can use BCBUILD.BAT with version 3.1), you can recompile
   at your end.

   'exe_122.exe -d'

Compiling the code
------------------
1) Compile the DOS text based *.EXE files from *.PRJ files in dsk3\dsk3.
   Use either Borland 3.1 or Borland 4.51 (can translate old *.prj).  If
   you have Borland 3.1, you can run BCBUILD.BAT from a DOS box and do
   some multi-tasking (a cup off hot chocolate is good).

2) Compile the Borland Windows projects in the \dsk3\dsk3dll (CHAINSAW.EXE,
   DSK3DLL.DLL and DSK2MSG.DLL) and dsk3\gui (WSCAN.EXE, DSK3DLL.DLL)
   directories with Borland 4.51 (or later?)

3) MicroSoft Visual C++ Version 5.00 compiles the equivelent of CHAINSAW.EXE
   and its DLL from the workspace in dsk3\dsk3\tryone\...

4) MSVC creates the EXE and DLL files into debug sub directories, so you
   will need to copy these files, plus C3X.DSK to a common location to run
   them.

5) The DSK file needed for running the windows apps will NOT be in those
   directories.

   Copy C3X.ASM, FFT_*.ASM and DSK_OSC.ASM into dsk3\gui and assemble.

   Copy C3X.ASM into dsk3\dsk3dll\ and assemble.

Highlights

- This code now compiles using either MSVC or Borland tools and can be
  used to create either DOS or Windows applications.  Comments and other
  cleanup is still being performed.

- Play with all the apps, and READ the READ_122 file!

Best regards

  Texas Instruments
  attn: Keith Larson
  xkel@micro.ti.com

New Features
------------
  The latest new features, and dead bug list, can be found in 3 major files
WHATSNEW.TXT, APPHELP1.TXT and APPHELP2.TXT.  In general the major new
enhancment is that a Windows DLL and Windows application (a simple debugger)
are being worked on.  These are a bit crude, but may be of interest to a
sufficiently wide number of DSK users.

Normal Installs
---------------
  To avoid accidentaly overwriting the master source files in the
G:\DSK3\DSK3 source area, a different install path is used for conventional
DSK tools installation. In other words, a DSK user who installs from the
installation disk (IE from the box) would actualy install the DSK software
to the X:\DSKTOOLS directory.

Installing a source library 'mirror'
------------------------------------
  If you install the DSK tools using the following directories, you will
duplicate the same file structure used to build the projects at Texas
Instruments.  This would essentialy make your isntallation a mirror of the
master source directory at Texas Instruments.  This would make it easier
to simply open a project and use it and would allow you to use the
BCBUILD.BAT, MKTOOLS.BAT and MKTOOLS2.BAT automatic batch update programs.

Directories
-----------
G:\DSK3\DSK3     <- Expand the DSK DOS level tools here
G:\DSK3\DSK3DLL  <- Expand the windows version here.  The windows projects
                    will reference the \DSK3\DSK3 files as needed
G:\DSK3\DSK3_921 <- Rename an old directory as backup
etc...


  When manualy expanding the files, use the -d option to expand the
subdirectories contained in the files.  The '-d' option can be used either
from PKUNZIP or as an argument to a self expanding file.  If not, all of the
files will be bunched up together in the root directory.

G:\DSK3\DSK3\PKUNZIP SRC_121.ZIP -d  <- Expands all subdirs

Have fun!


INSTALLATION
------------
  Most of the files located in the C3XDSKFILES ftp directory are self
extracting files that will, when executed, expand into an image of an
installation disk with 4-6 seperate files.

  To install the code contained in one of these files, first copy the
download file to a new directory and expand it.  You should then see an
INSTALL.BAT file.

  When you run INSTALL.BAT it will copy the appropriate files to the
destination directory DSKTOOLS and then expand further creating both
files and sub-directories.   After expansion, INSTALL.BAT continues by
calling the DSK3A assembler to assemble the neccessary files for the DSK3
Applications.  When the installation is complete, the entire DSKTOOLS
subdirectory will contain 4-5 MBytes of executable DSK applications and
source files.


C:\DOWNLOAD> CD\                           make a new install directory
C:\>MD INSTALL
C:\>CD INSTALL
C:\>INSTALL\copy C:\DOWNLOAD DSK3_120.EXE  copy the file to expand
C:\>INSTALL\>DSK3_120                      expand the file
C:\>INSTALL\>INSTALL                       run INSTALL.BAT

  Read each screen carefully.  If you dont like where the installation
  is going to put the files you can quite INSTALL.BAT and install
  everything manualy.


Errors during installation
--------------------------
 'OUT OF ENVIRONMENT SPACE'

  If you see this error while installing the DSK tools, it is most likely
because of the limited environment space that each DOS box is allocated
by Windows when it creates a DOS box (256 bytes is the default).  The
simplest and fastest workaround is to eliminate some environment variables
or even the path statement.  Then after the DSK tools are installed kill
that DOS box, and open a new one.  Each time a DOS box is created, it
gets a new copy the original environment variables so you dont have to
worry about corrupting the DOS environment of the next DOS box.  To
see the current environment variables, type 'SET' on the command line
as shown.

C:\>SET                <with no argument, shows current environment>
C:\>SET D_OPTIONS=     <clears environment storage for D_OPTIONS>
C:\>SET D_OPTIONS=C:\  <sets environment storage for D_OPTIONS>


  The DSK software project files which have been included are for Borland
C++ version 3.1.  Later versions of Borland C++ tools (ver 4.0) are also
able to read in and translate these projects.

  To use these project files, copy them from the project directory to the
root directory.  If you used the installation batch file you should copy
the project files in C:\DSKTOOLS\PROJECTS to the root C:\DSKTOOLS

  If you have a different compiler that cannot read in these project files a
list of all the files that should be included in the project build, along
with the build parameters, is given at the top of the main application file.

