home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / mini105.zip / english / mINI.txt < prev   
Text File  |  1999-12-19  |  6KB  |  142 lines

  1. mINI
  2. ----
  3.  
  4. Short English abstract - Note: I'm no native speaker so please excuse some poor phrases.
  5.  
  6. (*): Changes
  7.  
  8.  
  9.  
  10. What?
  11. -----
  12.  
  13. 'mINI' is a small, dialog driven, INI editor. It provides the basic functions like viewing, editing etc. and can keep all available INI files on your system to provide quick access.
  14. Furthermore you can export applications or whole INIs to Rexx code.
  15. Since version 1.00 it is also possible to view and edit ASCII based INI files if they are of Windows's style INI format.
  16.  
  17. The files in this distribution:
  18.  
  19.     - \install.cmd        Creates program objects and associations (*)
  20.     - \mINI.exe        Executable
  21.     - \mINI.dll        Graphics-DLL
  22.     - \mINI.txt        German docs
  23.     - \mINI.ico        Icon
  24.     - \mINIdata.ico    Icon for data files
  25.     - \history.txt        German revision history
  26.     - \fastini.dll        See below (*)
  27.         - \english\mINI.txt    This text
  28.     - \english\history.txt    Revision history
  29.  
  30. NOTE: 'mINI' does make use of the highly recommended Freeware-DLL FastINI for Rexx from Dennis Bareis  (http://www.labyrinth.net.au/~dbareis/index.htm) (*) if available.
  31. You are encouraged to get FastINI.DLL from the author's homepage (current version: fi_98148.zip).
  32. The plain DLL is included in this mINI package for your convenience. (*)
  33.  
  34.  
  35.  
  36. Why?
  37. ----
  38.  
  39. Nice question :-)
  40. You obviously will have a good reason to look at INI files. There are many INI editors and viewers for OS/2 available so you can freely decide which one to use.
  41. 'mINI' doesn't provide sophisticated copy functions, can't clean up your system INI files and - if not using FastINI - is no performance wonder.
  42. Doesn't matter: 'mINI' meets my own needs, offers a nice looking GUI with treeview, can edit, view, delete ASCII and HEX data, exports Rexx code and provides quick access to all INI files.
  43.  
  44.  
  45.  
  46. How?
  47. ----
  48.  
  49. There's no need for a special installation procedure. Just copy all the above files into one directory that suits you. If you want to deinstall - delete them.
  50.  
  51. Please take the time and get FastINI! Just unpack it and copy fastini.dll to a directory in your LIBPATH so 'mINI' can support the fast INI functions of it.
  52. To do so, start 'mINI' with parameter "-FASTINI".
  53. You don't have to install FastINI but then RexxUtil is used which is not so fast...
  54.  
  55. Furthermore you can pass an INI file via command line or Drag&Drop it onto the program object to view the INI directly. This is usefull if you don't want to associate all *.INI files with 'mINI'.
  56.  
  57. Usage should be easy. Just try it out.
  58.  
  59. On first start I recommend you to search all available INI files on your HD ("add" "all") which may take some time.
  60.  
  61. "include ASCII INIs" provides the possibility of including ASCII based INI files while scanning.
  62. Once done these files are stored for further use and quick access. Of course you can manually "add" single INIs or choose the system ones, too.
  63.  
  64. "clear" clears the current file from list. "clear" "all" does what you would expect.
  65.  
  66. The AutoLocator ("Search") allows you to find specific INI files in very large lists and places the results in an extra list box for quick access, (just select and hit "return").
  67.  
  68. "View" shows INI and provides the basic functions via pop-up. (*) If the current file is not readable or has an unknown format you can view it via E.EXE.
  69.  
  70. Rexx or ObjectRexx must be installed.
  71.  
  72. If you use Warp 3 or 4 it's a good idea to 'pack' the executable and the DLL with 'lxlite' by Andrew Zabolotny to save some space on your HD.
  73.  
  74. NOTE: If you don't know exactly what you are doing you can cause serious damage when changing INI files. This is not a problem just with 'mINI', it can happen with all INI editors. So please be careful.
  75.  
  76. That's it :-)
  77.  
  78.  
  79.  
  80. What else? (*)
  81. ----------
  82.  
  83. -Special thanks for reporting problems, comprehensive suggestions and friendly mail:
  84.   Raphael Tennenbaum
  85.   Raul E. Barragan
  86.   Norbert Kohl
  87.   Barbara Ann Baker
  88.   Aglaja Przyborski
  89.   Rossen Assenov
  90.   Carlos Andre R. Marcier
  91.   Klaus Staedtler
  92.   Bill Scarlett
  93.   Jack Troughton
  94.   Walter Schmidt
  95.  
  96. Very special thanks to Bill Scarlett for parts in this file corrected to colloquial english! (*)
  97.  
  98.  
  99.  
  100. Known Bugs? (*)
  101. -----------
  102.  
  103. - It is not possible to perform delete or export actions on ASCII based INIs. I have no plans to change this yet.
  104.  
  105. - Saving ASCII INIs will store all included available comments at the end of the file. The previous or original order will not be preserved.
  106.  
  107. - ASCII based INIs with comments before the first section, will not be recognized.
  108.  
  109. - Adding data causes a re-read of the selected INI file. Sometimes there seems to be a problem (can't figure out exactly what it is) which may crash mINI after re-read. As of my research there seems to be no data loss. But be carefull with heavy adding things to large INI files (such as USER or SYSTEM). (*)
  110.  
  111.  
  112.  
  113. Who?
  114. ----
  115.  
  116. mINI is a quick hack but was tested carefully under Warp 4 (German version) with FP1/FP8.
  117.  
  118. If you detect problems, or errors, or if you have suggestions, please let me know.
  119.  
  120. Have fun.
  121.  
  122. Kai Evers
  123. email:    ke@LB.maus.de
  124. www:    http://www.s.netic.de/kevers/
  125.  
  126. mINI is freeware and (c)opyright by Kai Evers.
  127.  
  128. Rexx export code based on ConvINI by Bernd Schemmer (100104.613@compuserve.com).
  129. --------------------------------------------------
  130.  /* Distribution:                                                      */
  131.  /*   This code may be distributed freely and used in other programs.  */
  132.  /*   Please give credit where credit is due.                          */
  133. --------------------------------------------------
  134.  
  135. FASTINI.DLL is freeware by Dennis Bareis:
  136. --------------------------------------------------
  137. ╕I retain (C)opyright and reserve all rights to all my programs.╕
  138. --------------------------------------------------
  139.  
  140. Disclaimer:
  141. Use at your own risk. The author shall in no event be liable for the accuracy of the retrieved data and the program code or for any damage that the software might cause directly or indirectly.
  142.