Copyright: Copyright (c) 1993 Martinsen's Software


Contents
 Martinsen's Software INI Manager 2.0

To learn how to use Help, press F1.

Overview

What is INI Manager?

A Review of INI Files

New Features from 1.xx

The INI Manager Window

Ordering a copy of INI Manager

Features

INI Manager Tasks

Speed Keys

Status Bar

Toolbar

Help Version 2.00.05


What is INI Manager?

INI Manager is a program designed for novice Windows users, system administrators, and power users.  Its purpose is to provide a easy way to modify INI files without doing damage to your Windows configuration.  Since every Windows user will , at some point in time, be forced to modify one or more of their INI files, we have tried to make an application that will allow this process to go as smoothly as possible.  If things should go wrong, INI Managers extensive backup feature will protect you from the time consuming task of re-installing Windows or your individual application.  Below is a list of some of the major features implemented in INI Manager:

1.  	At startup, INI Manager will display a list of all of the INI files found in your

Windows directory.

2.  	Prior to making any changes, the current INI file will be backed up.

3.	Upon completion of any changes to the INI file, INI Manager will flush the

Windows cache of the current INI file.  This will force any applications that

depend on the INI file to reread the file, which will in fact update all applications

that use the currently selected INI file.

4.	Complete sections or single line entries can be safely deleted using the Delete

Section and Delete Key features.

We hope you enjoy this program, and we would love to hear your feedback.  You may reach us via EMAIL on America Online (RonMart), INTERNET:RonMart@aol.com or CompuServe (71202,1750).  If you do not have access to either of these service, please feel free to call or write us at:

Martinsen's Software

5501 Tullis Drive

Building 2, Suite 304

New Orleans, LA  70131

(504) 394-6045


A Review of INI Files

A Initialization file (often referred to as a INI file for the most common three character extension used by these files) is a file format used by almost all Windows applications and some DOS applications.  They usually contain startup information and user preferences for a particular application.  For example, when you click a check box in a preferences dialog box, a application may write down the status of that check box (either unchecked (0) or checked (non-zero) to an INI file.  This allows an application to "remember" the status of the check box the next time you start the application or load this dialog box.  It is with the aid of INI files that applications become "intelligent".

INI Files use the following format:

[Section]

Key=Setting

A Section represents the group of keys that relate to a particular feature.

A Key is the object or feature to which the setting applies. (i.e. IsCheckBoxChecked=0)

A Setting is the value (either text or numeric) of a key.  (i.e. LastFileOpened=C:\ME.TXT)

A Word of Caution

INI Manager is designed for INI files that have unique Sections and Keys.  Files like SYSTEM.INI  do not use unique keys (i.e. multiple "device=device.drv" lines).  On files of this nature, INI Manager will ONLY write the first occurrence of a section and key that match the specified section and key.  Using INI Manager of files with identical keys within the same section could cause corruption of your INI file.  It is therefore recommended that these entries be edited manually using either Notepad or Edit Section Dialog.

Note  INI Manager will not load device= entries into the Keys List Box.

Example of a file with identical keys within the same section:

[Section1]

Key1=Setting1

Key1=Setting2

Key1=Setting3

Example of a normal INI file:

[Section1]

Key1=Setting1

Key2=Setting2

Key3=Setting3

[Section2]

Key1=Setting1

Key2=Setting2

Key3=Setting3


New Features

Feature	Benefit

Create File	Create new INI files without leaving INI Manager.

Delete File	Delete existing INI files without leaving INI Manager.

Edit Section	Edit a section just like you would in notepad.

Multiple Document Interface	Open multiple windows at one time and exchange data from

different files.

Print	Print out your INI file with the section names in bold letters!

Search	Search an INI file for a section, key, or setting just like you

would in notepad!

Show and Edit Comments	Display, edit and create comments in your INI files.

Sort Keys	Get a listing of a section as it appears in the INI file, or

alphabetically sorted.

Speed Keys	All of your favorite features can be accessed by just pressing

a single key combination.

Toolbar	All of your favorite features are just a click away.

And much more!


INI Manager Window


Toolbar

File New Window	File Change Path

File Print	File Close Window

Edit Undo	Edit Cut

Edit Copy	Edit Paste

Edit Search	Edit Add Section

Edit Delete Section	Edit Edit Section

Edit Set Key	Edit Delete Key

File Exit


Status Bar

The status bar displays information about the object currently under the mouse pointer, and other useful information.


File Menu

Menu Item	Description

New Window	Opens a new INI Manager Window.

Close Window	Closes the currently active INI Manager Window.

Create File	Creates a new INI File.

Change Path	Changes the current directory and updates the currently active window.

Delete File	Deletes the currently active file.

Print	Prints the currently active file.

Exit	Terminate the current session of INI Manager.


Edit Menu

Menu Item	Description

Undo*	Undo (or Redo) the last action in the currently active text box.

Cut*	Cuts the selected text from the currently active text box into the clipboard.

Copy*	Copies the selected text from the currently active text box into the clipboard.

Paste*	Paste text from the clipboard into the selected text from the currently active text box.

Section

Add Section	Add a new section.

Delete Section	Delete the currently active section.

Edit Section	Edit the currently active section in a separate window.  Using this option, you may add comments to your INI files.

Key

Set Key	This option uses the data in the Key Text Box.  If the text is the currently active key then that key will be updated. If the key is different, then it will be added as a new key.

Delete Key	Deletes the currently active key.

Search	Searches the currently active INI file for the data you specify.

* = Applies to text boxes ONLY!


Options Menu

If the these items are checked, the option is in effect.

Menu Item	Description

Confirm Edits	Prompts a dialog box to confirm all edits.

Show Comments	Shows comments in the List Keys List Box.

Sort Keys	Sorts the List Keys List Box in alphabetical order.

Status Bar	Displays the status bar.

Toolbar	Displays the toolbar.


Window Menu

Menu Item	Description

Cascade	Cascade all open windows.

Tile Horizontal	Tile all open windows horizontally.

Tile Vertical	Tile all open windows vertically.

Arrange Icons	Arranges the icons of all minimized windows.

Refresh	Refreshes the currently active window.  This is useful when INI files are deleted or changed by another application while INI Manager is running.


Help Menu

Menu Item	Description

Contents	Displays the contents window of INIMAN.HLP.

Search	Searches INIMAN.HLP for a specific topic.

Help on Help	Displays help on using the WINHELP.EXE.

About	Displays version information about INI Manager.

Register	Displays a registration form for registering your copy of INI Manager.


Filename Combo Box

This list displays all of the files with the extension ini in the current directory.

To change the current directory, see Change Path.


Section Combo Box

Displays the sections of the currently active INI file.


List Keys List Box
Keys List Box

Displays all of the keys and settings in the currently active section.


Key Text Box

Displays the key currently selected in the Keys List Box.  If this item is modified, INI Manager will add it as a new key.

Pressing ESC in this text box will clear its contents.  This is very useful when adding a new key.


Setting Text Box

Displays setting of the currently selected key.  This is where you will change the setting of the key listed in the Key Text Box.

Pressing ESC in this text box will clear its contents.  This is very useful when adding a new key.


Speed Keys

Mouse Shortcuts

Key	Description

Edit Menu

CTRL+	Options Menu

SHIFT+ 	File Menu

Keyboard Shortcuts

Key	Description

F3	Edit Search

F5	Window Refresh

ALT+F4	File Exit

CTRL+A	Edit Add Section

CTRL+D	Edit Delete Section

CTRL+E	Edit Edit Section

CTRL+H	File Change Path

CTRL+N	File New Window

CTRL+P	File Print

CTRL+S	Edit Set Key

CTRL+F4	Flie Close Window

SHIFT+F3	Window Tile Horizontal

SHIFT+F4	Window Tile Vertical

SHIFT+F5	Window Cascade


Setting a Key

This feature changes the current settings of a specified key or creates a new key.  To set an existing entry, simply follow the following steps:

1.	Select the filename of the INI file you would like to edit from the Filename Dropdown List Box.

2.	Choose the line you wish to edit in the Keys List Box.

3.	Select the Setting Text Box and type the changes you wish to make.

4.	Click the Set Key button (Figure 11-1) from the toolbar or choose EDIT | KEY | SET KEY to update the changes to the INI file.

5.	If the Confirm Edits option is active, then you must accept or reject the confirmation to set the currently selected key, otherwise the change will automatically be written to your INI file.


Deleting a Key

When you delete a key, you delete the entire line in the INI file where that key belongs.  To delete a key from an existing INI file, simply follow the following steps:

1.	Select the filename of the INI file you would like to edit from the Filename Dropdown List Box.

2.	Choose the line you wish to edit in the Keys List Box.

3.	Select the Setting Text Box and type the changes you wish to make.

4.	Click the Delete Key button (Figure 11-2) from the toolbar or choose EDIT | KEY | DELETE KEY to update the changes to the INI file.

5.	If the Confirm Edits option is active, then you must accept or reject the confirmation to delete the currently selected key, otherwise the change will automatically be written to your INI file.


Adding a New Section

Figure 12-2 - Add Section Dialog

Note 	In order to add a new section, you must have a section name, a key,

and a setting.  You can not simply add a section with no key or setting entries.

1.	Select the filename of the INI file you would like to edit from the Filename Dropdown List Box.

2.	Click the Add Section button (Figure 12-1) from the toolbar or choose EDIT | SECTION | ADD SECTION (or press **) from the menu to add a new section.

3.	In the Add Section dialog box (Figure 12-2), type the name of the new section name in the Section Text Box and press tab to select the next field.

4.	Type the name of the key for this new section in the Key Text Box and press tab to select the next field.

5.	Type the settings for this new key in the Setting Text Box and press tab to select the Ok command button.

6.	To accept your changes choose Ok, otherwise, choose cancel.


Deleting a Section

This feature deletes an entire section from the currently selected INI file.  All of the keys that are contained within the section will be deleted.  To delete a section from an existing INI file, simply follow the following steps:

1.	Select the filename of the INI file you would like to edit from the Filename

Dropdown List Box.

2.	Choose the section you wish to delete in the Section Dropdown List Box (found

under the Filename Dropdown List Box).

3.	Click the Delete Section button (Figure 13-1) from the toolbar or choose EDIT |

SECTION | DELETE SECTION to update the changes to the INI file.

4.	If the Confirm Edits option is active, then you must accept or reject the

confirmation to delete the currently selected section, otherwise the change will

automatically be written to your INI file.


Editing an Entire Section

Figure 14-2 - Edit Section Dialog

1.	Select the filename of the INI file you would like to edit from the Filename

Dropdown List Box.

2.	Click the Edit Section button (Figure 14-1) from the toolbar or choose EDIT |

SECTION | EDIT SECTION from the menu to edit the  section.

3.	In the Edit Section dialog box (Figure 14-2), you may edit the section just as you

would edit a file in Notepad.  Here you may add, delete, or edit comments.

4.	When you are finished editing the current section, press tab to select the Ok

command button.

5.	To accept your changes choose Ok, otherwise, choose cancel.


Searching

Figure 15-2 - Search Dialog

The search dialog provides an easy way to search your INI files.  It acts like all standard search (or find) dialogs with two exceptions:

1.	The Match Whole Word check box has been replaced with the Match Whole Entry Only check box.

2.	The direction option group has been replace with the Location option group.

Match Whole Entry Only Check Box

When this item is checked, the item will only be found if the text in Find What text box matches character for character the entrie Section, Key or Setting (depending on what option was chosen in the Location option group).  For example:

Find What Text Box = Desktop

Location Option Group = Section

The only section in your INI file with the word

"Desktop" is called [My Desktop].

If the Match Whole Entry Only Check Box is checked, the item would not be found because there is no section with just the word "Desktop."  If the option was not check then a match would be found at the [My Desktop] section because it contains the word "Desktop."

Match Case

To perform a case-sensitive search, select this item.  If the Match Case check box is selected, the following items would not be considered a match:

Desktop * desktop

INI Manager * INI manager

Location Option Group

The Location Option Group determines which section of the INI file you wish to search.  For example, if you would like to search for the text in a Section, choose Section.

An Example Search

To search for the word "Desktop" in a section of the currently active INI file, you would do the following:

1.	Click the Search button (Figure 15-1) from the toolbar or choose EDIT | SEARCH from the menu to display the search dialog.

2.	In the Search dialog box (Figure 15-2), type the text you wish to search for in the Find What Text Box and press tab to select the first check box.

3.	If you would like to match the entire entry, click the Match Entire Entry Only Check 	Box.  Press tab to select the next check box.

4.	If you would like to preform a case-sensitve search, click the Match Case Check 	Box.  Press tab to select the next option.

5.	In the Location Option Group, choose the area of the INI file you wish to search.  Press tab to select the Find Next button.

6.	To search for the desired item choose Find Next, otherwise, choose cancel.  To find the next occurence of the item, press Find Next again.

Note 	When searching for an item, INI Manager will always begin at the begining of the file for new entries in the Find What text box.  When it has searched until the end of the file, you will be prompted to continue the search at the begining of the file.  If an item is not found during one pass of the file, you will be notified that the item was not found.


Opening a New Window

To open a new window, simply click the New Window button (Figure 17-1) from the toolbar or choose FILE | NEW WINDOW.

Note 	The new window will use the directory of the currently active form.

You may open a maximum of five windows.


Closing the Current Window

To close the current window, simply click the Close Window button (Figure 17-2) from the toolbar or choose FILE | CLOSE WINDOW.


Creating a New INI File

Figure 17-3 - Create A New INI File Dialog

To create a new INI file, simply choose FILE | CREATE FILE.  When the dialog box appears, fill in the appropriate information and choose Ok to create the file.  For more instructions, see Adding a New Section.

Note 	All four text boxes must contain text before the Ok command button will be enabled.


Deleting an Existing INI File

To delete an existing file, simply select the file you wish to delete from the currently active window and choose FILE | DELETE FILE.  You will always be prompted to confirm your action (even if Confirm Edits is not currently checked).  The file will be backed up before it is deleted.


Changing the Current Path

Figure 18-2 - Change Path Dialog

This feature is designed to allow you to edit INI files from directories other than your Windows directory.  To change the path to a new directory, you must do the following:

1.	Click the Change Path button (Figure 18-1) from the toolbar or choose FILE |

CHANGE PATH from the menu to change the path.

2.	When the dialog appears, choose the directory you wish to use.

3.	Ignoreme.ini or valid file name must be present in the File Name text box when

you choose Ok, otherwise you will get an error message.

4.	If no INI files are found in the directory of your choice, simply repeat the steps

listed above.


Printing the Current INI File

Figure 19-2 - Print Dialog

1.	Click the Print button (Figure 19-1) from the toolbar or choose FILE | PRINT from

the menu to print the current file.

2.	When the Print dialog (Figure 19-2) appears, make your choice of a Print Range,

Print Quality, and number of Copies.

3.	If you would like to select a different printer, choose Setup.

4.	Click Ok to send the file to your printer, otherwise choose Cancel.

Note 	To adjust the number of lines and characters printed per page, see Appendix B.


Exiting INI Manager

To exit INI Manger, simply click the Exit button (Figure 20-1) from the toolbar or choose FILE | EXIT.


An Explaination of INIMAN.INI

The INIMAN.INI file contains infomation about your selected options and printer settings.  Feel free to modify this file to meet your specific needs.

Your INIMAN.INI file is found in the same directory with your INIMAN.EXE file.  If you decide to move your INIMAN.EXE you must also move your INIMAN.INI file, or else all options will return to their default settings.

Note 	If any of these lines do not appear in your INI file, the default value will be used.

Below is an example of all INI entries with their default values listed:

[Options]	Most items in this section correspond to their Options Menu counterparts.-1 means checked, 0 means not checked.
DisplayWarning=-1
ConfirmEdits=-1
ShowComments=0
SortKeys=0
ShowStatusBar=-1
ShowToolbar=-1
AlwaysUseBak=0	When this option is -1, it forces INI Manager to use the BAK extension only when backing up your INI files after an edit.  If this option is 0 then INI Manager will create a BAK file after the first edit, and then create 00# file for every edit after (up to the number specified by MaxBackupFiles  See backup files later in this appendix.
MaxBackupFiles=3	This option determines how many 00# backup files will be created before they are recycled. See backup files later in this appendix. It's maximum value is 99
[Printer Options]	This section describes various printer options.
PrintHeight=65	This determines how many lines of text will be printer per page (not including the header and footer).
PrintWidth=95	This determines how many characters will be display across a single page If text is being clipped on the right margin, then reduce this number. It's maximum value is 280


The Backup Process

How INI Manager Backs Up Files

INI Manager will back up your file before every edit.  It takes the following steps when backing up a file:

1.	INI Manager reads your INIMAN.INI file to see if AlwaysUseBak is set to -1.  If it is, it will always write backups to the same BAK file.

2.	If AlwaysUseBak is set to 0 then INI Manager will read the number specified by MaxBackupFiles.  If no number is listed, it will use 3.

3.	When backing up a file INI Manager will first try to use the BAK extension.  If the file exist, INI Manager will try to write a backup file using the 00# extension.  INI Manager will always check to see if a file exists before writing to it.  If it exist INI Manager will try to find an extension from 001 to MaxBackupFiles (example: INIMAN.003) which does not exist.  If 00MaxBackupFiles exist, then INI Manager will search all 00# files for the oldest file.

4.	Once the oldest file is found (determined by looking at the file date and time), the INI file is backed up.

Restoring a File to its Original Form

To recover a file, simply do the following proceedure:

1.	If you have set the AlwaysUseBak setting to -1 your most recent backup file will have the extension BAK. Goto step 5 for further instructions.

2.	If AlwaysUseBak is set to 0 then use File Manager to change to the directory where your INI file exists.  From File Manager, choose VIEW | BY FILE TYPE...

3.	In the Name Text Box, type the prefix of your file and .* (example: iniman.*).  Choose Ok.

4.	Next, choose VIEW | SORT BY DATE to display all of the files by date.

5.	In File Manager select your most recent backup file.

6.	To copy your backup file to your original INI choose FILE | COPY.

7.	In the To Text Box, type the prefix of your filename and .ini (example: for iniman.003 you would type iniman.ini).

8.	Your file should now be restored.  Restart your applicaiton or Windows to take advantage of the new changes.


Ordering Information

Licensing your copy brings you wonderful benefits.  Such as:

- Gets rid of that nagging reminder window that comes up when you perform certain functions.

- Get online help and a manual.

- Insures that you have the latest version of the product.

- Gets you on our mailing list so you are occasionally notified of updates and our other Windows products.

Mail To

Martinsen's Software

5501 Tullis Drive

Building 2, Suite 304

New Orleans, LA 70131-8864

or call

(504) 394-6045

NOTE:  Please allow 2 to 3 weeks for delivery.

Today's Date: _____ - _____ - _____

Name:	 ____________________________________________________

Firm:	 ____________________________________________________

Address:____________________________________________________

 ____________________________________________________

City: ____________________________ State:______  Zip:___________

Phone: (______)_________________    Country:___________________

AOL Screen Name:___________________________________________

INTERNET Address:__________________________________________

CompuServe ID:______________________________________________

*** PRICES ARE SUBJECT TO CHANGE WITHOUT NOTICE ***

Qty	Product	Each	Total

____	Beyond Windows Exit 2.0	$19.95	________

____	INI Manager 2.0	$24.95	________

____	Launcher 1.0	$ 9.95	________

____	PackIt! 1.11	$19.95	________

____	RunPlus 1.0	$ 4.95	________

____	ScrapVault Lite 2.1	$19.95	________

____	Wallpaper Manager 2.0	$19.95	________

Subtotal	________

____	Shipping [Qty * $3.05]	$ 3.05	________

Total	________

Note  International Orders shipping charges will vary.

Please enclose a cashiers check payable to Martinsen's Software or you may use Amex, Visa, or Master Charge.

NOTE Call for details about elecronically registering TODAY!

For credit cards,  please enter the information below:

Type of Card:  VISA	Master Card	American Express

Name on Card: _____________________________________________________

 Card #:__ __ __ __ __ __ __ __ __ __ __ __ __ __ __ __

 Expiration date: ____/____

 Signature:  _________________________________________

 Where did you hear about or get a copy of our products?

 ___________________________________________________________________