home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / impin130.zip / readme < prev   
Text File  |  1999-01-01  |  6KB  |  211 lines
  1.  
  2.                         IMPINI V1.30 Readme
  3.                         ===================
  4.  
  5. Contents
  6. ========
  7. 1. What is the IMPINI package for ?
  8. 2. Install and usage of IMPINI
  9. 3. Prerequisites/Restrictions/Limitations
  10. 4. Freeware license
  11. 5. Disclaimer
  12. 6. Check the archive integrity with
  13.    Pretty Good Privacy (PGP)
  14. 7. Author
  15.  
  16.  
  17.  
  18.  
  19. 1. What is the IMPINI package for ?
  20. ===================================
  21.  
  22. IMPINI lets you copy INI file contents from one file to another,
  23. delete certain INI entries or compare two INI files and let
  24. IMPINI write the differences to a third ini file.
  25.  
  26. You can access the active user and system INI files by using the
  27. reserved keywords USER and SYSTEM.
  28.  
  29. This makes IMPINI the perfect tool to backup INI entries for an
  30. application and to restore them on another system or just to
  31. backup OS2.INI/OS2SYS.INI.
  32.  
  33.  
  34.  
  35. 2. Install and usage of IMPINI
  36. ==============================
  37.  
  38. The package comes with the following files
  39.  
  40. readme               - you are reading this file
  41. file_id.diz          - package description file
  42. impini.exe           - this is the program
  43.  
  44. Copy IMPINI.EXE to a directory within your PATH statement.
  45. Execute IMPINI /?   to display the command help,
  46. execute IMPINI /??  to display the options and list file help
  47. execute IMPINI /??? to display the compare help
  48.  
  49.  
  50.   Examples:
  51.   --------
  52.  
  53.     IMPINI abc.ini USER
  54.  
  55.       copies all INI entries from abc.ini to the active user
  56.       INI.
  57.  
  58.    ----------------------------
  59.  
  60.     IMPINI USER    OS2.INI
  61.     IMPINI SYSTEM  OS2SYS.INI
  62.  
  63.       make a complete backup from the active user and system
  64.       ini. Unlike the files ?:\OS2\OS2.INI and
  65.       ?:\OS2\OS2SYS.INI, which are rewritten only after a
  66.       certain amount of changes, this backup will include
  67.       *ALL* changes up to the moment, that you use IMPINI !
  68.  
  69.       Note:
  70.       - If you want to keep a backup of OS2.INI, always remember
  71.         to make also a backup of OS2SYS.INI, because parts of
  72.         Workplace Shell settings are stored in both INIs.
  73.  
  74.       - For WARP 4, you might want to backup also
  75.         ?:\OS2\DLL\*.CFG to save the Warp Center configuration.
  76.         Remember, that if you want to restore the Warp Center
  77.         configuration, you have also to restore backups of
  78.         OS2.INI and OS2SYS.INI.
  79.  
  80.    ----------------------------
  81.  
  82.     IMPINI USER myapp.ini /A:"My Application" /K:"Settings"
  83.  
  84.       exports the INI entry with the application name
  85.       "My Application" and the key name "Settings" from the
  86.       active user ini into the INI file named myapp.ini.
  87.       Note, that you can specifiy only one application name per
  88.       command line. If you ommit the keyname, all keys for the
  89.       specified application are copied.
  90.  
  91.    ----------------------------
  92.  
  93.     IMPINI USER myapp.ini /L:listfile.txt
  94.  
  95.       Same as above, with the difference, that application
  96.       and/or keynames are specified within a listfile.
  97.  
  98.       Note, that you have to use a listfile, if you want to
  99.       specify multiple application and/or keynames.
  100.  
  101.       The listfile consists of one application name and an
  102.       optional keyname per line, both enclosed in double quotes.
  103.       If you ommit the keyname for a certain application, all
  104.       keys for the specified application are copied.
  105.  
  106.       Example:
  107.          "My Application" "Settings"
  108.          "My 2nd. Application"
  109.  
  110.    ----------------------------
  111.  
  112.     IMPINI myapp.ini new.ini /E
  113.  
  114.       Imports the contents of the INI file named myapp.ini into
  115.       the current active user ini. If either application names,
  116.       key names or non-binary key data contain environment
  117.       variables (like %myenvvar%), the environment variables
  118.       are replaced by the actual contents of the variable.
  119.  
  120.    ----------------------------
  121.  
  122.     IMPINI old.ini new.ini diff.ini
  123.  
  124.       Compares old.ini with new.ini. New and/or modified entries
  125.       are written to diff.ini. Deleted INI entries are displayed.
  126.       If you want to get "deleted" INI entries in a separate INI
  127.       file, execute the command again with switched source and
  128.       compare ini:
  129.  
  130.         IMPINI new.ini old.ini deleted.ini
  131.  
  132.  
  133.  
  134. 3. Prerequisites/Restrictions/Limitations
  135. =========================================
  136.  
  137. This package requires OS/2 WARP 3 or later.
  138. If you still need an OS/2 V2.x version, please send me an
  139. email or decompress the executable file with lxlite.
  140.  
  141.  
  142.  
  143. 4. Freeware license
  144. ===================
  145.  
  146. This software package is freeware.
  147. It can be used wherever you use OS/2 WARP Version 3 or later.
  148.  
  149. You are allowed to freely use and distribute IMPINI as long as
  150.  
  151.  -  IMPINI is not sold as a part of another program package;
  152.  -  no fee is charged for the program other than for cost of
  153.     media;
  154.  -  the complete package is distributed unmodified in the
  155.     original and unmodified zip file;
  156.  -  you send me some e-mail telling me how you liked it
  157.     (or didn't like it), and/or your suggestions for
  158.     enhancements.
  159.  
  160.  
  161.  
  162. 5. Disclaimer
  163. =============
  164.  
  165. Since this program is free, it is supplied with no warranty,
  166. either expressed or implied.
  167.  
  168. I disclaim all warranties for any damages, including, but not
  169. limited to, incidental or consequential damage caused directly
  170. or indirectly by this software.
  171.  
  172. All software is supplied AS IS. You may use the IMPINI package
  173. only at your own risk.
  174.  
  175. IMPINI must not be used in states that do not allow the above
  176. limitation of liability.
  177.  
  178.  
  179.  
  180. 6. Check the archive integrity with
  181.    Pretty Good Privacy (PGP)
  182. ===================================
  183.  
  184. On my homepage I provide a detached signature certificate,
  185. with which you can verify, that you downloaded an unmodified
  186. version of this archive.
  187.  
  188. See my web pages also
  189. - for links to PGP sites, where you can obtain further
  190.   information on what PGP is and how you can install and use it
  191.   under OS/2
  192. - a manual for how to use PGP for the usage of such signature
  193.   certificates.
  194.  
  195. See section "Author" for the location of my homepage.
  196.  
  197.  
  198.  
  199. 7. Author
  200. =========
  201.  
  202. This program is written by Christian Langanke.
  203.  
  204. Send your email to C.Langanke@TeamOS2.de
  205.  
  206. You can also visit my home page and download more free OS/2
  207. utilities at:
  208.  
  209.      http://www.online-club.de/m1/clanganke
  210.  
  211.