home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / code / tkern10 / readme < prev    next >
Encoding:
Text File  |  1995-05-19  |  2.8 KB  |  74 lines
  1.  
  2.         TKERN - Troy's Kernel For Windows
  3.         =================================
  4.         Copyright 1994 Troy Rollo
  5.  
  6. LICENSING
  7.  
  8.     This program is free software. Most of the files are under
  9.     the GNU General Public License. See the file "COPYING.LIB"
  10.     for details.
  11.  
  12.     Two files, "links.c" and "stdio.c" are in the public domain.
  13.  
  14. WARRANTY
  15.  
  16.     There is no warranty of any kind for TKERN. the file
  17.     "COPYING.LIB" for details.
  18.  
  19. PURPOSE
  20.  
  21.     TKERN exists to fill a gap in the MS Windows 16 bit operating
  22.     environment - that of text oriented input and output, and of
  23.     sharing files between processes.
  24.  
  25.     Two well known approaches to the text oriented input and output
  26.     problem already exist - EasyWin (by Borland) and QuickWin (by
  27.     Microsoft). These approaches suffer by being proprietary and by
  28.     the files that are opened in either of these systems cannot be
  29.     passed on to child processes (tasks).
  30.  
  31.     It is envisaged that all text oriented programs for windows
  32.     could reasonably be converted for use with tkern. To this
  33.     end, use of TKERN for any project, including commercial
  34.     projects, is strongly encouraged.
  35.  
  36.     Most of TKERN is under the GNU Library General Public License,
  37.     with a limited number of files being public domain. The choice
  38.     of licensing in the case of each file has been made in such
  39.     a way that your own programs will be completely unencumbered,
  40.     but any modifications to the kernel itself (TKERN.DLL) or
  41.     to the file manager (TKFMANGR.EXE) will become free software.
  42.  
  43. DESIGN OVERVIEW
  44.  
  45.     There are three major components to TKERN - TKERN.DLL,
  46.     TKFMANGR.EXE, and the links.c and stdio.c files.
  47.  
  48.     TKERN.DLL is the kernel interface. Your own code will
  49.     rarely, if ever, call this interface directly.
  50.  
  51.     TKFMANGR.EXE is the TKERN File Manager. All files and
  52.     windows opened by other tasks using TKERN are in reality
  53.     owned by the TKERN File Manager. The TKERN File Manager
  54.     is started by TKERN.DLL, and is terminated when all
  55.     tasks using TKERN are terminated, and all windows created
  56.     by TKFMANGR.EXE are closed.
  57.  
  58.     links.c and stdio.c are intended to be linked in to your
  59.     own programs. stdio.c is an implimentation of the familiar
  60.     standard input and output functions of C. links.c contains
  61.     WinMain as well as trampoline functions for tkern.dll.
  62.     Your code will call functions in either links.c or stdio.c,
  63.     which will call entry points in TKERN as necessary.
  64.  
  65.     Because all the code under the GNU Library General Public
  66.     License    is in TKERN (or TKFMANGR, which for all practical
  67.     purposes can be considered part of TKERN itself), you can
  68.     distribute your own programs fully compiled and linked.
  69.     TKERN, being a DLL, can be trivially replaced with a newer
  70.     version, thus satisfying the requirements of the license
  71.     to enable end users to be able to replace the library.
  72.  
  73.  
  74.