
                        IMPINI V1.30 Readme
                        ===================

Contents
========
1. What is the IMPINI package for ?
2. Install and usage of IMPINI
3. Prerequisites/Restrictions/Limitations
4. Freeware license
5. Disclaimer
6. Check the archive integrity with
   Pretty Good Privacy (PGP)
7. Author




1. What is the IMPINI package for ?
===================================

IMPINI lets you copy INI file contents from one file to another,
delete certain INI entries or compare two INI files and let
IMPINI write the differences to a third ini file.

You can access the active user and system INI files by using the
reserved keywords USER and SYSTEM.

This makes IMPINI the perfect tool to backup INI entries for an
application and to restore them on another system or just to
backup OS2.INI/OS2SYS.INI.



2. Install and usage of IMPINI
==============================

The package comes with the following files

readme               - you are reading this file
file_id.diz          - package description file
impini.exe           - this is the program

Copy IMPINI.EXE to a directory within your PATH statement.
Execute IMPINI /?   to display the command help,
execute IMPINI /??  to display the options and list file help
execute IMPINI /??? to display the compare help


  Examples:
  --------

    IMPINI abc.ini USER

      copies all INI entries from abc.ini to the active user
      INI.

   ----------------------------

    IMPINI USER    OS2.INI
    IMPINI SYSTEM  OS2SYS.INI

      make a complete backup from the active user and system
      ini. Unlike the files ?:\OS2\OS2.INI and
      ?:\OS2\OS2SYS.INI, which are rewritten only after a
      certain amount of changes, this backup will include
      *ALL* changes up to the moment, that you use IMPINI !

      Note:
      - If you want to keep a backup of OS2.INI, always remember
        to make also a backup of OS2SYS.INI, because parts of
        Workplace Shell settings are stored in both INIs.

      - For WARP 4, you might want to backup also
        ?:\OS2\DLL\*.CFG to save the Warp Center configuration.
        Remember, that if you want to restore the Warp Center
        configuration, you have also to restore backups of
        OS2.INI and OS2SYS.INI.

   ----------------------------

    IMPINI USER myapp.ini /A:"My Application" /K:"Settings"

      exports the INI entry with the application name
      "My Application" and the key name "Settings" from the
      active user ini into the INI file named myapp.ini.
      Note, that you can specifiy only one application name per
      command line. If you ommit the keyname, all keys for the
      specified application are copied.

   ----------------------------

    IMPINI USER myapp.ini /L:listfile.txt

      Same as above, with the difference, that application
      and/or keynames are specified within a listfile.

      Note, that you have to use a listfile, if you want to
      specify multiple application and/or keynames.

      The listfile consists of one application name and an
      optional keyname per line, both enclosed in double quotes.
      If you ommit the keyname for a certain application, all
      keys for the specified application are copied.

      Example:
         "My Application" "Settings"
         "My 2nd. Application"

   ----------------------------

    IMPINI myapp.ini new.ini /E

      Imports the contents of the INI file named myapp.ini into
      the current active user ini. If either application names,
      key names or non-binary key data contain environment
      variables (like %myenvvar%), the environment variables
      are replaced by the actual contents of the variable.

   ----------------------------

    IMPINI old.ini new.ini diff.ini

      Compares old.ini with new.ini. New and/or modified entries
      are written to diff.ini. Deleted INI entries are displayed.
      If you want to get "deleted" INI entries in a separate INI
      file, execute the command again with switched source and
      compare ini:

        IMPINI new.ini old.ini deleted.ini



3. Prerequisites/Restrictions/Limitations
=========================================

This package requires OS/2 WARP 3 or later.
If you still need an OS/2 V2.x version, please send me an
email or decompress the executable file with lxlite.



4. Freeware license
===================

This software package is freeware.
It can be used wherever you use OS/2 WARP Version 3 or later.

You are allowed to freely use and distribute IMPINI as long as

 -  IMPINI is not sold as a part of another program package;
 -  no fee is charged for the program other than for cost of
    media;
 -  the complete package is distributed unmodified in the
    original and unmodified zip file;
 -  you send me some e-mail telling me how you liked it
    (or didn't like it), and/or your suggestions for
    enhancements.



5. Disclaimer
=============

Since this program is free, it is supplied with no warranty,
either expressed or implied.

I disclaim all warranties for any damages, including, but not
limited to, incidental or consequential damage caused directly
or indirectly by this software.

All software is supplied AS IS. You may use the IMPINI package
only at your own risk.

IMPINI must not be used in states that do not allow the above
limitation of liability.



6. Check the archive integrity with
   Pretty Good Privacy (PGP)
===================================

On my homepage I provide a detached signature certificate,
with which you can verify, that you downloaded an unmodified
version of this archive.

See my web pages also
- for links to PGP sites, where you can obtain further
  information on what PGP is and how you can install and use it
  under OS/2
- a manual for how to use PGP for the usage of such signature
  certificates.

See section "Author" for the location of my homepage.



7. Author
=========

This program is written by Christian Langanke.

Send your email to C.Langanke@TeamOS2.de

You can also visit my home page and download more free OS/2
utilities at:

     http://www.online-club.de/m1/clanganke

