CHANGING INI FILES:
~~~~~~~~~~~~~~~~~~~
If you want to change to another INI file click on "File" (ALT-f).

You can choose:
  - USER INI FILE (os2.ini)
  - SYSTEM INI FILE (os2sys.ini)
  - USER AND SYSTEM FILE (above together)
  - Other INI files (this could be for example AmiPro's INI FILES)

If you click on USER or SYSTEM file the user and/or system INI file are opemed
as set in the enviromental variable which must be set in the config.sys file.
If you choose "Other .." a file dialog box is opened with the directory shown
where INITOR was started up. You can open another (personal) INI file.

If file is not an INI file, an error message will be displayed.

If you save the path as shown below "Saving ..." the next time you 
open INITOR the file dialog box opens with the last saved path.


MOVING AROUND:
~~~~~~~~~~~~~~
You simply click on an application to go to another application in the
"Application Name" Window using scroll bars as well.

You can use the TAB key to switch between the applicatio or key windows
and scroll using the cursor keys.

All key names of that application will be displayed in the "Key Name" window.

The data of the first key will be displayed in HEX and ASCII.
If you need another key, click on another key and the new data will be 
displayed with offset and the number of bytes in HEX and ASCII.


EDIT KEYS AND KEY DATA:
~~~~~~~~~~~~~~~~~~~~~~~
To change the data of an  application use "Edit Application" (alt-e).

A Dialog box will appear with the application name in the first row,
the key name in the second row and the key data last.

You cannot change the application name, that is set read only but you can
change the key name and the data.

The first dialog box is for ASCII strings with values above 32 and below
127 (ASCII). If key data is shown with values below 32 you can click
on "HEX" button and another dialog box appears to be able to change
binary data.

If you want to edit keys larger than 10500 bytes you might consider reading
the SPLIT/UNSPLIT option below.


HEX DATA EDITING:
~~~~~~~~~~~~~~~~~
If you clicked on the HEX button in the "ADD-EDIT" dialog box above a
dialog box appears to edit hex (binary) data. 

Just edit data as required keeping a space between each BYTE and use 
HEX and BINARY numbers to enter data into the window.

You must keep a space between each byte or else your data will not
be accepted. The box will stay until the data is accepted 
or you press CANCEL.

You must end the data in the hex window with a "00" and a space. 
The "00" is part of the key data in the INI files and the space
is the programs way to determine a byte separated from another byte.

I dont think this is a major problem although it might seem a little
awkward in the first place.

If you want to edit keys larger than 10500 bytes you might consider reading
the SPLIT/UNSPLIT option below.


DELETING APPLICATIONS AND KEYS:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you need to delete a key or application click on "Delete Items" (ALT-d).

"Delete Application" will delete the applcation pointed at with all keys 
belonging to THAT application and the data belonging to the keys.
An application example:  "AMIUSER" in the provided test.ini!

"Delete Selected Key" will only destroy the key and the data.
A key example of above application:  "BackUpPath"
Data for the above key:              "d:\tmp"

You are asked for confirmation to delete the key/application.
The key name is displayed on the query mennu, so you know which key it is.


ADDING APPLICATIONS AND KEYS:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you need to add a new application or add a key to an existing 
application choose "Add Items" (ALT-A).

"Add new application" adds a new application to the INI file. An 
application is for example "AmiPro". If you add a new application 
it will be sorted alphabetically (not in the INI file).

"Add new key" adds a new KEY to the current application pointed at.
A new key would be for example "INIPATH" (data in my case: d:\os2).


SAVING (COPYING) DATA AND SCREEN LOCATION:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The data is saved automatically when you press OK in the ADD or EDIT
(HEX EDIT) dialog boxes.

If you want to save (or copy) an application or key to another file
you may do so by using the save menu (ALT-s): 

There are three options available:
    Save Application to other (INI) File
    Save Key to other (INI) File
    Save ALL to other (INI) File

After you clicked on one of the three you are asked (dialog box) to specify
the file name. If you specify an existing file the information is simply added
to the file. If the file is NOT a proper INI file an error message will
be displayed and nothing will happen.
If the file opened and if applications or keys with the same name exist
in the OPENED file exist, they are simply overwritten. So you must make sure
you do not overwrite the current application in the "save to" file.
(You could simply open another copy of the INITOR.)

The first option saves ALL KEYS of one APPLICATION to a new file.
The second option saves ONE KEY of one APPLICATION to a new file.
The third option saves all information in the current file to a new file.

You can save the window location (quite handy) by selecting "Screen Location".

You can save the last paths:
    SAVEREAD PATH saves the path of the directory last read from/save to.
    DISPLAY PATH saves the path of the last INI file displayed.

These information is stores in a file called INITOR.INI in the programs
directory. You can edit it and have a look at it.


READING IN OF DATA OF OTHER INI FILES:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you want to read data from a specified INI file into the current displayed
file simply click on (ALT-r):

There are two choices to read from another file into the current file:
     Read Application form other file.
     Read other INI file into current file.

Once you clicked on one of the items, you are asked to specify a filename
to read from. If you specify a new file it is opened (for saving only).
If you specify an existing file it is checked and if it's not a proper INI 
file an error message will be displayed and nothing happens.

Read other INI file into current file.
Load the INI file you want to add the data and click on the READ menu 
to read in the data from a specified file. Note that the complete file is read
into the current file and if a KEY/APPLICATION of a name in the current file
exists, it is simply overwritten. No check is made.

Read Application form other file:
Load the INI file you want to add the data and click on the READ menu 
to read in the data from a specified file. You are asked afterwards in a 
select dialog box which applications you want to read into the current file.
Simply select each of the items you want an click on OK.
If a KEY/APPLICATION of a name in the current file exists, it is 
simply overwritten. No check is made.


POPUP MENUS:
~~~~~~~~~~~~
There are two POPUP menus availabe depending the window the cursor is on.
These POPUP menus are selected when the right mouse button is pressed
in either of the windows.

If the cursor is in the application window, the following popup is displayed:
  ADD  Application
  Save Application
  Delete Application
  Edit Application ASCII
  Edit Application HEX
  Refresh

If the cursor is in the key window, the following popup is displayed:
  ADD Key
  Save Key
  Delete Key
  Refresh

If you do not select anyone of the items, nothing will happen.
You must hold the right mouse as long as you want to select something.
The popup menu disappears as soon as the mouse button is released.


ACCELERATOR KEYS:
~~~~~~~~~~~~~~~~~
A number of accelerator keys are available to jump to certain options:

SHIFT       A:       Displays the about box.
SHIFT       U:       Loads the USER PROFILE into the editor.
SHIFT       S:       Loads the SYSTEM PROFILE into the editor.
SHIFT       O:       Opens up a diaplog box to load in user specified INI file.
SHIFT       R:       Refreshes data displyed in editor window.
ALT         X:       Exit INITOR.
           F1:       Help window is displayed.
SHIFT   SPACE:       Edit selected application in HEX window.
        SPACE:       Edit selected application in ASCII window.
SHIFT  INSERT:       Add key to selected application.
       INSERT:       Add application to current INI file.
SHIFT  DELETE:       Delete current key selected (Question box appears).
       DELETE:       Delete current application selected.
                     (Question box appears).
          TAB:       Switch between application and key window.

The keys are displayed on the menus as well.


SPLIT AND UNSPLIT KEYS:
~~~~~~~~~~~~~~~~~~~~~~~
There is a limitation of how many bytes one can display in a dialog box.
This is set to 32K. However, the HEX editor needs fo each byte used 3 bytes
to display the entity. 32K / 3 > 10500bytes.

Therefore if you need to edit a key which is larger than 10500 bytes you
need to split the key first. Using the SPLIT item from the MISC MENU will
split the key into 8000 byte chunks, with the last being the remainder
of the key, hence a 19396 byte long key is split into 2x8000 and 1x3396.
You need to place the cursor on the key to be split.

Using the UNPLIT option will put the keys together again. If you have edited
one of the split keys this will produce a larger key or smaller key than
the original one, depending on what you have done with the split keys.

Consider the unsplit key is called "testing" and its 19396 long.
than the split keys are called and sized:

     testing_Initor SplitKey_1, 8000
     testing_Initor SplitKey_2, 8000
     testing_Initor SplitKey_3, 3396

Please leave the names until you unsplit them otherwise the program has no
way to find out which key is split and which of the keys belong together.
When unsplitting the cursor must be placed on the first key to unsplit.


HELP:
~~~~~
Help is diplayed by using Help on the menu.


NOTE:
~~~~~
Note that this editor was written with speed in mind. I am looking 
after a few systems (LanServer 4.0 etc) and needed a quick INI editor 
to change a few settings to make a few applications "behave" a little better. 
I got frustrated with LOTUS INI editor because it doesn't remember the last 
path, screen location and comes up with this box at startup telling you its 
dangerous to change something in you INI files (dont we all know?????).
So I wrote this one and use it (and a few friends too) nearly every day.
An I left out a few things to make this program faster to work with
and not have to press too many buttons.


TEST INI FILE:
~~~~~~~~~~~~~~
I have included a test INI file which you can load an try out a few things 
before you want to change the "real" ones. It has a number of applications,
keys and key data in it. The file is taken from my LOTUS AmiPro.
It is the "AMIUSER3.INI" files which contains all the setttings of a user.
The first APPLICATION is the "AMIUSER" in that file.
A KEY is for example the "BACKUPPATH" and the KEYDATA is "H:\AMIPRO\TMP"
(AmiPro's direcotry on my machine is on "H").
Try a few things here and you get the idea.

You could test run INITOR'S INI file. Dont worry if you changed something 
incorrectly. Simply resave in that case.
