home *** CD-ROM | disk | FTP | other *** search
/ DOKAN 21 / DOKAN21.iso / Progs / Kiss / Exe / lhadll.exe / READMEE.TXT < prev    next >
Text File  |  1995-04-12  |  8KB  |  161 lines
  1. *******************************************************************************
  2.  
  3.  
  4.          ==============================================================
  5.           LHA.DLL Version1.10     (FREE SOFT)
  6.          ==============================================================
  7.                                                         by Hitoshi Ozawa
  8.  
  9.  
  10. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  11. 1. Introduction
  12. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  13.  
  14.         After unzipping the LHADLL.EXE file, please check that the following
  15.         files were created:
  16.         
  17.     LHA.DLL       DLL version of LHA file compression/decompression utility
  18.     LHA.H         LHA.DLL header file
  19.     LHA.LIB       LHA.DLL library file
  20.     READMEE.TXT   The file you are reading right now
  21.     LHA110E.TXT   Most recent information on LHA.DLL
  22.     APIE.TXT      Explanation of LHA.DLL API(application programming interface)
  23.     VERSIONE.TXT  LHA.DLL update information
  24.     TINYLHA.EXE   TinyLHA - LHA utility for Windows
  25.     TINYLHA.TXT   Explanation of TinyLHA utility
  26.     README_J.TXT  Japanese TXT files
  27.  
  28.     In future release of LHA.DLL we will only upload differences from the
  29.     previous version.  We are planning to make public the source to LHA.DLL
  30.     when the software seem stable.  To help us to make a quicker release of
  31.     a source code, please send any bugs you may find and any modification to
  32.     the software specification.
  33.  
  34. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  35. 2. Liability
  36. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  37.   The author and the developer of this software will not take any responsiblities
  38. for any damages that may occur with the use of this software.  The files contained
  39. in LHADLL.EXE are distributed "as is" and without any expressed and implied
  40. warranties.  The user assumes the entire risk of using the software.
  41.  
  42. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  43. 3. How to call LHA.DLL from your C program
  44. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  45.   1. <How to use LHA.DLL>
  46.         To call LHA.DLL from your C program, include lha.h (Part 1),
  47.         define output buffer (Part 2), and call the LHA.DLL (Part 3).
  48.         Finally, include the LHA.LIB file in the include library option
  49.         during the link operation.
  50.  
  51.   2. <LHA.DLL parameters>
  52.         int FAR PASCAL Lha(LPSTR szCmdLine, LPSTR szOutput, WORD wSize)
  53.  
  54.         where
  55.         LPSTR szCmdLine        Pointer to LHA.DLL option string
  56.         LPSTR szOutput         Output buffer pointer
  57.         WORD wSize             Output buffer size
  58.  
  59.   3. <Example>
  60.  
  61. -------------------------------------------------------------------------------
  62. #include <windows.h>
  63. #include <lha.h>                           /* lha.h               ... Part 1 */
  64.  
  65. char buffer[8000];                         /* define output buffer ...Part 2 */
  66.  
  67. int PASCAL WinMain( HANDLE hInstance, HANDLE hPrevInstance,
  68.                                         LPSTR lpszCmdLine,int nCmdShow )
  69. {
  70.                                           /* call LHA.DLL          ...Part 3 */
  71.     return Lha("a a:test.lzh a:*.bat",buffer,sizeof(buffer));
  72. }
  73. -------------------------------------------------------------------------------
  74.  
  75. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  76. 4. How to call LHA.DLL from Visual Basic program
  77. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  78.         The following explains how to call LHA() from a Visual Basic program.
  79.         
  80.         Include the following in the Form declarations section:
  81.  
  82.         Declare Function LHA Lib "lha.dll"  (ByVal szCmdLine As String,  
  83.                 ByVal szOutPut As String,ByVal iSize As Integer) As Integer 
  84.  
  85.         where:
  86.         szCmdLine        Command line parameter (same as parameters in DOS 
  87.                                                 version of LHA) 
  88.         szOutPut        Function output (list or return code)
  89.         iSize                size of szOutPut
  90.  
  91.         Finally, in the main program, call LHA function:
  92.                 RetCode% = LHA(szCmdLine, szOutPut, iSize) 
  93.  
  94. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  95. 5. Installing and using VB DLL controller
  96. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  97.         The following is a sample program to show how LHA.DLL can be called
  98.         from Visual Basic programs.
  99.  
  100.   <Installation>
  101.         Please copy the LHA.DLL file to the \WINDOWS\SYSTEM directory.
  102.  
  103. WARNING:        There is a difference between English and Japanese version
  104.                 of *.VBX files.  Be sure to know which version you are
  105.                 working with to assure proper operation in your other
  106.                 applications.  You will need English version if your other
  107.                 applications are English versions.  On the other hand, if
  108.                 you are using Japanese version of other Windows applications,
  109.                 you will need Japanese versions of these files.
  110.  
  111. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  112. 6. Distribution
  113. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  114.   LHADLL.EXE may be freely distributed if the following conditions are strictly
  115. obeyed: 
  116.         1. If it is to be copied to another forum or to another distribution
  117.            channel, please contact the developer to let us know exactly
  118.            where it is to be copied.  We will need this information to
  119.             maintain and upgrade LHADLL.EXE at all locations.
  120.         2. This program can be distributed only in the original archived
  121.            LHADLL.EXE formatted file.  Do not change this file or any files
  122.            within. 
  123.         3. Please make it apparent that LHA.DLL and TinyLHA are FREE SOFT.
  124.            It is necessary to state this in the program description.
  125.         4. If this program is to be mentioned in any article, please send
  126.            a E-mail to one of the developers.
  127.   If it is going to be distributed in any other ways (e.g. CD-ROM), please
  128. contact the developer.  The developer is willing to discuss other means of
  129. distribution.  Please send a mail to one of the E-mail addresses in the
  130. support section below.
  131.  
  132. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  133. 7. Copyright
  134. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  135.   LHA.DLL and TinyLHA are free soft.  Please respect wishes made by LHA
  136. developer  Hideyasu Yoshisaki when distributing.
  137.   TinyLHA for Windows is copyrighted by Tatsu Osawa.  No part of this
  138. program or data may be reproduced, in any form or by any means, without a
  139. written permission from Tatsu Osawa.
  140. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  141. 8. Support for Japanese Version
  142. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  143.  
  144.         Mail to: 
  145.            Jyunichi Komuke           Nifty Serve : GGD03634
  146.  
  147.         We could only guarantee quick response to messages send to the
  148.         above network.
  149.         
  150. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  151. 9. Concerning the English Version
  152. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  153.         English version will be supported by Hitoshi Ozawa
  154.                 CompuServe: 100220,3402
  155.         Internet:   gv9h-ozw@asahi-net.or.jp
  156.         Please send all correspondence to the above ID.  I will
  157.         relay messages to the developers.
  158.  
  159. *******************************************************************************
  160.  
  161.