home *** CD-ROM | disk | FTP | other *** search
-
- ΓòÉΓòÉΓòÉ 1. ABOUT INITOR ΓòÉΓòÉΓòÉ
-
- Initor enables you to edit OS2 "INI" files. You are able to add, delete, copy
- and edit applications, keys and key data. Further more you are able to save and
- read data from the current INI file to and from another INI file(s). You can
- also save applications, keys and key data to a ASCII HEX file such that you can
- view it using an ASCII editor.
-
- DO NOT USE THIS PROGRAM IF YOU DONT KNOW WHAT YOU ARE DOING!!!!
-
- The author takes no responsibilty if INI files are damaged and no "safety keys"
- are included into the application; therefore its very fast and efficient!
-
- This program was written because the LOTUS INI file editor has some problems.
- The lotus ini editor cannot be sized to a different window size, it comes up
- with this silly window at startup and does not remember the last directory were
- a file was edited. So the basic structure of Real World Programmings INI file
- editor was used and a few things and bugs were changed to make INITOR.
-
-
- ΓòÉΓòÉΓòÉ <hidden> 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.
-
-
- ΓòÉΓòÉΓòÉ <hidden> 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 re-make in that case using Make default ini file
-
-
- ΓòÉΓòÉΓòÉ <hidden> History of INITOR ΓòÉΓòÉΓòÉ
-
- June 1996: INITOR 1.0
- June 1996: INITOR 1.1
- - added very simple help menu (shows readme file).
- - added abilty to edit and add BINARY data (hex data).
- - fixed last path saved (path was cut off when longer the 20).
- - fixed redraw when canceling add/edit dialog box.
- - fixed some data appearing in key data window when adding new key.
- - fixed some data appearing in key data window when adding new
- application.
- September 1996: INITOR 1.2
- - added copy action for saving key data.
- - added copy action for saving one application and all its keys.
- - added entire file copy.
- - fixed bug in the hex edit part, too small edit buffer (still only
- 10K).
- - fixed bug in memory allocation of data (leak?).
- - fixed saving of changed data (quicker and more efficient).
- - fixed bug of help file not found (using argument passed to main
- now).
- - fixed a bug in my email address.
- October 1996: INITOR 1.3
- - added reading in of other entire INI file into current INI file (ALL
- OF IT).
- October 1996: INITOR 1.4
- - fixed "cancel" button in the edit application dialog box.
- - added display of error message when incorrect INI file is used for
- reading/writing.
- - changed the font in the hex box to courier (monospaced).
- - added reading in of applications from other file into current INI
- file.
- October 1996: INITOR 1.5
- - Icons can now be dropped onto INITOR.
- - On the commandline you can call up INITOR with a filename specified.
- - POPUP menus now working.
- - Accelerate Keys now working.
- - Partly fixed the memory usage.
- - Rearranged the menus so there's now a FileMenu.
- - Menus now include accelerator key names.
- - Use TAB key now to jump between Application and Key window and
- scroll with key to the next item.
- - There are now two paths to be saved to the initor ini file:
- + path name for display files.
- + path name for save/read files.
- - INITOR has its OWN ini file now. Must/will be located in the same
- directory as the program itself.
- - Fixed: Title specifies name of INI file now correct.
- October 1996: INITOR 1.6
- - Fixed bug of being able to edit application even if "No Entries"
- - Fixed wrong display of accelerator keys on the menus. (there I tell
- my students ALL the time to be careful using copy/paste functions
- and then I do it myself....)
- - added filename to query menus to make sure that the CORRECT key gets
- deleted!
- - added SPLIT/UNSPLIT menu to be able to edit *LARGE* keys (I mean
- *!LARGE!*)
- October 1996: INITOR 1.7
- - Fixed bug from 1.5 and 1.6 where I forgot to switch of the dynamic
- inclusion of standard libraries. It was working with on my machine,
- coz the library was found in one of my path.
- December 1996 to January 1997: INITOR 2.0
- - Fixed: at startup the system and user profile where loaded although
- only user profile displayed on title bar.
- - Fixed: when unzipped first, MY screen location was in the initor.ini
- file which gave a few people some problems. I have not included my
- screen location. This will start INITOR the first time with some
- default location.
- - Fixed: The Display area (HexBytes) did NOT display correctly bytes
- above 7F. I did not cast (c term) a value past to a long to
- (hex)string (sprintf) conversion function. It saw the upper byte a
- the negative flag.
- - Fixed: When saving using the HEX WINDOW and adding a byte to the
- already existing value I had forgotten to recalculate the string
- length when passing it back to the window string function (once
- again rather stupid, indeed).
- - Fixed (not my fault): When the ASCII string in the was less then 7
- bytes long it was NOT displayed on the ASCII display of the key
- display area. I have no idea, why this is the case. I calculated it
- properly but could not see the reason, so I made it constant and it
- works. This does not influence the performance of the editor but
- does get to my nerves since it is an ugly "help" and doesnt suit my
- philosophy of making things (nearly) perfect.
- - Fixed: The vertical scroll bar now scrolls page wise, too.
- - Fixed: When moving through the keys one at a time, and one of the
- keys would contain no data, the previous value was displayed intead
- of an empty data window.
- - added context sensitive help and proper help menu, hence the new
- major number of INITOR.
- - added copy option to copy an application or key to the current INI
- file but with a new name.
- - changed: the screen location is now saved upon exit of the program.
- This was suggested by a number of users.
- - added some settings into the initor.ini file. This stops
- confimations to pop up or to stop INITOR to save its screen location
- upon exit.
- April 1997: INITOR 2.1
- - The compile and design platform of INITOR has been for a while
- Merlin. The compiler used up to February 1997 was Borland's C++. Now
- the compiler has changed to: Visual Age C++ for OS/2 by IBM.
- - added feature to save applications, keys and key data to an ASCII
- HEX file to be able to read the data using a normal ASCII editor and
- to compare different ASCII file with each other.
- - changed some of the memory allocation calls, should use less memory
- from now on!
- April 1997: INITOR 2.2 I forgot to include the static link option in my
- compiler setup which led to problems that people did not have the
- libraries available. I appologize for this one, and it wasn't the first
- time it had happened. (See above).
-
-
- ΓòÉΓòÉΓòÉ <hidden> Acknowledgements ΓòÉΓòÉΓòÉ
-
- Below I would like to thank some people for bug reports, suggestions and ideas.
-
- IBM for their C and C++ platform "Visual Age C++ for OS/2". I have seen a
- number of compilers in my time, but this beats everything!
- Blain, Delimon, and English for their excellent book "Real World
- Programming for OS/2 (1993)" from which some parts of this programs
- source code was taken.
- Jim Gawn fo hos input of not fully setup vertical scroll bars of data
- window. I simply did not include code for it.
- Erwin Hogeweg for his input for large keys, this let to the split key
- menus. This was due to the limitation of a listbox being not able to show
- large data sizes.
- Raman Samanya for the idea of mouse button pop up menus, accelerator keys
- and switching off confirmation.
- Kevin Yank and Andreas Schlemmer for his idea passing the filename to be
- opened as a commandline option and hence being able to drop and
- associate.
- Tomi Soini for pointing out that the FILE_ID.DIZ file was missing in the
- zip file.
- Pat Shanahan for pointing out that there was a missing library when
- running INITOR 1.6! I switch off a lot of things during design to make
- compilation faster and I forgot to reset this when I put it onto the net
- (dynaimc versus static linking).
- Thomas Ho for reporting that the incorrect files where loaded upon
- startup (system ini and user ini where loaded).
- Traugot Ziegler, Reinhart Gruhn, Don Woodall, Mike Ryan for pointing out
- that the program ran off the screen upon startup. I had included into
- "initor.ini" my screen configuration which runs on 1024x768. People using
- lower screen resolutions ran into problems.
- Andre Nancoz for pointing out some errors in saving using the hex window.
- This was only the case when a key was increased by a byte and not saved
- before. He pointed out, too, that some keys DO NOT have "0" as an ending.
- This did not damage keys but just increased keys by one byte ending it
- with a "0". (Well when testing it you save things lots of times.....).
- Andre Nancoz for pointing out that in case a key had 0 data bytes the
- previous key was displayed.
-
-
- ΓòÉΓòÉΓòÉ <hidden> Enhancements for the future ΓòÉΓòÉΓòÉ
-
- Be able to read ASCII HEX DATA file into current INI file. This would
- make it very easy to use a text editor to make up entries for an INI file
- and simply load them into the current INI file. The "other" option saving
- is already installed.
- Now that I have Visual Age C++ from IBM and the MultiLine listboxes with
- sizes greater the 64K are properly implemented I will redesign the
- editing part and make it part of the bottom window of the main canvas
- with an option of saving or not saving (I always wanted to do this!!!!).
- Open two windows of INITOR and copy/paste between editors to get/save
- keys???
- Some person suggested, to include a function like INIMAINT CTRL-F10 to
- clean up some junk. I have to figure out how to do this. Maybe somebody
- can give me a hand or hints???
-
- Other ideas anyone???? Suggestions.
-
- Send suggestions and ideas to the author. Find the address in the about menu.
-
-
- ΓòÉΓòÉΓòÉ <hidden> Compatibility of INITOR ΓòÉΓòÉΓòÉ
-
- It has run on a number of systems with different types of WARP installed. This
- program is designed and compiled from April 1997 onwards using IBM's Visual Age
- C++ for OS/2.
-
- I (and a friend of mine) use this program for system administration purposes.
- We looking after systems with different configurations and flavour of OS/2:
-
- Warp plain
- Warp fixpak5
- Warp fixpak10
- Warp fixpak17
- Warp fixpak26
- Warp Server 4.0
- Merlin (design and compilation platform of INITOR) with and without
- fixpak 1.
-
-
- ΓòÉΓòÉΓòÉ <hidden> Bugs of the program ΓòÉΓòÉΓòÉ
-
- I tested this thouroughly and it worked fine with me and one other person, but
- as you can see in the history and the acknowledgements, a few bugs came up
- anyway.
-
- NOTE!
- One user reported data loss when deleting a number of different applications at
- the same time. I have tried and tried following his instructions but I cant
- "replay" it.
-
- PLEASE!
- Report bugs to the author!
-
- I really would like to hear from you if you found any, so I can enhance the
- program. I believe in (some) free stuff.
-
-
- ΓòÉΓòÉΓòÉ <hidden> Contact the Author ΓòÉΓòÉΓòÉ
-
- Jobst Schmalenbach
- 19 York Street
- Caulfield South, Vic, 3162
- Australia
-
- Home phone: 61 3 9523 7348
- Work phone: 61 3 9905 5705
-
- Email: jobst@senna.eng.monash.edu.au
-
-
- ΓòÉΓòÉΓòÉ 2. Help Menu ΓòÉΓòÉΓòÉ
-
- Use the choices on the Help pull-down to display:
-
- Help index
- Displays the index of help menu.
-
- General Help
- Displays some information about INITOR program.
-
- Keys Help
- Displays a list of keys usage.
-
- Using Help
- Provides detailed information on the kinds of help available and how to
- use help.
-
- Product Information
- The dialog displays information about the address of the author and
- version number of the product.
-
-
- ΓòÉΓòÉΓòÉ 3. Using Help ΓòÉΓòÉΓòÉ
-
- Displays some general help information about INITOR program. This includes
- basic operation and hints.
-
-
- ΓòÉΓòÉΓòÉ 4. Using Help ΓòÉΓòÉΓòÉ
-
- Use this choice to obtain information on how to use the Help facility.
-
-
- ΓòÉΓòÉΓòÉ 5. Accelerator Keys ΓòÉΓòÉΓòÉ
-
- Use this choice to see a list of keys and a description of the function of the
- keys for the INITOR program.
-
- Accelerator keys simply are keys offering quick access to menus, which only
- could be accessed using at least two clicks with the mouse. For example to get
- to the "Copy Key" function, you need to click on "Copy" and then on "Copy Key".
- Using the keyboard you can simply press "Shift-c".
-
- Press here to see more keys.
-
-
- ΓòÉΓòÉΓòÉ 5.1. Key Assigments ΓòÉΓòÉΓòÉ
-
- ACCELERATOR KEYS
-
- The list of keys is arranged in groups.
-
- HELP KEYS
-
- F1
- Help Index Window
-
- SHIFT F1
- Keys Help Window
-
- Esc
- Previous Help Panel, or End help if only one panel
-
- Alt
- Switch IN/OUT action bar
-
- Alt+F4
- End help or End program
-
- SYSTEM KEYS
-
- Alt+Esc
- Switch to the next program, including full-screen programs
-
- Ctrl+Esc
- Switch to the Task List
-
- WINDOW KEYS
-
- Underlined letter
- Move among the choices on the action bar and pull-downs submenu or
- execute the function chosen
-
- INITOR SPECIFIC KEYS
-
- SHIFT+A
- Display the Product Information (About) Dialog Box.
-
- SHIFT+U
- Load the USER PROFILE into the editor.
-
- SHIFT+S
- Load the SYSTEM PROFILE into the editor.
-
- SHIFT+P
- Load the USER PROFILE and SYSTEM PROFILE into the editor.
-
- SHIFT+O
- Load the a user specified INI file into the editor. A dialog box will pop
- up and a filename can be specified.
-
- SHIFT+R
- Refresh current INI file (reload).
-
- ALT+X
- Quit program.
-
- BACKSPACE
- Split current key into chunks of 8000 bytes, such that it can be used for
- dialog boxes.
-
- SHIFT+BACKSPACE
- UN-split current set of keys to make it one key again.
-
- SPACE
- Edit current application using the ASCII editor.
-
- SHIFT+SPACE
- Edit current application using the HEX editor.
-
- INSERT
- Add a new application to current INI file.
-
- SHIFT+INSERT
- Add a new KEY to current application.
-
- DELETE
- Delete current APPLICATION.
-
- SHIFT+DELETE
- Delete current KEY.
-
- SHIFT+C
- Copy current application to a new application with a different name.
-
- CONTORL+SHIFT+C
- Copy current key to a new key with a different name.
-
- TAB
- Switch between windows. This selects either KEY or APPLICATION window
- such that it can be scrolled using keys.
-
-
- ΓòÉΓòÉΓòÉ <hidden> 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.
-
-
- ΓòÉΓòÉΓòÉ 6. File Menu Help ΓòÉΓòÉΓòÉ
-
- 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 (eg. AmiPro's INI FILES)
-
- - Refresh will update the display, thus re-read the current INI file.
- - Exit will close INITOR.
-
-
- ΓòÉΓòÉΓòÉ <hidden> Open User Profile ΓòÉΓòÉΓòÉ
-
- If you click on this menu item, the user profile (OS2.INI) will be loaded into
- the editor.
-
-
- ΓòÉΓòÉΓòÉ 6.1. Open System Profile ΓòÉΓòÉΓòÉ
-
- If you click on this menu item, the system profile (OS2SYS.INI) will be loaded
- into the editor.
-
-
- ΓòÉΓòÉΓòÉ 6.2. Open User and System Profile ΓòÉΓòÉΓòÉ
-
- If you click on this menu item, the system profile (OS2SYS.INI) and the user
- profile (OS2.INI) will both be loaded into the editor.
-
-
- ΓòÉΓòÉΓòÉ 6.3. Refresh ΓòÉΓòÉΓòÉ
-
- Refresh will update the display, thus re-read the current INI file.
-
-
- ΓòÉΓòÉΓòÉ 6.4. Exit ΓòÉΓòÉΓòÉ
-
- Exit will close INITOR.
-
- This will also save the current screen location into the INITOR.INI file. You
- an change the default saving of the window position using the explanation under
- the meu Initor's own INI file.
-
-
- ΓòÉΓòÉΓòÉ 6.5. Open Other Profile ΓòÉΓòÉΓòÉ
-
- This option will allow you to open a particular INI file.
-
- This can be ANY INI file as long as it conforms to the INI file data standards.
-
- Example INI files would be: AMIPRO.INI, AMIUSER.INI, TCPOS2.INI and even
- INITOR's "initor.ini".
-
- Once you clicked on this item a file dialog box will pop up and you can specify
- (or find) the INI file you like to edit.
-
- The default "open" directory can be changed using Save Display Path.
-
-
- ΓòÉΓòÉΓòÉ 6.6. Make default ini file ΓòÉΓòÉΓòÉ
-
- A new "initor.ini" file for INITOR is made. When this menu option is chosen the
- following new applications and keys are made which are used during operation of
- INITOR!
-
- Basic Configuration
- - Display Path
- - SaveRead Path
- - SaveScreenPositionOnClose
- - ScreenPosition
- Confirmations
- - ConfirmDelete
- - ConfirmSplit
-
- See the help menu Initor's own INI file for further explanation.
-
-
- ΓòÉΓòÉΓòÉ 7. Initor's own INI file ΓòÉΓòÉΓòÉ
-
- INITOR uses its own INI file "initor.ini" to find some configuration values at
- run time. Each one of the entries in the INITOR's ini file is explained below
- with application name, key name and possible values and how the values
- influence the perfomrmance of initor.
-
- Rather then adding a menu to INITOR the user can simply change the values (and
- hence the behaviour) by editing using INITOR the file initor.ini in INITOR's
- directory.
-
- If something went wrong the user can simly re-make a new initor.ini file using
- default configurations. See hereof Make default ini file.
-
- The application name is first, the key name is named second.
-
- "Basic Configuration" - "Display Path"
- This value is a string constant and contains the path of the last opened
- "other" ini file. If changed the dialog box of open other will have the
- new path entry.
- See Menu: Save -> DisplayPath.
-
- "Basic Configuration" - "SaveRead Path"
- This value is a string constant and contains the value of the last saved
- to directory, that is using the menu Save.
- See Menu: Save -> ReadPath.
-
- "Basic Configuration" - "SaveScreenPositionOnClose"
- Ths value is a string constant and can only have the values "ON" or
- "OFF". When set to "ON" the current screen location of the INITOR is
- saved to the initor.ini file. When set to "OFF" screen location saving
- can only be done using the menu "save screen location".
- See Menu: Save -> SaveScreenLocation.
-
- "Basic Configuration" - "ScreenPosition"
- This value are for unsigned long integer and make up the dimensions of
- the window upon startup and contains the location when screen poisition
- is saved. This is also set to the current location when a new ini file
- is produced.
- See Menu: Save -> SaveScreenLocation.
-
- "Confirmations" - "ConfirmDelete"
- This is a string and can either be set to "ON" or "OFF". If set to "ON" a
- confirmation box will appear before deletion of application and keys. If
- set to "OFF" this application box will not appear and the applications
- and keys are deleted straight away!
-
- "Confirmations" - "ConfirmSplit"
- This is a string and can either be set to "ON" or "OFF". If set to "ON"
- it will ask for confirmation to split a key (unsplit a key). If set to
- "OFF" it will not ask and split/unsplit the key straight away!.
-
-
- ΓòÉΓòÉΓòÉ 8. Edit Items Menu Help ΓòÉΓòÉΓòÉ
-
- To change the data of an application use "Edit Application" (alt-e).
-
- A Dialog box will appear to either edit an application or key in ASCII or HEX.
-
- You cannot change the application name, that is set read only but you can
- change the key name and the data. If you need to change an application to a
- different name use Copy Items providing a way to change the name of an
- application.
-
-
- ΓòÉΓòÉΓòÉ 8.1. Edit Application (ASCII) ΓòÉΓòÉΓòÉ
-
- This dialog box has the application in the first row, the key name in the
- second and the data in the listbox underneath.
-
- This 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. See
- Edit Application (Hex)
-
- If you want to edit keys larger than 10500 bytes you might consider reading the
- SPLIT and UNSPLIT found in other sections of this manual.
-
-
- ΓòÉΓòÉΓòÉ 8.2. Edit Application (Hex) ΓòÉΓòÉΓòÉ
-
- This dialog box is for ASCII strings with values below 32 and above 127.
-
- 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 and UNSPLIT found in other sections of this manual.
-
-
- ΓòÉΓòÉΓòÉ 9. Add Items Menu Help ΓòÉΓòÉΓòÉ
-
- If you need to add a new application or add a new key to an existing
- application choose "Add Items" (ALT-A).
-
- You have then two options to either add a new application or a new key. Both of
- the options require to add some data as well.
-
-
- ΓòÉΓòÉΓòÉ 9.1. Add New Application ΓòÉΓòÉΓòÉ
-
- This option adds a new application to the INI file. An application is for
- example "AmiPro" or "Netscape" found in the user (OS2.INI) file. If you add a
- new application it will be sorted alphabetically (not in the INI file). You
- must give a new key and data as well, otherwise the application will not be
- accepted.
-
-
- ΓòÉΓòÉΓòÉ 9.2. Add New Key ΓòÉΓòÉΓòÉ
-
- This option adds a new KEY to the current application pointed at. A new key
- would be for example "TMPPATH" with data (maybe) "H:\tmp" for and application
- "BackupDir".
-
-
- ΓòÉΓòÉΓòÉ 10. Delete Items Menu Help ΓòÉΓòÉΓòÉ
-
- If you need to delete a key or application click on "Delete Items" (ALT-d).
-
- This will delete either the current application or current key depending on
- which of the menus Delete Application or Delete Key you have chosen.
-
- You are asked for confirmation to delete the key or application. The
- application or key name is displayed on the query menu, so you know which key
- it is.
-
- You can switch off confirmation. See hereof the help item Initor's own INI
- file.
-
-
- ΓòÉΓòÉΓòÉ 10.1. Delete Application ΓòÉΓòÉΓòÉ
-
- This 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!
-
-
- ΓòÉΓòÉΓòÉ 10.2. Delete Key ΓòÉΓòÉΓòÉ
-
- This will delete the key and the data.
- A key example of above application "BackUpPath"
- Data (maybe) for the above key "H:\tmp"
-
- If the key was the only key to the application, the application is deleted as
- well.
-
-
- ΓòÉΓòÉΓòÉ 11. Copy Items Menu Help ΓòÉΓòÉΓòÉ
-
- This option allows you to copy an application or a key with a different name
- into the current INI file. You could use this option for example with IBM's
- "TCPOS2.INI" which contains information for the dialer. You can copy an
- existing dialer setting (application) to another name an change a few settings.
- This will save a fair amount of time clicking through the setup.
-
- This option is also useful to save an application or key before you want to
- make some changes. In case something went wrong you can simply copy it back.
-
- A dialog box will pop up and ask you for the new name. Note that you cannot
- change the "from" value, it is read only.
-
- You can either copy a complete application or a single key .
-
-
- ΓòÉΓòÉΓòÉ 11.1. Copy Application ΓòÉΓòÉΓòÉ
-
- This option copies an entire application with all its keys and data to a new
- application with a different name but same content.
-
-
- ΓòÉΓòÉΓòÉ 11.2. Copy Key ΓòÉΓòÉΓòÉ
-
- This option copies a key and its data to the same application but with a
- different key name. The data will be identical.
-
-
- ΓòÉΓòÉΓòÉ 12. Save Menu Help ΓòÉΓòÉΓòÉ
-
- This menu will save data of INI files and configuration items from INITOR.
-
- Saving INI file data can be done using two types of saving actions:
-
- Save data to other INI file(s)
- Save data to ASCII HEX file(s).
-
- Using the following items:
-
- Save Display Path
- Save Read Path
- Save Location
-
- some of INITOR's own configuration items can be saved into its own INI file.
-
-
- ΓòÉΓòÉΓòÉ 13. Save Data to other INI file ΓòÉΓòÉΓòÉ
-
- 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).
-
- The options available are:
-
- Save Application to other (INI) File
- This option saves ALL KEYS of one (selected) APPLICATION to a new
- (specified) file.
- Save Key to other (INI) File
- This option saves ONE (selected) KEY of one (selected) APPLICATION to a
- new (specified) file.
- Save ALL to other (INI) File
- This option saves all information of the current file to a new
- (specified) 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 already exists, but is NOT a proper INI file, an
- error message will be displayed and nothing will happen.
-
- The currently selected item in either of the lists will be the item to be
- saved to a file selected in the file dialog box.
-
- If applications or keys with the same name exist in the OPENED file, 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.)
-
-
- ΓòÉΓòÉΓòÉ 14. Save Data to other ASCII HEX file ΓòÉΓòÉΓòÉ
-
- If you want to save (or copy) an application or key to another file in ASCII
- HEX format you may do so by using the save menu (ALT-s) and then selecting one
- of the following options:
-
- something to say for Save Application to ASCII HEX file
- something to say for Save Key to ASCII HEX file
- something to say for Save All to ASCII HEX file
-
-
- ΓòÉΓòÉΓòÉ 15. Save configuration options of INITOR ΓòÉΓòÉΓòÉ
-
- Some of initors options used during run time can be saved using the following
- options:
-
- Save Display Path
- This option saves the path of the directory last read from, that is the
- directory of the last file opened using the option
-
- Save Read Path
- This option saves the path of the directory last read saved to, that is
- the directory where ini files are written to.
-
- Save Window Position
- This option save the current window location. This option is only of use
- if the save window upon exit is disabled.
-
-
- ΓòÉΓòÉΓòÉ 16. Read Menu Help ΓòÉΓòÉΓòÉ
-
- 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 from 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.
-
-
- ΓòÉΓòÉΓòÉ 16.1. Read Application ΓòÉΓòÉΓòÉ
-
- Load the INI file you want to add the data and click on the READ menu to "Read
- Application from other file". Once you selected a source file you are asked
- using a select dialog box which application(s) you want to read into the
- current INI file.
-
- Simply select each of the items you want and then click on OK.
-
- If a KEY/APPLICATION of a name in the current file exists, it is simply
- overwritten. No check is made.
-
-
- ΓòÉΓòÉΓòÉ 16.2. Read other INI file ΓòÉΓòÉΓòÉ
-
- Load the INI file you want to add data to into INITOR and click on the READ
- menu to "Read other ini file into current". Once you selected to source file in
- the file dialog box and pressed OK the complete file is read into the current
- file and if a KEY or APPLICATION of a name in the current file exists, it is
- simply overwritten. No check is made.
-
-
- ΓòÉΓòÉΓòÉ 17. Split Menu Help ΓòÉΓòÉΓòÉ
-
- 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 for each byte displayed 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 Unsplit will reverse the operation.
-
- 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.
-
-
- ΓòÉΓòÉΓòÉ 17.1. Split Key ΓòÉΓòÉΓòÉ
-
- Using this option 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.
-
-
- ΓòÉΓòÉΓòÉ 17.2. Unsplit Key ΓòÉΓòÉΓòÉ
-
- Using this 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.
-
-
- ΓòÉΓòÉΓòÉ 18. PopUp Menus ΓòÉΓòÉΓòÉ
-
- POPUP menus are selected when the right mouse button is pressed in either of
- the windows (application or key).
-
- There are two POPUP menus availabe depending the window the cursor is on:
-
- If the cursor is in the application window, the following popup is
- displayed:
- - Add Application
- - Copy 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
- - Copy 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.