home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 11 Util
/
11-Util.zip
/
initl110.zip
/
English.inf
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1999-12-23
|
51KB
|
1,436 lines
ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
INI tools (formerly known as INIedit ) is an INI editor for binary OS/2 INI and
plain-text WIN INI files with integrated tools to compare INI files and search
multiple files for a string.
Features :
Language support
Language support for English, Croatian, French, German, Russian, Spanish,
Traditional Chinese and Polish.
Translation tool
Translation tool (Translat.exe) enables you to add your Language support
to INI tools.
Configurable Toolbar
Display or hide Toolbar in INI editor.
OS/2->WIN and WIN->OS/2
Save OS/2 (binary) INI files as WIN (plain-text) INI files and vice
versa.
Rexx script
Current INI file can be used as template for Rexx script to create new
INI file.
Safe Mode
In Safe Mode, file can't be changed or deleted.
Compare files
Compare files and write result to new INI, Rexx script and report
Find and replace
Found Value in multiple files can be replaced with new Value.
Change data between files and programs
Cut/copy Values to Clipboard, and paste from Clipboard. Export/import
Applications, Keys and Values to/from file TRANSFER.INI.
New in Version 1.10 (1999-12-23)
Translation tool (Translat.exe) enables you to add your Language support
to INI tools.
SPANISH Language support
TRADITIONAL CHINESE Language support
POLISH Language support
Edit WIN (plain-text) INI files
Save OS/2 (binary) INI files as WIN (plain-text) INI files and vice
versa.
Fixed bugs while running under Object Rexx
Improved Install/UnInstall program
CAUTION:
CHANGES ARE WRITTEN TO INI FILES IMMEDIATELY. Here is NO UNDO function. Wrong
entries can cause serious problems !
If you are not sure what you are doing, do nothing !
Related Topics :
Installation INI editor
Settings INI compare
Change data between files INI find
How to get help WIN INI files
Explanation of terms Translation tool
ΓòÉΓòÉΓòÉ 1.1. Change data between files ΓòÉΓòÉΓòÉ
To change data between files and programs, you can :
Cut and copy Values to Clipboard, paste from Clipboard
You can cut or copy Values to Clipboard in ASCII and HEX edit in INI
editor. Clipboard contents can be used in ASCII and HEX editing of other
Value, or in INI find as search string.
Export to / Import from TRANSFER.INI
When you edit INI file, you can select Application (with all it's Keys
and Values) or Key (with Value) and export to file TRANSFER.INI.
You can export search result (found in Value) in INI find, and compared
Value in INI compare to file TRANSFER.INI, too.
You can import selected Application (with all it's Keys and Values) or
Key (with Value) from file TRANSFER.INI to currently opened INI file.
Note: file TRANSFER.INI is created in INI tools working directory. All
exports are written to this file. When it grows, you can delete
it. It will be created next time when needed.
ΓòÉΓòÉΓòÉ 1.2. How to get help ΓòÉΓòÉΓòÉ
1. Status line
Most of windows and dialogs in INI tools have status line in the
bottom of dialog. If you move pointer over control (button,
checkbox, radio button, list, entry field ...), you'll see short
description of action you can perform if you press this control.
If program does some action and needs more time (scanning drive(s),
writing report, INI file or Rexx script ...), process is shown in
status line, too.
Note: all messages in status line are translated and included in
Language support
2. Manual
Detailed explanation and instruction about INI tools can be found in
this manual.
Colors and styles used in manual :
Bold - title, some important information ...
Blue - link to related topic in this manual
Red - warning, caution
Pink - button or other control that should be selected to
do described action
Note: Manual is available only in ENGLISH. If you want to translate
this manual, it's source file (English.ipf) is in
subdirectory Bitmap.
3. Contacting the author
If you need more help, and can't find it here, or you think some
important information is missing in this manual, contact me.
ΓòÉΓòÉΓòÉ 2. Installation ΓòÉΓòÉΓòÉ
REXX MUST BE INSTALLED ON YOUR SYSTEM TO RUN THIS PROGRAM.
Files in archive initool110.zip :
INIedit.exe INI editor - program required!
INIcomp.exe INI compare - program required!
INIfind.exe INI find - program required!
Install.exe Install / UnInstall program required!
FastIni.dll Library for fast acces to INI files required!
INSTALL.INI Install / UnInstall INI file required!
ENGLISH.INI English langage support for INI tools required!
Translat.exe Translation tool - program
INIedit.ico Icon for INI editor program
INIcomp.ico Icon for INI compare program
INIfind.ico Icon for INI find program
Install.ico Icon for Install / UnInstall program
Translat.ico Icon for Translation tool
Folder1.ico Icon for INI tools folder (closed)
Folder2.ico Icon for INI tools folder (opened)
English.inf Manual for INI tools (English)
English.ipf Source file for manual for INI tools (English)
CHINESE.INI Traditional Chinese langage support for INI tools
CROATIAN.INI Croatian langage support for INI tools
FRENCH.INI French langage support for INI tools
GERMAN.INI German langage support for INI tools
POLISH.INI Polish langage support for INI tools
RUSSIAN.INI Russian langage support for INI tools
SPANISH.INI Spanish langage support for INI tools
Bitmap.zip Bitmaps used by INI editor
Unzip files from archive initool110.zip (Bitmap.zip is unzipped by Install
program) and copy them to the directory you want, start Install / UnInstall
program (Install.exe) and select action :
Install or UnInstall.
Note: if you try to run any of INI tools (INI editor, INI compare, INI find)
before installation, Install / UnInstall program will start.
DO NOT unzip archive in ROOT DIRECTORY!
Related Topics :
Install
UnInstall
ΓòÉΓòÉΓòÉ 2.1. Install ΓòÉΓòÉΓòÉ
After you pressed Install button, you'll see Copyright notice, License
agreement and Disclaimer. Read this carefuly and press I agree button if you
want to install INI tools.
Install procedure will do following :
add some entries in USER (OS2.INI) file,
create INI tools folder on Desktop, and INI tools program objects in
folder,
associate INI editor with INI files
When you are ready, press Start Install button.
You can install INI toos:
to suggested directory (c:\INItools),
to current directory - where you started Install program (press Current
button),
to other drive/directory (press Other button, then select
drive/directory),
to new directory (enter name for new directory - Install program will
create new directory and copy files to this directory).
Warning: Install program can create only ONE directory - for example: you
can create c:\Newdir, but not c:\Newdir1\Newdir2.
DO NOT select Installation directory in ROOT DIRECTORY!
Note: If Install program find files in directory where you want to install
INI toos, they will be OVERWRITTEN. Install procedure will create file
INITOOLS.INI in directory where you installed INI tools. Default
settings will be written to this file.
if you copied or moved INI tools to a new drive / directory, start Install /
UnInstall program again, and select Install. Program will write new entries in
USER (OS2.INI) file, and refresh objects on Desktop.
Related topics :
UnInstall
Settings
ΓòÉΓòÉΓòÉ 2.2. UnInstall ΓòÉΓòÉΓòÉ
If you don't like INI tools and want to remove files from your computer, start
Install / UnInstall program and select UnInstall . When you finish this
procedure, you can delete all files from directory where you installed INI
tools.
Warning: Do not remove files without UnInstall procedure.
If you did it, remove following Keys from USER (OS2.INI) file, in Application
ToolsByGoran :
INItoolsWorkDir
INItoolsINIfile
INItoolsVersion
Related topics :
Install
ΓòÉΓòÉΓòÉ 3. Settings ΓòÉΓòÉΓòÉ
After you installed INI tools, start INI editor and configure INI tools. Open
Settings submenu from PullDown menu (press Alt-S and select Settings ), or
press button, to open Settings dialog. :
Open Files via FileList
You can open file via FileList or standard FileOpen dialog.
Note: this option has effect in INI editor and INI compare. Files in INI
find can be selected only via FileList.
Display toolbar
You can select to display or hide Toolbar in INI editor.
Safe mode (no edit)
If you select Safe mode, INI files can not be created, changed or
deleted.
Note: If Safe mode is ON, following menu items and buttons are disabled:
File : New, Save and Delete menu items and buttons in main
Toolbar
Application : all menu items and buttons in Application Toolbar
Key : all menu items and buttons in Key toolbar
In INI find Replace option is disabled for found Value(s).
Size of INI editor
You can select width of main INI editor's dialog between 500 and 900
pixels, and height of main INI editor's dialog between 450 and 700
pixels.
Note: selected width and height is used in ALL programs and dialogs.
Save position on exit
You can select to save position of INI tools on exit.
Note: if selected, ALL programs will save their position on exit.
Fonts
Press Open Font Palette button and drag and drop selected font on Font
area (blue text on white background). Select Proportional font (default
font used in INI tools) and Monospaced font (used in HEX display).
Note: selected fonts are used in ALL INI tools.
Language
You can select one of available Languages from list.
Note: selected Language support is used in ALL INI tools
When you finished with changes, press Save settings NOW button. Program will
load new settings. Then you can press Return button to close Settings dialog.
If something goes wrong, or you just don't like new settings, press Default
settings button.
Related topics :
Default settings
ΓòÉΓòÉΓòÉ 3.1. Default settings ΓòÉΓòÉΓòÉ
Install procedure creates file INITOOLS.INI in directory where you installed
INI tools. Default settings are written to this file :
Open Files via FileList Checked (open via FileList)
Display toolbar Checked (display Toolbar)
Safe mode (no edit) Checked (Safe mode is ON)
Size of INI editor Width - 500 pixels, height - 450 pixels
Save position on exit Checked (programs save their position on exit)
Fonts Proportional - 9.WarpSans, Monospaced -
10.System VIO
Language ENGLISH
ΓòÉΓòÉΓòÉ 4. INI editor ΓòÉΓòÉΓòÉ
You can start INI editor :
1. From Desktop :
a. Double-click on INI editor icon
b. Drag and drop object (INI file) on INI editor icon
c. Double click on INI file
2. From command line :
a. INIedit.exe
b. INIedit.exe File (where File is INI file you want to edit)
Note: If you start INI editor without parameter (as described in 1.a. and
2.a.), INI editor will open the USER INI file (usually \OS2\OS2.INI) as
default INI file.
Main window follows hierarchical structure of INI file (left to right, and top
to bottom) :
In top left side is list of Applications in INI file, with number of
Applications in INI file and display order ( ascending, descending,
no sort).
In top right side is list of Keys in selected Application, with number of
Keys in selected Application and display order ( ascending,
descending, no sort).
In bottom side is Value of selected Key (displayed in ASCII and HEX).
Note: when you select Application or Key list (by clicking with mouse or
pressing Tab button), it's color is changed to blue text on white
background.
You can select HEX display as readable (with BLANK delimiter between chars) if
you select XX XX XX radio button, or fast HEX display (without delimiter) if
you select XXXXXX radio button. For longer Value (more than 1,000 bytes)
program needs some time to reformat display, so you should select fast HEX
display. Program can not display Values longer than 10,000 bytes at once. If
Value is longer, you'll see buttons on right side with numbers (1-10000,
10001-20000, 20001-30000 ...). Press button to see next or previous group.
Related Topics :
FileList
Menu
Toolbar
File operations
WIN INI files
Application operations
Key operations
Settings
ΓòÉΓòÉΓòÉ 4.1. FileList ΓòÉΓòÉΓòÉ
If you selected Open Files via FileList in Settings dialog, then you can create
list of INI files on your drive(s).
First time you start INI editor, FileList is empty. To create FileList, select
drive(s) you want to scan and press Scan drive(s) and rebuild List button. If
you want to scan all drives, press Scan all drives button.
If you want to see all (OS/2 and WIN) INI files in FileList, select Show ALL
INI files. Otherwise, to see only OS/2 INI files select Show only OS/2 INI
files.
You can access to system files (if you press USER (OS2.INI), SYSTEM
(OS2SYS.INI) or BOTH button), without searching them in the list. To open other
file, select it and press Open button, or double-click on selected file. If you
created new, copied, moved or deleted INI file(s), rescan FileList.
Note: even if you don't want to use FileList in INI editor or INI compare, you
have to create FileList, to use it in INI find.
Related Topics :
Settings
ΓòÉΓòÉΓòÉ 4.2. Menu ΓòÉΓòÉΓòÉ
Following menu items in INI editor are in ENGLISH Language. If you selected
other Language support, text for menu items will be different.
File menu (press Alt-F )
New Create new INI file
Open Open INI file for editing (submenu)
USER (OS2.INI) Open the USER INI file
(usually \OS2\OS2.INI).
SYSTEM (OS2SYS.INI) Open the SYSTEM INI file
(usually \OS2\OS2SYS.INI).
BOTH For querying invocations,
both the USER and SYSTEM INI
files will be searched. For
setting invocations, the
USER INI file will be
written to.
Other Open other INI file
Save Save INI file
OS/2->WIN Save current OS/2 INI file as WIN INI file
Info Show Information about INI file
Delete Delete INI file
Rexx script Write Rexx script to create INI file - use current file as
template
Exit Exit INI editor
Note: if Safe mode is ON, New, Save and Delete menu items are DISABLED.
Application menu (press Alt-A , or double-click on selected Application)
New App Create new Application
Copy App Copy selected Application (with all it's Keys and Values)
to other Application in this file (change Application
name)
Delete App Delete selected Application (with all it's Keys and
Values)
Export App Export selected Application (with all it's Keys and
Values) to file TRANSFER.INI
Import App Import Application from file TRANSFER.INI
Sort Sort Applications in list (submenu)
Ascending - Sort Applications in ascending
order
Descending - Sort Applications in descending
order
No sort - Don't sort Applications
Note: if Safe mode is ON, all Application menu items are DISABLED.
Key menu (press Alt-K , or double-click on selected Key)
New Key Create new Key
Copy Key Copy selected Key to other Key in this Application (change
Key name)
Copy to App Copy selected Key to other Application in this file
Edit Key Edit selected Key's Value (in ASCII mode)
HEXedit Key Edit selected Key's Value (in HEX mode)
Delete Key Delete selected Key
Export Key Export selected Key to file TRANSFER.INI
Import Key Import Key from file TRANSFER.INI
Sort Sort Keys in list (submenu)
Ascending - Sort Keys in ascending order
Descending - Sort Keys in descending order
No sort - Don't sort Keys
Note: if Safe mode is ON, all Key menu items are DISABLED.
Tools menu (press Alt-T )
Compare Start INI compare
Find Start INI find
Settings menu (press Alt-S)
Settings Configure INI tools (open Settings dialog)
Safe mode ON Set safe mode to ON (editing is disabled)
Safe mode OFF Set safe mode to OFF (editing is enabled)
Show Toolbar Show Toolbar
Hide Toolbar Hide Toolbar
Help menu (press Alt-H)
INI editor Show help for INI editor
INI tools Show general help for INI tools
ΓòÉΓòÉΓòÉ 4.3. Toolbar ΓòÉΓòÉΓòÉ
Note: all bitmaps used in INI editor's Toolbar are stored in \Bitmap
subdirectory. You can use your own bitmaps if you want. To do this :
1. create your own bitmaps - size MUST be 24 x 24,
2. bitmaps MUST have exact names as existing bitmaps,
3. replace existing bitmaps in \Bitmap subdirectory with new bitmaps.
INI editor's main toolbar :
Create new INI file
Open INI file for editing
Save selected file
Save current OS/2 INI file as WIN INI file
Information about selected file
Write Rexx script - use selected file as template
Delete selected file
Note: if Safe mode is ON, New, Save and Delete buttons are DISABLED.
Set Safe mode to ON (editing is disabled)
Set Safe mode to OFF (editing is enabled)
Configure INI tools (open Settings dialog)
Show help
Hide Toolbars
Exit INI editor
Start INI compare
Start INI find
Application's toolbar :
Create new Application
Copy selected Application (with all it's Keys and Values) to new Application
in this file
Export selected Application (with all it's Keys and Values) to file
TRANSFER.INI
Import Application from file TRANSFER.INI
Delete selected Application (with all it's Keys and Values)
Note: if Safe mode is ON, all Application buttons are DISABLED.
Key's toolbar :
Create new Key
Copy selected Key to new Key in this Application
Copy selected Key to other Application in this file
Edit selected Key's Value - ASCII
Edit selected Key's Value - HEX
Export selected Key to file TRANSFER.INI
Import Key from file TRANSFER.INI
Delete selected Key
Note: if Safe mode is ON, all Key buttons are DISABLED.
ΓòÉΓòÉΓòÉ 4.4. File operations ΓòÉΓòÉΓòÉ
To perform file operations you can select operation from PullDown menu (press
Alt-F to open file submenu), or press operation button in INI editor's main
toolbar.
When you edit WIN INI files, there are some specific options and limitations
(see WIN INI files sections for more details).
New
Create new INI file. File must have at least one Application, each
Application must have at least one Key, and each Key must have a Value.
When creating new file, INI editor writes one Application, Key, Value to
new file.
Open
Open another INI file for editing. File can be opened via FileList or
standard FileOpen dialog. You can open USER (OS2.INI), SYSTEM
(OS2SYS.INI) and BOTH INI files without scrolling FileList or searching
files.
Save
Save INI file - you can change file name and save opened INI file under
new name.
OS/2->WIN
Save current OS/2 INI as WIN INI file - press this button after you
finished editing of WIN INI file.
Info
Show some Information about current INI file - file name, path, size (in
bytes), last change date and time, file attributes, total number of
Applications and Keys in file.
Delete
Delete current INI file. USER and SYSTEM INI files can't be deleted (in
fact, they can be deleted, but INI editor doesn't allow to do this).
Rexx script
Write Rexx script to create INI file - use all Values from current file.
Later, you can run this Rexx script and create identical INI file as
current.
Exit
Exit INI editor.
Related Topics :
Settings
Menu
Toolbar
WIN INI files
ΓòÉΓòÉΓòÉ 4.5. Application operations ΓòÉΓòÉΓòÉ
To perform Application operations you can select operation from PullDown menu
(press Alt-A to open Application submenu), or double-click on selected
Application in Application list, or press operation button in Application
toolbar.
Note: if Safe mode is ON, all Application operations are DISABLED.
New Application
Create new Application. Each Application must have at least one Key, and
each Key must have a Value. When creating new Application, INI editor
writes one Application, Key, Value.
Copy Application
Copy selected Application to other Application in this file (change
Application name) with all it's keys and Values
Delete Application
Delete selected Application with all it's keys and Values
Export Application
Export selected Application to file TRANSFER.INI with all it's keys and
Values
Import Application
Import Application from file TRANSFER.INI
Sort Applications in list (submenu) - available only via PopUp menu
Sort Applications in ascending order
Sort Applications in descending order
Don't sort Applications
Note: Applications are only sorted for display - no changes are written
to INI file.
ΓòÉΓòÉΓòÉ 4.6. Key operations ΓòÉΓòÉΓòÉ
To perform Key operations you can select operation from PullDown menu (press
Alt-K to open Key submenu), or double-click on selected Key in Key list, or
press operation button in Key toolbar.
Note: if Safe mode is ON, all Key operations are DISABLED.
New Key
Create new Key. Each Key must have a Value. When creating new Key, INI
editor writes one Key, Value in current Application.
Copy Key
Copy selected Key and it's Value to other Key in this Application (change
Key name)
Copy to App
Copy selected Key and it's Value to other Application in this file
Edit Key
Edit selected Key's Value (in ASCII mode). See Edit Value topic for more
information.
HEXedit Key
Edit selected Key's Value (in HEX mode). See Edit Value topic for more
information.
Delete Key
Delete selected Key and it's Value
Export Key
Export selected Key and it's Value to file TRANSFER.INI
Import Key
Import Key from file TRANSFER.INI
Sort Keys in list (submenu) - available only via PopUp menu
Sort Keys in ascending order
Sort Keys in descending order
Don't sort Keys
Note: Keys are only sorted for display - no changes are written to INI
file.
Related Topics :
Edit Value
ΓòÉΓòÉΓòÉ 4.6.1. Edit Value ΓòÉΓòÉΓòÉ
Warning: INI editor CAN NOT EDIT Value longer than 10,000 bytes.
When you select Key, in bottom side of INI editor's main window is displayed
Value in ASCII and HEX. If Value has NULL byte ['00'x], you'll see text NULL in
top right corner of ASCII display.
Edit Value - ASCII
If you select Edit from PopUp menu, or press button, Edit dialog is opened. In
Title bar is displayed Key name (with NULL! text if Value has NULL byte
['00'x]. If Value has NULL byte ['00'x], it is changed to BLANK byte ['FF'x] in
ASCII display). You can:
Delete Value (if you delete Value, and press OK button, Key will be
deleted too)
Cut Value to Clipboard (Value is deleted)
Copy Value to Clipboard
Paste Value from Clipboard - it's added at the end of existing Value
Note: if you want to replace existing Value with Value from Clipboard,
press Delete button, then Paste button.
When finished with editing, press OK to save changes, or Cancel button to
close Edit dialog without saving changes.
Note: if you select Trailing NULL , NULL byte ['00'x] will be added at the
end of Value.
CAUTION:
if Value has NULL byte ['00'x], it is changed to BLANK ['FF'x] in editing in
ASCII mode. Changed Value will be saved (except trailing NULL). It is
RECOMMENDED to edit Value in HEX mode, if it has NULL byte!
Edit Value - HEX
If you select HEX edit from PopUp menu, or press button, Edit dialog is
opened. In Title bar is displayed Key name. On top side is Value displayed in
ASCII. On right side is list with ASCII and HEX Values (to help you in HEX
editing). You can:
Delete Value (if you delete Value, and press OK button, Key will be
deleted too)
Cut Value to Clipboard (Value is deleted)
Copy Value to Clipboard
Paste Value from Clipboard - it's added at the end of existing Value
Note: if you want to replace existing Value with Value from Clipboard,
press Delete button, then Paste button.
Refresh Value, without writing changes
Reset changes and display original (loaded) Value
When finished with editing, press OK to save changes, or Cancel button to
close HEX edit dialog without saving changes.
Related Topics :
Key operations
ΓòÉΓòÉΓòÉ 5. INI compare ΓòÉΓòÉΓòÉ
Colors used in program :
RED 1st INI file (and Applications, Keys and Values in Notebook)
GREEN 1st INI file (and Applications, Keys and Values in Notebook)
BLUE IDENTICAL Applications, Keys and Values in Notebook
INI compare is tool to compare two INI files. To compare files :
1. Select 1st INI file and 2nd INI file (ONLY OS/2 (binary) INI!) , via
FileList or standard FileOpen dialog (options can be changed by INI
editor).
2. Press Compare button.
After comparison is finished, you'll see Notebook with following pages :
Write write INI file and/or Rexx script; Write Report
Application(s) list of compared applications (in 1st and 2nd INI file,
identical)
Key(s) list of compared keys in selected application (in 1st and
2nd INI file, identical)
Value Value in 1st and 2nd INI file (ASCII and HEX)
Related Topics :
Comparison result
Write INI and/or Rexx
Write Report
Change data between files
ΓòÉΓòÉΓòÉ 5.1. Comparison result ΓòÉΓòÉΓòÉ
After comparison is finished, you'll see Notebook with following pages :
Write write INI file and/or Rexx script; Write Report
Application(s) list of compared Applications (in 1st and 2nd INI file,
identical). Go to Key(s) page and select one of identical
Applications, to see Keys in 1st and 2nd INI file and
identical Keys.
Key(s) list of compared Keys in selected Application (in 1st and
2nd INI file, identical). Go to Key(s) page and select one
of identical Keys, to see Value in 1st and 2nd INI files.
Value Value in 1st and 2nd INI file (ASCII and HEX). Values are
displayed in ASCII and HEX.
Note: you can export Value from 1st or 2nd file to file
TRANSFER.INI.
Related Topics :
Write INI and/or Rexx
Write Report
ΓòÉΓòÉΓòÉ 5.2. Write INI and/or Rexx ΓòÉΓòÉΓòÉ
You can write comparison result to INI file and/or Rexx script. Default name is
COMPARE. You can change name (without extension please - program adds INI or
CMD). Options are:
Application(s)
ALL Write ALL Applications from 1st and 2nd file to new file.
IDENTICAL Write Applications contained in 1st AND 2nd file.
1st INI file Write only Applications contained in 1st file but NOT in 2nd
file (unique Applications in 1st file).
- when you select this options, only Keys and Values from 1st
file are written to new file
2nd INI file Write only Applications contained in 2nd file but NOT in 1st
file (unique Applications in 2nd file).
- when you select this options, only Keys and Values from 2nd
file are written to new file
Key(s)
ALL Write ALL Keys from 1st and 2nd File Application to new
file.ew file.
IDENTICAL Write Keys contained in 1st AND 2nd File Application.
1st INI file Write only Keys contained in 1st File Application but NOT in
2nd File Application (unique Keys in 1st File Application).
- when you select this options, only Value from 1st File
Application Key are written to new file
2nd INI file Write only Keys contained in 2nd File Application but NOT in
1st File Application (unique Keys in 2nd File Application).
- when you select this options, only Value from 2nd File
Application Key are written to new file
Value
1st INI file Write Value from 1st file
2nd INI file Write Value from 2nd file
UNIQUE Write only Value unique for 1st File Application Key (if
1st INI file radio button in Value frame is selected), or Value
unique for 2nd File Application Key (if 2nd INI file radio
button in Value frame is selected).
If this checkbox is unselected, Value for every Key is written,
even if they are identical or different.
When you selected options, press Write INI button to write new INI file, or
press Write Rexx to write Rexx script. Files are written to INI tools working
directory, unless you select another directory.
Warning: if this INI file or Rexx script already exists, it will be
OVERWRITTEN without warning.
Related Topics :
INI compare - example 1
INI compare - example 2
INI compare - example 3
ΓòÉΓòÉΓòÉ 5.2.1. INI compare - example 1 ΓòÉΓòÉΓòÉ
If you are going to install some program and want to see does it make changes
to USER (OS2.INI) file, do this :
1. Make copy of OS2.INI file (to OS2OLD.INI)
2. Install new program
3. Start INI compare
4. Select OS2.INI as 1st INI file and OS2OLD.INI as 2nd INI file
5. Press Compare button and wait until Notebook appears.
6. First, check does program add new Application(s) to OS2.INI :
a. Select 1st INI file radio button in Application(s) frame. IDENTICAL
buttons will be selected in Key(s) and Value frames.
b. Press Write INI button.
c. Press OK button when Message box appears to open new INI file with
INI editor.
If new INI file contains any Application, this is new Application
written to OS2.INI when you installed program.
7. Second, check does program add new Key(s) to existing Application(s) in
OS2.INI :
a. Select IDENTICAL radio button in Application(s) frame.
b. Select 1st INI file radio button in Key(s) frame. IDENTICAL button
will be selected in Value frame.
c. Press Write INI button.
d. Press OK button when Message box appears to open new INI file with
INI editor.
If new INI file contains any Key in Application(s), this is new Key
written to existing Application(s) in OS2.INI when you installed
program.
8. Third, check does program change existing Key(s) in existing
Application(s) in OS2.INI :
a. Select ALL radio button in Application(s) frame.
b. Select ALL radio button in Key(s) frame.
c. Select 1st INI file radio button in Value frame.
d. Select UNIQUE checkbox in Value frame.
e. Press Write INI button.
f. Press OK button when Message box appears to open new INI file with
INI editor.
If new INI file contains any Key in Application(s), this is changed
Key in existing Application(s) in OS2.INI when you installed
program.
Related Topics :
INI compare - example 2
INI compare - example 3
Write INI and/or Rexx
ΓòÉΓòÉΓòÉ 5.2.2. INI compare - example 2 ΓòÉΓòÉΓòÉ
If you want to see identicall Applications and Keys in files USER (OS2.INI) and
SYSTEM (OS2SYS.INI), do this :
1. Start INI compare
2. Select OS2.INI as 1st INI file and OS2SYS.INI as 2nd INI file
3. Press Compare button and wait until Notebook appears.
4. Select IDENTICAL radio button in Application(s) frame.
5. Select IDENTICAL radio buttonin Key(s) frame.
6. Select 1st INI file radio button in Value frame.
7. Press Write INI button.
8. Press OK button when Message box appears to open new INI file with INI
editor.
New INI contains identical Applications and Keys in both files, with
Values from OS2.INI file.
Related Topics :
INI compare - example 1
INI compare - example 3
Write INI and/or Rexx
ΓòÉΓòÉΓòÉ 5.2.3. INI compare - example 3 ΓòÉΓòÉΓòÉ
If you want combine new INI file from files USER (OS2.INI) and SYSTEM
(OS2SYS.INI), like when you open BOTH in INI editor, do this :
1. Start INI compare
2. Select OS2.INI as 1st INI file and OS2SYS.INI as 2nd INI file
3. Press Compare button and wait until Notebook appears.
4. Select ALL radio button in Application(s) frame.
5. Select ALL radio buttonin Key(s) frame.
6. Select 1st INI file radio button in Value frame (to write Value from
OS2.INI).
7. Press Write INI button.
8. Press OK button when Message box appears to open new INI file with INI
editor.
New INI contains identical Applications and Keys in both files, with
Values from OS2.INI file.
Related Topics :
INI compare - example 1
INI compare - example 2
Write INI and/or Rexx
ΓòÉΓòÉΓòÉ 5.3. Write Report ΓòÉΓòÉΓòÉ
You can write comparison result to Report. Default name is Compare.rpt. You can
change name. Options are:
ASCII Write ASCII Values to Report
HEX Write HEX Values to Report
Long report Write detail Report :
- all Applications in 1st file, all Applications in 2nd
file, identical Applications
- all Keys in 1st File Application, all Keys in 2nd File
Application, identical Keys
- Value in 1st File Application Key, Value in 2nd File
Application Key
Short Report Write compact Report :
- identical Applications
- identical Keys in identical Applications
- Value in 1st File Application Key, Value in 2nd File
Application Key
When you selected options, press Write Report button to write new report.
Files are written to INI tools working directory, unless you select another
directory.
Warning: if new Report exists, it will be OVERWRITTEN without warning.
ΓòÉΓòÉΓòÉ 6. INI find ΓòÉΓòÉΓòÉ
INI find is a tool to search multiple files for a string. To use INI find, do
this :
1. Select file(s) from FileList and add to SearchList (double-click or press
Add to list button to add file). If you want to add all files to
SearchList, press Add all button.
Note: to refresh FileList, you have to use INI editor.
2. Write string you want to find (or Paste from Clipboard). If you want to
write new string, press Reset button, to delete ASCII and HEX entry
fields. Press Refresh button to convert ASCII to HEX display and vice
versa.
3. Select search criteria (Example : if you want to find test string) :
Exact match - search for string (exact match) in Applications, Keys and
Values
- string will be found only in test , but not in Test, testing,
mytest.
Partial (leading chars) - search for string (leading chars) in
Applications, Keys and Values
- string will be found in test , test ing, but not in Test,
mytest.
Partial (anywhere) - search for string anywhere in Applications, Keys and
Values
- string will be found in test , test ing, my test , but not in
Test.
Warning: Search is allways cAsE sensitive!
4. Press Find button.
Related Topics :
Search result
Found Values
Replace string
Change data between files
ΓòÉΓòÉΓòÉ 6.1. Search result ΓòÉΓòÉΓòÉ
After searching is finished, you'll see Notebook with following pages :
Help
Application(s)
Key(s)
Value(s)
Note: Application(s), Key(s), Value(s) pages are visible, only if some of
them are found.
On help page you can see some statistics :
Number of files and search time (in seconds)
Number of found Applications, Keys and Values
To create report with all found Applications, Keys and Values, press Write
button. Default name for report is Found.rpt and it will be written in current
directory. You can change this and enter new path and filename.
On next pages are lists with found Applications, Keys and Values in format :
drive : \path\file found Applications (if
search criteria = exact
match)
drive : \path\file Application found Applications (if
search criteria = partial)
drive : \path\file Application found Keys (if search
criteria = exact match)
drive : \path\file Application Key found Keys (if search
criteria = partial)
drive : \path\file Application Key found Values (if search
criteria = exact match)
drive : \path\file Application Key Value found Values (if search
criteria = partial)
Note: Go to 1st (Help) page and press Return button to close Notebook and go
back to program.
Related Topics :
Found Values
Replace string
ΓòÉΓòÉΓòÉ 6.2. Found Values ΓòÉΓòÉΓòÉ
You can select any of Values from list and press Copy to TRANSFER.INI button.
Selected Application Key Value will be copied to TRANSFER.INI, and you can
use it with INI editor to import it into other INI file.
If you selected Exact match in search criteria, found Value(s) can be replaced
with new Value in selected File Application Key. If you press Replace
button, only Value in selected line will be replaced with new Value. If you
press Replace All button, all found Values will be replaced with new Value.
Note: this option is available only if Safe mode is set to OFF.
Related Topics :
Replace string
Change data between files
ΓòÉΓòÉΓòÉ 6.3. Replace string ΓòÉΓòÉΓòÉ
Note: this option is available only if Safe mode is set to OFF.
If you selected Exact match: in search criteria, found Value(s) can be
replaced with new Value in selected File Application Key. If you pressed
Replace button, only Value in selected line will be replaced with new Value.
If you pressed Replace All button, all found Values will be replaced with new
Value.
When new dialog opens, write new Value in ASCII or HEX format (you can also
Paste Value from Clipboard). Then press Refresh button. If you are absolutely
sure press Replace button. If you pressed Replace button in previous dialog,
only Value in selected line will be replaced with new Value. If you pressed
Replace All button in previous dialog, all found Values will be replaced with
new Value.
CAUTION:
Use this options with extreme care. Here is no Undo function.
ΓòÉΓòÉΓòÉ 7. WIN INI files ΓòÉΓòÉΓòÉ
WIN INI files are used with most of WIN-OS/2 (and some of OS/2) programs. WIN
INI file is plain-text file with following structure:
Lines beginning with [ and ending with ] are Applications (also called
Sections). For example: [Section]
Character = is separator between key and value in line. For example:
Key=Value. All lines with key and value between Application (Section) and
next Application (Section) or end of file are part of this Application
(Section).
Lines beginning with ; are comments and program does not read application
(section), key or value in this line.
If you want to open WIN INI file via FileList, select Show ALL INI files
radiobutton in FileList dialog.
To view/edit WIN INI file, INI editor converts it to OS/2 INI file (it's name
is WIN__OS2.INI and it is always saved in INI tools working directory). All
changes are written to WIN_OS2.INI file.
You can do all actions on this file as on any other INI file (copy, write Rexx
script, create new, copy, delete, export, import applications and keys, edit
keys ...).
When displayed, applications (sections) and keys are not sorted - they are
displayed in order as in file.
When you view/edit WIN INI files here are some limitations:
1. Lines beginning with comment ; in WIN INI files are lost. Commented keys
and values (for example: ;Key=Value) can be edited as normal keys and/or
values (Key=Value).
2. Only when key and value are in ONE line, INI editor can read it
correctly.
3. To save changes in original WIN INI file, you have to convert it to
OS2_WIN.INI file (in INI tools working directory). To do this select
OS/2->WIN item in File menu, or press button. Then you can copy
OS2_WIN.INI file to original WIN INI file. If there is NULL byte ['00'x]
in value, it is converted to BLANK byte ['FF'x].
Note: you have to copy manually OS2_WIN.INI to original WIN INI file.
Related Topics :
INI editor
File operations
ΓòÉΓòÉΓòÉ 8. Translation tool ΓòÉΓòÉΓòÉ
Language support for INI tools (buttons text, messages, frames text ...) is
stored in Language INI files (ENGLISH.INI, GERMAN.INI, etc.) and source of help
file (this file - English.inf) is file English.ipf in subdirectory Bitmap.
You can translate INI tools to your language (or correct some phrases in
existing Language INI file) with Translation tool (Translat.exe).
To create new Language INI file:
1. Select source language (one of languages in the list).
2. Press New language! button, to create new language file. SOURCE LANGUAGE
will be copied to new language file.
3. Enter language name, comment, your name and email adress (REQUIRED!).
Then press OK - start translation button.
4. Sections (pages in Notebook) are: Menu, Hint, Message, Button, Frame and
Help. Overwrite text with your text.
5. When finished, select your language in program and try it.
To change existing Language INI file:
1. Select your language (as source language and your language).
2. Change comment, your name and email adress if you want, then press OK -
start translation button.
3. Sections (pages in Notebook) are: Menu, Hint, Message, Button, Frame and
Help. Overwrite existing text with your text - press Write changes button
after EVERY CHANGE.
4. When finished, select your language in INI editor and check changes.
Important!
Press Write changes button after EVERY CHANGE to save changes. If you don't
press this button and go to next item, changes WILL BE LOST!
When you create new Language INI file, program will write new Key to file
INITOOLS.INI, Application Languagewhere:
- Key name is name of new language
- Key value is "English.inf" - it is default help file for INI tools.
In section (Page) Help are stored titles of topics in English.inf and they are
used as parameter when you press Help button in INI tools. You should
translate this section only if you want to translate source help file
(English.ipf). Then items in Help section should be identical as translated
titles in new IPF/INF file.
Note: After you added new Language support to INI tools, I would appreciate
if you send me new INI file, so I can include this file in next version
of INI tools.
ΓòÉΓòÉΓòÉ 9. Translate help file ΓòÉΓòÉΓòÉ
To translate help file you need IPF compiler.
If you want to translate and compile English.ipf file, it should be in Bitmap
subdirectory, because it uses bitmaps in this directory. After you finished
translation, copy translated (and compiled) INF file to INI tools directory and
make changes Application Language.
For example:
when you translated ENGLISH to MYLANG (where MYLANG is your Language),
MYLANG.INI file is created. When you translated English.ipf to Mylang.ipf
and compile Mylang.ipf, Mylang.inf file is created.
Copy this file from Bitmap subdirectory to INI tools directory and edit
in INITOOLS.INI:
change in Application Language, Key MYLANG, Value English.inf to
Mylang.inf.
Be sure you also translated Help section in MYLANG.INI. In section (Page) Help
are stored titles of topics help and they are used as parameter when you press
Help button in INI tools. Translate this section only when you translated
source help file (English.ipf).
Note: After you translated help file, I would appreciate if you send me new
IPF/INF file, so I can include this file in next version of INI tools.
ΓòÉΓòÉΓòÉ 10. Known bugs and limitations ΓòÉΓòÉΓòÉ
OS/2 Window
INI tools executes some OS/2 commands (copy or delete temporary files
...). If you see opened OS/2 window after this, you shall select Close
window on exit checkbox in OS/2 window Settings notebook (Session page).
"Classic" vs. Object Rexx
INI tools can run under "Classic" or Object Rexx. If you have Object Rexx
installed, performance is significantly slower.
Limitations
INI editor can view/edit WIN INI files with some limitations:
- Lines beginning with comment ; in WIN INI files are lost. Commented
keys and values (for example: ;Key=Value) can be edited as normal keys
and/or (Key=Value).
- Only when key and value are in ONE line, INI editor can read it
correctly.
- To save changes in original WIN INI file, you have to convert it to
OS2_WIN.INI file (in INI tools working directory) and then save
OS2_WIN.INI file as original WIN INI file.
In ASCII and HEX edit (in INI editor) Value longer than 10,000 bytes can
not be edited.
If Value has NULL byte ['00'x], NULL byte ['00'x] is changed to BLANK
byte ['FF'x] in ASCII display - NO DATA IS CHANGED IN INI FILE.
If Value has NULL byte ['00'x], and you edit Value in ASCII mode: , NULL
byte ['00x] is changed to BLANK byte ['FF'x] - CHANGED DATA IS WRITTEN TO
INI FILE.
If Value has NULL byte, edit Value in HEX mode !
If you find bug in program, or if DrRexx screen pop up with SYNTAX ERROR
message, try this :
1. READ THE MANUAL please, maybe you'll find some useful information : -).
2. If INI editor is still running, open Settings dialog, and press Default
settings button, exit program and start it again. You will loose your
settings, but program should work.
3. If INI editor, INI compare or INI find is not running, start
Install/UnInstall program (Install.exe). Select Install from main dialog.
You will loose your settings, but programs should work.
4. Delete INITOOLS.INI file in INI tools directory and start INI editor (NOT
INI compare or INI find). Program will load default settings. You will
loose your settings, but programs should work.
5. Visit my Home page to see if there is any bug fix or update.
6. Send me a message with following:
- OS/2 Version (and FixPack) you are using,
- Rexx Version ("classic" or Object Rexx),
- INI tools Version,
- description of bug or error, and SYNTAX ERROR message from DrRexx
dialog.
I will try to help you and correct error.
ΓòÉΓòÉΓòÉ 11. Explanation of terms ΓòÉΓòÉΓòÉ
INI file
The name of the INI file which you would like to work with. OS/2 saves a big
part of its configuration in the files OS2.INI and OS2SYS.INI. Therefore, many
of the changes you might make to the WPS will involve changing some entries in
these INI files. The basic structure of OS/2 INI files is hierarchical,
consisting of the following elements and order :
1. Application
The application name or some other meaningful value with which you would
like to store keywords (some sort of data). Applications are the main
entries. Each application must have at least one Key.
2. Key
The name of a keyword which is used to hold data. Each Key must have a
Value.
3. Value
The Value to associate with the keyword of the specified application.
(Note that a lot of Values - but not all - include a trailing NULL byte
['00'x]). This byte may be needed for certain values to function
properly. It should not be discarded when values are modified.
INI file should be a file specification, or one of the following:
USER The USER INI file (usually \OS2\OS2.INI). This is the default.
SYSTEM The SYSTEM INI file (usually \OS2\OS2SYS.INI).
BOTH For querying invocations, both the USER and SYSTEM INI files will be
searched. For setting invocations, the USER INI file will be written
to.
WIN INI files
Used with most of WIN-OS/2 (and some of OS/2) programs. WIN INI file is
plain-text file with following structure:
Lines beginning with [ and ending with ] are Applications (also called
Sections). For example: [Section]
Character = is separator between key and value in line. For example:
Key=Value
Lines beginning with ; are comments and program does not read application
(section), key or value in this line.
ΓòÉΓòÉΓòÉ 12. Copyright and contact ΓòÉΓòÉΓòÉ
Author Goran Ivankovic
Address Ulica Josipa Poduje 8
HR-52100 Pula
Croatia
email duga1@pu.tel.hr
Home page http://Goran_Ivankovic.tripod.com/
INI tools is free software but it is not public domain.. The author retains
all copyright to the application and all files within it.
You may use INI tools yourself and you may distribute it to others so long as
all files are left unchanged. You may not distribute INI tools in any way
which leads to your making a profit from it. This means that you can only
charge enough to cover the costs of media, postage etc. involved in
distribution. Also you may not use it as an incentive to buy something else.
If you are in any doubt you should contact the author.
The author's permission must be obtained before INI tools is included on a
magazine disc and P.D. libraries. You should, as a matter of courtesy, inform
the author when you are planning to distribute the application and send one
copy of magazine disc to the author.
Trademarks
OS/2 is Trademark of International Bussines Machines Corporation
DrDialog is Copyright of International Bussines Machines Corporation
FastIni.dll is Copyright of Dennis Bareis - OS/2 Developer in Australia
Related Topics :
Thanks
Disclaimer
ΓòÉΓòÉΓòÉ 12.1. Thanks ΓòÉΓòÉΓòÉ
Thanks to all users for ideas, comments, suggestions and bug reports.
Special thanks to :
Franck Bouillard
Translated INI tools to French
Klaus Staedtler
Translated INI tools to German
Peter Vereshagin
Translated INI tools to Russian
Alfredo Fern╨░ndez D╨▒az
Translated INI tools to Spanish
Titus Ou
Translated INI tools to Traditional Chinese
Przemys╨ÿaw Pawe╨ÿczyk
Translated INI tools to Polish
Daniele Vistalli
Created INI editor's new bitmaps collection
ΓòÉΓòÉΓòÉ 12.2. Disclaimer ΓòÉΓòÉΓòÉ
STANDARD DISCLAIMER
The author makes no representations about the accuracy or suitability of this
material for any purpose. It is provided "as is", without any express or
implied warranties. The author will assume no liability for damages either from
the direct use of this product or as a consequence of the use of this product.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
Author Goran Ivankovic
Address Ulica Josipa Poduje 8
HR-52100 Pula
Croatia
email duga1@pu.tel.hr
Home page http://Goran_Ivankovic.tripod.com/
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
I started to develop INI editor (AKA INIedit, INIed - there was never official
name) in April 1998. with version 0.40. Last version (0.90) was released in
February 1999.
If you use (and like) this program, I hope you'll like INI tools, too.
THE FUTURE IS UNWRITTEN
(who said this ?)