Edit INI File Action - General

The General page lets you specify a configuration file and configure the list of changes to be performed on the file. You can also create a file, if one does not exist.

File Path

Specify the path of the file that you want to change. The file can be .ini, .cfg, .conf, or a .txt file. For example, C:\Program Files\OpenOffice.org 2.0\program\setup.ini.

You can also specify a file without any extension.

Encoding

Specify the encoding that you want to use:

Auto detect: Use the encoding used in the original file that you specified in the File Path field. This is the default option.

ASCII: Use ASCII encoding.

Unicode: Use Unicode encoding.

UTF-8: Use UTF-8 (8-bit UCS/Unicode Transformation Format) encoding.

Create File, If Does Not Exist

Select the Create file, if does not exist option to create the file specified in the File Path field, if it does not exist. The file is created with the same name and the extension as specified in File Path. If the file specified in File Path does not have an extension, then the created file also does not have any extension.

If this option is selected and Encoding is set to Auto detect, the file is created in UTF-8 format with the same name and the extension as specified in File Path.

INI Changes

The INI Changes page lets you specify the INI file to change, add sections to the file, add keys to a section in the file, and import changes from another INI file. The following table lists the tasks you can perform to manage INI changes.

Task

Steps

Additional Details

Add a section

  1. Click Add, then click New Section Change.

  2. In the Add a Change dialog box, fill in the fields, then click OK.

    Click the Help button for additional information.

If you specify an existing section and add new keys to the list, then the existing section is updated with the newly added keys. For example, if a section sect1 with k1=v1 already exists and if you specify a new section sect1 with k1=v1k2=v2, then the newly added key k2=v2 is added to sect1.

Add keys to a section

  1. Click the section to which you want to add the keys.

  2. Specify the keys to be added to the section in the INI file. Type the key, such as key1 or key1=value1, then click Add to move the key to the list.

    You can edit or remove an entry, or you can use the Move Up and Move Down buttons to order the list. The changes to the file are made in the order listed.

 

Edit an INI Change

  1. Click the desired item you want to edit.The Add a Change dialog box is displayed.

The Section Change Type configured for the section is displayed by default in the Add Change dialog box.

Remove a section or keys

  1. Select the check box next to the desired item to remove the item from the action, then click Delete.

 

Import INI changes from another file

  1. Click Import to display the Import INI Changes from File dialog box.

  2. Specify the file from which you want to import changes, then click OK.

 

Change the order of items

  1. Select the check box next to an item, click Edit, then select an option (Sort, Move Up, Move Down).

 

Select all the objects of a parent folder

  1. Select the check box next to the parent folder, then click Edit > Select All Children.

 

Deselect all the objects of a parent folder

  1. Select the check box next to the parent folder, then click Edit > Deselect All Children.

 

Clear Selection

  1. Click Edit > Clear Selection.

 

Run Action As: Specify System (the default) or User from the Run Action As list. Specify System if removing files requires access to all areas of the device’s file system. If you use mapped network drives to specify files and directories, you must run the action as User.

Advanced Options

The Advanced Options page lets you create the file (if it does not exist), specify the number of backup files to retain, and specify key-value separators and comment characters.

File Backup(s) to Retain

Specify the number of backups of the INI file to retain. The default is 5 backup copies, but you can specify any number between 1 and 25. When the number of backup copies of the file exceeds the number specified here, the oldest backup file is overwritten.

Key-Value Separator

Specify the character you want to separate the key and the values. You can use an equals sign (=) or a colon (:).

Value Separator

Specify the character you want to separate the multiple values. You can use characters such as equals sign (=), comma(,), space( ), hash (#), semicolon (;) or a colon (:).

Comment Character

Specify the character you want precede comments in the INI file. You can use a semicolon (;) or a pound sign (#).

Append key-value separator to the key when value is not available

Select this option to append the key-value separator to the key even if the value is not available. For example, in the setup.ini file used by Acrobat Reader, the CmdLine key does not have a value but requires a key-value separator.

For trademark and copyright information, see Legal Notices.