home *** CD-ROM | disk | FTP | other *** search
/ PC-Online 1998 February / PCOnline_02_1998.iso / filesbbs / dos / listz21s.exe / LZSET10S.RAR / README.DOC < prev    next >
Encoding:
Text File  |  1997-02-25  |  6.5 KB  |  114 lines
  1. This file is part of LZSETUP (Configuration program for Listerz)
  2.  
  3. Copyright (c) 1997 Branislav L. Slantchev (gargoyle)
  4. A fine product of Silicon Creations, Inc.
  5.  
  6. This file is released under the terms and conditions of the GNU
  7. General Public License Version 2. The full text of the license is
  8. supplied in the Copying.Doc file included with this archive. This
  9. free software comes with absolutely no warranty, as outlined in the
  10. licensing text. You are not allowed to remove this copyright notice.
  11.  
  12. Contact: Branislav L. Slantchev at 73023.262@compuserve.com
  13. -----------------------------------------------------------------------------
  14.  
  15. I wrote the first version Listerz about a year ago and it proved to be quite
  16. a popular product. The demand for more configurability grew and finally
  17. evolved in the current LZSETUP separate setup program.
  18.  
  19. I also wanted to do a complete rewrite of Listerz in order to incorporate
  20. some of the new advanced features of PB-Lib v3.0 such as the bucket file
  21. buffering which allows all file areas to be transparently loaded in memory
  22. without a noticeable sacrifice in performance. Unlike the previous versions
  23. of Listerz, this one now supports all 10,000 file areas that ProBoard can
  24. use. Also, the command bar classes have been fully utilized along with the
  25. modified list viewer class which now supports windowed output. Another new
  26. feature is the user-definable background screens which can be in ASCII, ANSI,
  27. Avatar, PCBoard or Wildcat! formats. This versatility is due to the built-in
  28. terminal from PB-Lib. I should also mention the useron support for UserDoes
  29. and Doing (multinode systems). This built-in feature provides some online
  30. information which can be used by these utilities.
  31.  
  32. This source code represents my first effort in using the Object Professional
  33. library (version 1.10) from TurboPower Software. I think that I did quite
  34. alright, although some code optimization may be in order. In the course of
  35. developing the supporting routines for LZSETUP, several useful and generic
  36. functions took shape and are now available as part of the toolkit for OPRO
  37. also released by Silicon Creations, Inc. (along with the TurboVision kit).
  38.  
  39. The MANIFEST.DOC file outlines briefly the content of each file. Please,
  40. look over it now to make sure that you have received all the necessary files.
  41.  
  42. In order to recompile LZSETUP, you will need the following wares:
  43.  
  44.     - Borland C++ 3.1 (a later version may work too)
  45.     - Object Professional for C++ v1.10
  46.     - PB-Lib v3.0 (a later version may work too)
  47.  
  48. Although I have not tested the source with any compiler other than Borland
  49. C++ 3.1, it is reasonable to expect that it will compile with any later
  50. version of BC (as long as it is DOS-based). I am not sure that the code will
  51. even compile on Microsoft compilers. (It will not work with Watcom, Zortech
  52. or Symantec because Object Professional does not support them at all). You
  53. can get the current version of OPRO (C++) at a very low price (only $49)
  54. from TurboPower Software (http://www.tpower.com). This discounted price is
  55. due to them discontinuing development and support of all their C++ libraries.
  56. Note that the documentation you get is excellent so you should not have any
  57. trouble picking it up without assistance.
  58.  
  59. You will definitely need PB-Lib from Silicon Creations, Inc. in order to get
  60. this program up and running. Several classes and routines from this library
  61. have been used extensively throughout LZSETUP (such as the terminal emulator
  62. class). You should be able to obtain the latest release of PB-Lib from the
  63. same place you got this source code. For more information, refer to the
  64. SUPPORT.DOC file. Note that you will not be able to use versions prior to the
  65. 3.0 release (some of the features are simply not there).
  66.  
  67. I have included the LZSETUP.PRJ file, although I did not use it to create
  68. the distribution executable (I only used it as a single configuration file).
  69. The reason for this is the size of OPRO. The IDE linker cannot link the
  70. library as it is too big. I have provided a MAKEFILE which should be used
  71. to do that instead. Note that TLINK distributed with Borland C++ 3.1 cannot
  72. link it either as it runs out of table space. I have resorted to using the
  73. TLINK that comes with Borland C++ 4.51 which works quite ok (note that it
  74. also chokes if you try to compile with debugging information turned on).
  75.  
  76. The LZS_DATA.OPL file is the library file I used to store the dialog box
  77. and menu configuration from MakeMenu and MakeScrn (these come with OPRO).
  78. Note that the versions stored in this library are probably quite different
  79. from the ones you see in the source code. This is due to the subsequent
  80. revisions which I implemented straight in the code without using the two
  81. utilities. The same applies to the stored color configuration (I know I
  82. changed that manually too). The OPL file is provided for your convenience
  83. and should be used as a secondary source only.
  84.  
  85. Possible improvements to the program include updating the help status line.
  86. Right now, it only deals with menu items (i.e. when a dialog is popped-up,
  87. it does not display context-sensitive hints). Since the status line was an
  88. afterthought anyway, I decided not to waste valuable time investigating how
  89. to implement the additional features. A full-blown help module is very easy
  90. to do in OPRO but I think that it would be an overkill for an application
  91. such as this one. Another possible thing which can arguably be termed an
  92. "improvement" is to make the interface more like the JoHo-style it somewhat
  93. mimics (JoHo = Joaquim Homrighausen). I don't think that this is readily
  94. achieved with OPRO without some extensive additional programming. And last,
  95. the color setup is very confusing. I should have probably gone with a single
  96. dialog which groups all options. Oh well, maybe next time.
  97.  
  98. Have fun with the source code and I hope that you learn something from it!
  99. Please, refer to the file SUPPORT.DOC for information on how to contact me.
  100.  
  101. Copyrights and Trademarks:
  102.  
  103.   LZSETUP and PB-Lib ............. Copyright (c) 1997 Branislav L. Slantchev
  104.   Object Professional for C++ .... Copyright (c) 1991 TurboPower Software
  105.   Borland C++ 3.1 ................ Copyright (c) 1992 Borland International
  106.   UserDoes ....................... Copyright (c) Eddie Van Loon (DqP)
  107.   Doing .......................... Copyright (c) Fe-line Software
  108.   ProBoard ....................... Copyright (c) Philippe Leybaert
  109.  
  110. Branislav L. Slantchev
  111. Silicon Creations, Inc.
  112. San Angelo, TX
  113. February 15-16, 1997
  114.