home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 July / PCO_07_97.ISO / filesbbs / OS2 / INITOR22.ARJ / INITOR22.ZIP / initor.HLP (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1996-07-06  |  32.4 KB  |  892 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. ABOUT INITOR ΓòÉΓòÉΓòÉ
  3.  
  4. Initor enables you to edit OS2 "INI" files. You are able to add, delete, copy 
  5. and edit applications, keys and key data. Further more you are able to save and 
  6. read data from the current INI file to and from  another INI file(s). You can 
  7. also save applications, keys and key data to a ASCII HEX file such that you can 
  8. view it using an ASCII editor. 
  9.  
  10. DO NOT USE THIS PROGRAM IF YOU DONT KNOW WHAT YOU ARE DOING!!!! 
  11.  
  12. The author takes no responsibilty if INI files are damaged and no "safety keys" 
  13. are included into the application; therefore its very fast and efficient! 
  14.  
  15. This program was written because the LOTUS INI file editor has some problems. 
  16. The lotus ini editor cannot be sized to a different window size, it comes up 
  17. with this silly window at startup and does not remember the last directory were 
  18. a file was edited. So the basic structure of Real World Programmings INI file 
  19. editor was used and a few things and bugs were changed to make INITOR. 
  20.  
  21.  
  22. ΓòÉΓòÉΓòÉ <hidden> Note ΓòÉΓòÉΓòÉ
  23.  
  24. Note that this editor was written with speed in mind. I am looking after a few 
  25. systems (LanServer 4.0 etc) and needed a quick INI editor to change a few 
  26. settings to make a few applications "behave" a little better. 
  27.  
  28. I got frustrated with LOTUS INI editor because it doesn't remember the last 
  29. path, screen location and comes up with this box at startup telling you its 
  30. dangerous to change something in you INI files (dont we all know?????). So I 
  31. wrote this one and use it (and a few friends too) nearly every day. 
  32.  
  33. An I left out a few things to make this program faster to work with and not 
  34. have to press too many buttons. 
  35.  
  36.  
  37. ΓòÉΓòÉΓòÉ <hidden> Test INI file ΓòÉΓòÉΓòÉ
  38.  
  39. I have included a test INI file which you can load an try out a few things 
  40. before you want to change the "real" ones. It has a number of applications, 
  41. keys and key data in it. The file is taken from my LOTUS AmiPro. 
  42.  
  43. It is the "AMIUSER3.INI" files which contains all the setttings of a user. 
  44.  
  45. The first APPLICATION is the "AMIUSER" in that file. 
  46.  
  47. A KEY is for example the "BACKUPPATH" and the KEYDATA is "H:\AMIPRO\TMP" 
  48. (AmiPro's direcotry on my machine is on "H"). 
  49.  
  50. Try a few things here and you get the idea. 
  51.  
  52. You could test run INITOR'S INI file. Dont worry if you changed something 
  53. incorrectly. Simply re-make in that case using Make default ini file 
  54.  
  55.  
  56. ΓòÉΓòÉΓòÉ <hidden> History of INITOR ΓòÉΓòÉΓòÉ
  57.  
  58.      June 1996: INITOR 1.0 
  59.      June 1996: INITOR 1.1 
  60.         -  added very simple help menu (shows readme file). 
  61.         -  added abilty to edit and add BINARY data (hex data). 
  62.         -  fixed last path saved (path was cut off when longer the 20). 
  63.         -  fixed redraw when canceling add/edit dialog box. 
  64.         -  fixed some data appearing in key data window   when adding new key. 
  65.         -  fixed some data appearing in key data window   when adding new 
  66.            application. 
  67.      September 1996: INITOR 1.2 
  68.         -  added copy action for saving key data. 
  69.         -  added copy action for saving one application and all its keys. 
  70.         -  added entire file copy. 
  71.         -  fixed bug in the hex edit part, too small edit buffer (still only 
  72.            10K). 
  73.         -  fixed bug in memory allocation of data (leak?). 
  74.         -  fixed saving of changed data (quicker and more efficient). 
  75.         -  fixed bug of help file not found (using argument passed to main 
  76.            now). 
  77.         -  fixed a bug in my email address. 
  78.      October 1996: INITOR 1.3 
  79.         -  added reading in of other entire INI file into current INI file (ALL 
  80.            OF IT). 
  81.      October 1996: INITOR 1.4 
  82.         -  fixed "cancel" button in the edit application dialog box. 
  83.         -  added display of error message when incorrect INI file is used for 
  84.            reading/writing. 
  85.         -  changed the font in the hex box to courier (monospaced). 
  86.         -  added reading in of applications from other file into current INI 
  87.            file. 
  88.      October 1996: INITOR 1.5 
  89.         -  Icons can now be dropped onto INITOR. 
  90.         -  On the commandline you can call up INITOR with a filename specified. 
  91.         -  POPUP menus now working. 
  92.         -  Accelerate Keys now working. 
  93.         -  Partly fixed the memory usage. 
  94.         -  Rearranged the menus so there's now a FileMenu. 
  95.         -  Menus now include accelerator key names. 
  96.         -  Use TAB key now to jump between Application and Key window and 
  97.            scroll with key to the next item. 
  98.         -  There are now two paths to be saved to the initor ini file: 
  99.             + path name for display files. 
  100.             + path name for save/read files. 
  101.         -  INITOR has its OWN ini file now. Must/will be located in the same 
  102.            directory as the program itself. 
  103.         -  Fixed: Title specifies name of INI file now correct. 
  104.      October 1996: INITOR 1.6 
  105.         -  Fixed bug of being able to edit application even if "No Entries" 
  106.         -  Fixed wrong display of accelerator keys on the menus. (there I tell 
  107.            my students ALL the time to be careful using copy/paste functions 
  108.            and then I do it myself....) 
  109.         -  added filename to query menus to make sure that the CORRECT key gets 
  110.            deleted! 
  111.         -  added SPLIT/UNSPLIT menu to be able to edit *LARGE* keys (I mean 
  112.            *!LARGE!*) 
  113.      October 1996: INITOR 1.7 
  114.         -  Fixed bug from 1.5 and 1.6 where I forgot to switch of the dynamic 
  115.            inclusion of standard libraries. It was working with on my machine, 
  116.            coz the library was found in one of my path. 
  117.      December 1996 to January 1997: INITOR 2.0 
  118.         -  Fixed: at startup the system and user profile where loaded although 
  119.            only user profile displayed on title bar. 
  120.         -  Fixed: when unzipped first, MY screen location was in the initor.ini 
  121.            file which gave a few people some problems. I have not included my 
  122.            screen location. This will start INITOR the first time with some 
  123.            default location. 
  124.         -  Fixed: The Display area (HexBytes) did NOT display correctly bytes 
  125.            above 7F. I did not cast (c term) a value past to a long to 
  126.            (hex)string (sprintf) conversion function. It saw the upper byte a 
  127.            the negative flag. 
  128.         -  Fixed: When saving using the HEX WINDOW and adding a byte to the 
  129.            already existing value I had forgotten to recalculate the string 
  130.            length when passing it back to the window string function (once 
  131.            again rather stupid, indeed). 
  132.         -  Fixed (not my fault): When the ASCII string in the was less then 7 
  133.            bytes long it was NOT displayed on the ASCII display of the key 
  134.            display area. I have no idea, why this is the case. I calculated it 
  135.            properly but could not see the reason, so I made it constant and it 
  136.            works. This does not influence the performance of the editor but 
  137.            does get to my nerves since it is an ugly "help" and doesnt suit my 
  138.            philosophy of making things (nearly) perfect. 
  139.         -  Fixed: The vertical scroll bar now scrolls page wise, too. 
  140.         -  Fixed: When moving through the keys one at a time, and one of the 
  141.            keys would contain no data, the previous value was displayed intead 
  142.            of an empty data window. 
  143.         -  added context sensitive help and proper help menu, hence the new 
  144.            major number of INITOR. 
  145.         -  added copy option to copy an application or key to the current INI 
  146.            file but with a new name. 
  147.         -  changed: the screen location is now saved upon exit of the program. 
  148.            This was suggested by a number of users. 
  149.         -  added some settings into the initor.ini file. This stops 
  150.            confimations to pop up or to stop INITOR to save its screen location 
  151.            upon exit. 
  152.      April 1997: INITOR 2.1 
  153.         -  The compile and design platform of INITOR has been for a while 
  154.            Merlin. The compiler used up to February 1997 was Borland's C++. Now 
  155.            the compiler has changed to: Visual Age C++ for OS/2 by IBM. 
  156.         -  added feature to save applications, keys and key data to an ASCII 
  157.            HEX file to be able to read the data using a normal ASCII editor and 
  158.            to compare different ASCII file with each other. 
  159.         -  changed some of the memory allocation calls, should use less memory 
  160.            from now on! 
  161.      April 1997: INITOR 2.2 I forgot to include the static link option in my 
  162.       compiler setup which led to problems that people did not have the 
  163.       libraries available. I appologize for this one, and it wasn't the first 
  164.       time it had happened. (See above). 
  165.  
  166.  
  167. ΓòÉΓòÉΓòÉ <hidden> Acknowledgements ΓòÉΓòÉΓòÉ
  168.  
  169. Below I would like to thank some people for bug reports, suggestions and ideas. 
  170.  
  171.      IBM for their C and C++ platform "Visual Age C++ for OS/2". I have seen a 
  172.       number of compilers in my time, but this beats everything! 
  173.      Blain, Delimon, and English for their excellent book "Real World 
  174.       Programming for OS/2 (1993)" from which some parts of this programs 
  175.       source code was taken. 
  176.      Jim  Gawn fo hos input of not fully setup vertical scroll bars of data 
  177.       window. I simply did not include code for it. 
  178.      Erwin Hogeweg for his input for large keys, this let to the split key 
  179.       menus. This was due to the limitation of a listbox being not able to show 
  180.       large data sizes. 
  181.      Raman Samanya for the idea of mouse button pop up menus, accelerator keys 
  182.       and switching off confirmation. 
  183.      Kevin Yank and Andreas Schlemmer for his idea passing the filename to be 
  184.       opened as a commandline option and hence being able to drop and 
  185.       associate. 
  186.      Tomi Soini for pointing out that the FILE_ID.DIZ file was missing in the 
  187.       zip file. 
  188.      Pat Shanahan for pointing out that there was a missing library when 
  189.       running INITOR 1.6! I switch off a lot of things during design to make 
  190.       compilation faster and I forgot to reset this when I put it onto the net 
  191.       (dynaimc versus static linking). 
  192.      Thomas Ho for reporting that the incorrect files where loaded upon 
  193.       startup (system ini and user ini where loaded). 
  194.      Traugot Ziegler, Reinhart Gruhn, Don Woodall, Mike Ryan for pointing out 
  195.       that the program ran off the screen upon startup. I had included into 
  196.       "initor.ini" my screen configuration which runs on 1024x768. People using 
  197.       lower screen resolutions ran into problems. 
  198.      Andre Nancoz for pointing out some errors in saving using the hex window. 
  199.       This was only the case when a key was increased by a byte and not saved 
  200.       before. He pointed out, too, that some keys DO NOT have "0" as an ending. 
  201.       This did not damage keys but just increased keys by one byte ending it 
  202.       with a "0". (Well when testing it you save things lots of times.....). 
  203.      Andre Nancoz for pointing out that in case a key had 0 data bytes the 
  204.       previous key was displayed. 
  205.  
  206.  
  207. ΓòÉΓòÉΓòÉ <hidden> Enhancements for the future ΓòÉΓòÉΓòÉ
  208.  
  209.      Be able to read ASCII HEX DATA file into current INI file. This would 
  210.       make it very easy to use a text editor to make up entries for an INI file 
  211.       and simply load them into the current INI file. The "other" option saving 
  212.       is already installed. 
  213.      Now that I have Visual Age C++ from IBM and the MultiLine listboxes with 
  214.       sizes greater the 64K are properly implemented I will redesign the 
  215.       editing part and make it part of the bottom window of the main canvas 
  216.       with an option of saving or not saving (I always wanted to do this!!!!). 
  217.      Open two windows of INITOR and copy/paste between editors to get/save 
  218.       keys??? 
  219.      Some person suggested, to include a function like INIMAINT CTRL-F10 to 
  220.       clean up some junk. I have to figure out how to do this. Maybe somebody 
  221.       can give me a hand or hints??? 
  222.  
  223.  Other ideas anyone???? Suggestions. 
  224.  
  225.  Send suggestions and ideas to the author. Find the address in the about menu. 
  226.  
  227.  
  228. ΓòÉΓòÉΓòÉ <hidden> Compatibility of INITOR ΓòÉΓòÉΓòÉ
  229.  
  230. It has run on a number of systems with different types of WARP installed. This 
  231. program is designed and compiled from April 1997 onwards using IBM's Visual Age 
  232. C++ for OS/2. 
  233.  
  234. I (and a friend of mine) use this program for system administration purposes. 
  235. We looking after systems with different configurations and flavour of OS/2: 
  236.  
  237.      Warp plain 
  238.      Warp fixpak5 
  239.      Warp fixpak10 
  240.      Warp fixpak17 
  241.      Warp fixpak26 
  242.      Warp Server 4.0 
  243.      Merlin (design and compilation platform of INITOR) with and without 
  244.       fixpak 1. 
  245.  
  246.  
  247. ΓòÉΓòÉΓòÉ <hidden> Bugs of the program ΓòÉΓòÉΓòÉ
  248.  
  249. I tested this thouroughly and it worked fine with me and one other person, but 
  250. as you can see in the history and the acknowledgements, a few bugs came up 
  251. anyway. 
  252.  
  253. NOTE! 
  254. One user reported data loss when deleting a number of different applications at 
  255. the same time. I have tried and tried following his instructions but I cant 
  256. "replay" it. 
  257.  
  258. PLEASE! 
  259. Report bugs to the author! 
  260.  
  261.  I really would like to hear from you if you found any, so I can enhance the 
  262. program. I believe in (some) free stuff. 
  263.  
  264.  
  265. ΓòÉΓòÉΓòÉ <hidden> Contact the Author ΓòÉΓòÉΓòÉ
  266.  
  267. Jobst Schmalenbach 
  268. 19 York Street 
  269. Caulfield South, Vic, 3162 
  270. Australia 
  271.  
  272. Home phone: 61 3 9523 7348 
  273. Work phone: 61 3 9905 5705 
  274.  
  275. Email: jobst@senna.eng.monash.edu.au 
  276.  
  277.  
  278. ΓòÉΓòÉΓòÉ 2. Help Menu ΓòÉΓòÉΓòÉ
  279.  
  280. Use the choices on the Help pull-down to display: 
  281.  
  282.  Help index 
  283.        Displays the index of help menu. 
  284.  
  285.  General Help 
  286.        Displays some information about INITOR program. 
  287.  
  288.  Keys Help 
  289.        Displays a list of keys usage. 
  290.  
  291.  Using Help 
  292.        Provides detailed information on the kinds of help available and how to 
  293.        use help. 
  294.  
  295.  Product Information 
  296.        The dialog displays information about the address of the author and 
  297.        version number of the product. 
  298.  
  299.  
  300. ΓòÉΓòÉΓòÉ 3. Using Help ΓòÉΓòÉΓòÉ
  301.  
  302. Displays some general help information about INITOR program. This includes 
  303. basic operation and hints. 
  304.  
  305.  
  306. ΓòÉΓòÉΓòÉ 4. Using Help ΓòÉΓòÉΓòÉ
  307.  
  308. Use this choice to obtain information on how to use the Help facility. 
  309.  
  310.  
  311. ΓòÉΓòÉΓòÉ 5. Accelerator Keys ΓòÉΓòÉΓòÉ
  312.  
  313. Use this choice to see a list of keys and a description of the function of the 
  314. keys for the INITOR program. 
  315.  
  316. Accelerator keys simply are keys offering quick access to menus, which only 
  317. could be accessed using at least two clicks with the mouse. For example to get 
  318. to the "Copy Key" function, you need to click on "Copy" and then on "Copy Key". 
  319. Using the keyboard you can simply press "Shift-c". 
  320.  
  321. Press here to see more keys. 
  322.  
  323.  
  324. ΓòÉΓòÉΓòÉ 5.1. Key Assigments ΓòÉΓòÉΓòÉ
  325.  
  326. ACCELERATOR KEYS 
  327.  
  328. The list of keys is arranged in groups. 
  329.  
  330. HELP KEYS 
  331.  
  332.  F1 
  333.       Help Index Window 
  334.  
  335.  SHIFT F1 
  336.       Keys Help Window 
  337.  
  338.  Esc 
  339.       Previous Help Panel, or End help if only one panel 
  340.  
  341.  Alt 
  342.       Switch IN/OUT action bar 
  343.  
  344.  Alt+F4 
  345.       End help or End program 
  346.  
  347.  SYSTEM KEYS 
  348.  
  349.  Alt+Esc 
  350.       Switch to the next program, including full-screen programs 
  351.  
  352.  Ctrl+Esc 
  353.       Switch to the Task List 
  354.  
  355.  WINDOW KEYS 
  356.  
  357.  Underlined letter 
  358.       Move among the choices on the action bar and pull-downs submenu or 
  359.       execute the function chosen 
  360.  
  361.  INITOR SPECIFIC KEYS 
  362.  
  363.  SHIFT+A 
  364.       Display the Product Information (About) Dialog Box. 
  365.  
  366.  SHIFT+U 
  367.       Load the USER PROFILE into the editor. 
  368.  
  369.  SHIFT+S 
  370.       Load the SYSTEM PROFILE into the editor. 
  371.  
  372.  SHIFT+P 
  373.       Load the USER PROFILE and SYSTEM PROFILE into the editor. 
  374.  
  375.  SHIFT+O 
  376.       Load the a user specified INI file into the editor. A dialog box will pop 
  377.       up and a filename can be specified. 
  378.  
  379.  SHIFT+R 
  380.       Refresh current INI file (reload). 
  381.  
  382.  ALT+X 
  383.       Quit program. 
  384.  
  385.  BACKSPACE 
  386.       Split current key into chunks of 8000 bytes, such that it can be used for 
  387.       dialog boxes. 
  388.  
  389.  SHIFT+BACKSPACE 
  390.       UN-split current set of keys to make it one key again. 
  391.  
  392.  SPACE 
  393.       Edit current application using the ASCII editor. 
  394.  
  395.  SHIFT+SPACE 
  396.       Edit current application using the HEX editor. 
  397.  
  398.  INSERT 
  399.       Add a new application to current INI file. 
  400.  
  401.  SHIFT+INSERT 
  402.       Add a new KEY to current application. 
  403.  
  404.  DELETE 
  405.       Delete current APPLICATION. 
  406.  
  407.  SHIFT+DELETE 
  408.       Delete current KEY. 
  409.  
  410.  SHIFT+C 
  411.       Copy current application to a new application with a different name. 
  412.  
  413.  CONTORL+SHIFT+C 
  414.       Copy current key to a new key with a different name. 
  415.  
  416.  TAB 
  417.       Switch between windows. This selects either KEY or APPLICATION window 
  418.       such that it can be scrolled using keys. 
  419.  
  420.  
  421. ΓòÉΓòÉΓòÉ <hidden> Moving around ΓòÉΓòÉΓòÉ
  422.  
  423. You simply click on an application to go to another application in the 
  424. "Application Name" Window using scroll bars as well. 
  425.  
  426. You can use the TAB key to switch between the applicatio or key windows and 
  427. scroll using the cursor keys. 
  428.  
  429. All key names of that application will be displayed in the "Key Name" window. 
  430.  
  431. The data of the first key will be displayed in HEX and ASCII. If you need 
  432. another key, click on another key and the new data will be displayed with 
  433. offset and the number of bytes in HEX and ASCII. 
  434.  
  435.  
  436. ΓòÉΓòÉΓòÉ 6. File Menu Help ΓòÉΓòÉΓòÉ
  437.  
  438. If you want to change to another INI file click on "File" (ALT-f). 
  439.  
  440.      You can choose: 
  441.         -  USER INI FILE (os2.ini) 
  442.         -  SYSTEM INI FILE (os2sys.ini) 
  443.         -  USER AND SYSTEM FILE (above together) 
  444.         -  Other INI files (eg. AmiPro's INI FILES) 
  445.  
  446.         -  Refresh will update the display, thus re-read the current INI file. 
  447.         -  Exit will close INITOR. 
  448.  
  449.  
  450. ΓòÉΓòÉΓòÉ <hidden> Open User Profile ΓòÉΓòÉΓòÉ
  451.  
  452. If you click on this menu item, the user profile (OS2.INI) will be loaded into 
  453. the editor. 
  454.  
  455.  
  456. ΓòÉΓòÉΓòÉ 6.1. Open System Profile ΓòÉΓòÉΓòÉ
  457.  
  458. If you click on this menu item, the system profile (OS2SYS.INI) will be loaded 
  459. into the editor. 
  460.  
  461.  
  462. ΓòÉΓòÉΓòÉ 6.2. Open User and System Profile ΓòÉΓòÉΓòÉ
  463.  
  464. If you click on this menu item, the system profile (OS2SYS.INI) and the user 
  465. profile (OS2.INI) will both be loaded into the editor. 
  466.  
  467.  
  468. ΓòÉΓòÉΓòÉ 6.3. Refresh ΓòÉΓòÉΓòÉ
  469.  
  470. Refresh will update the display, thus re-read the current INI file. 
  471.  
  472.  
  473. ΓòÉΓòÉΓòÉ 6.4. Exit ΓòÉΓòÉΓòÉ
  474.  
  475. Exit will close INITOR. 
  476.  
  477. This will also save the current screen location into the INITOR.INI file. You 
  478. an change the default saving of the window position using the explanation under 
  479. the meu Initor's own INI file. 
  480.  
  481.  
  482. ΓòÉΓòÉΓòÉ 6.5. Open Other Profile ΓòÉΓòÉΓòÉ
  483.  
  484. This option will allow you to open a particular INI file. 
  485.  
  486. This can be ANY INI file as long as it conforms to the INI file data standards. 
  487.  
  488. Example INI files would be: AMIPRO.INI, AMIUSER.INI, TCPOS2.INI and even 
  489. INITOR's "initor.ini". 
  490.  
  491. Once you clicked on this item a file dialog box will pop up and you can specify 
  492. (or find) the INI file you like to edit. 
  493.  
  494. The default "open" directory can be changed using Save Display Path. 
  495.  
  496.  
  497. ΓòÉΓòÉΓòÉ 6.6. Make default ini file ΓòÉΓòÉΓòÉ
  498.  
  499. A new "initor.ini" file for INITOR is made. When this menu option is chosen the 
  500. following new applications and keys are made which are used during operation of 
  501. INITOR! 
  502.  
  503.      Basic Configuration 
  504.         -  Display Path 
  505.         -  SaveRead Path 
  506.         -  SaveScreenPositionOnClose 
  507.         -  ScreenPosition 
  508.      Confirmations 
  509.         -  ConfirmDelete 
  510.         -  ConfirmSplit 
  511.  
  512.  See the help menu Initor's own INI file for further explanation. 
  513.  
  514.  
  515. ΓòÉΓòÉΓòÉ 7. Initor's own INI file ΓòÉΓòÉΓòÉ
  516.  
  517. INITOR uses its own INI file "initor.ini" to find some configuration values at 
  518. run time. Each one of the entries in the INITOR's ini file is explained below 
  519. with application name, key name and possible values and how the values 
  520. influence the perfomrmance of initor. 
  521.  
  522. Rather then adding a menu to INITOR the user can simply change the values (and 
  523. hence the behaviour) by editing using INITOR the file initor.ini in INITOR's 
  524. directory. 
  525.  
  526. If something went wrong the user can simly re-make a new initor.ini file using 
  527. default configurations. See hereof Make default ini file. 
  528.  
  529. The application name is first, the key name is named second. 
  530.  
  531.      "Basic Configuration" - "Display Path" 
  532.       This value is a string constant and contains the path of the last opened 
  533.       "other" ini file. If changed the dialog box of open other will have the 
  534.       new path entry. 
  535.       See Menu: Save -> DisplayPath. 
  536.  
  537.      "Basic Configuration" - "SaveRead Path" 
  538.       This value is a string constant and contains the value of the last saved 
  539.       to directory, that is using the menu Save. 
  540.       See Menu: Save -> ReadPath. 
  541.  
  542.      "Basic Configuration" - "SaveScreenPositionOnClose" 
  543.       Ths value is a string constant and can only have the values "ON" or 
  544.       "OFF". When set to "ON" the current screen location of the INITOR is 
  545.       saved to the initor.ini file. When set to "OFF" screen location saving 
  546.       can only be done using the menu "save screen location". 
  547.       See Menu: Save -> SaveScreenLocation. 
  548.  
  549.      "Basic Configuration" - "ScreenPosition" 
  550.       This value are for unsigned long integer and make up the dimensions of 
  551.       the window upon startup and contains the location when screen poisition 
  552.       is saved. This is also set to the current location when a new ini  file 
  553.       is produced. 
  554.       See Menu: Save -> SaveScreenLocation. 
  555.  
  556.      "Confirmations" - "ConfirmDelete" 
  557.       This is a string and can either be set to "ON" or "OFF". If set to "ON" a 
  558.       confirmation box will appear before deletion of application and keys. If 
  559.       set to "OFF" this application box will not appear and the applications 
  560.       and keys are deleted straight away! 
  561.  
  562.      "Confirmations" - "ConfirmSplit" 
  563.       This is a string and can either be set to "ON" or "OFF". If set to "ON" 
  564.       it will ask for confirmation to split a key (unsplit a key). If set to 
  565.       "OFF" it will not ask and split/unsplit the key straight away!. 
  566.  
  567.  
  568. ΓòÉΓòÉΓòÉ 8. Edit Items Menu Help ΓòÉΓòÉΓòÉ
  569.  
  570. To change the data of an  application use "Edit Application" (alt-e). 
  571.  
  572. A Dialog box will appear to either edit an application or key in ASCII  or HEX. 
  573.  
  574. You cannot change the application name, that is set read only but you can 
  575. change the key name and the data. If you need to change an application to a 
  576. different name use Copy Items providing a way to change the name of an 
  577. application. 
  578.  
  579.  
  580. ΓòÉΓòÉΓòÉ 8.1. Edit Application (ASCII) ΓòÉΓòÉΓòÉ
  581.  
  582. This dialog box has the application in the first row, the key name in the 
  583. second and the data in the listbox underneath. 
  584.  
  585. This dialog box is for ASCII strings with values above 32 and below 127 
  586. (ASCII). If key data is shown with values below 32 you can click on "HEX" 
  587. button and another dialog box appears to be able to change binary data. See 
  588. Edit Application (Hex) 
  589.  
  590. If you want to edit keys larger than 10500 bytes you might consider reading the 
  591. SPLIT and UNSPLIT  found in other sections of this manual. 
  592.  
  593.  
  594. ΓòÉΓòÉΓòÉ 8.2. Edit Application (Hex) ΓòÉΓòÉΓòÉ
  595.  
  596. This dialog box is for ASCII strings with values below 32 and above 127. 
  597.  
  598. If you clicked on the HEX button in the "ADD-EDIT" dialog box above a dialog 
  599. box appears to edit hex (binary) data. 
  600.  
  601. Just edit data as required keeping a space between each BYTE and use HEX and 
  602. BINARY numbers to enter data into the window. 
  603.  
  604. You must keep a space between each byte or else your data will not be accepted. 
  605. The box will stay until the data is accepted or you press CANCEL. 
  606.  
  607. You must end the data in the hex window with a "00" and a space. The "00" is 
  608. part of the key data in the INI files and the space is the programs way to 
  609. determine a byte separated from another byte. 
  610.  
  611. I dont think this is a major problem although it might seem a little awkward in 
  612. the first place. 
  613.  
  614. If you want to edit keys larger than 10500 bytes you might consider reading the 
  615. SPLIT and UNSPLIT  found in other sections of this manual. 
  616.  
  617.  
  618. ΓòÉΓòÉΓòÉ 9. Add Items Menu Help ΓòÉΓòÉΓòÉ
  619.  
  620. If you need to add a new application or add a new key to an existing 
  621. application choose "Add Items" (ALT-A). 
  622.  
  623. You have then two options to either add a new application or a new key. Both of 
  624. the options require to add some data as well. 
  625.  
  626.  
  627. ΓòÉΓòÉΓòÉ 9.1. Add New Application ΓòÉΓòÉΓòÉ
  628.  
  629. This option adds a new application to the INI file. An application is for 
  630. example "AmiPro" or "Netscape" found in the user (OS2.INI) file. If you add a 
  631. new application it will be sorted alphabetically (not in the INI file). You 
  632. must give a new key and data as well, otherwise the application will not be 
  633. accepted. 
  634.  
  635.  
  636. ΓòÉΓòÉΓòÉ 9.2. Add New Key ΓòÉΓòÉΓòÉ
  637.  
  638. This option adds a new KEY to the current application pointed at. A new key 
  639. would be for example "TMPPATH" with data (maybe) "H:\tmp" for and application 
  640. "BackupDir". 
  641.  
  642.  
  643. ΓòÉΓòÉΓòÉ 10. Delete Items Menu Help ΓòÉΓòÉΓòÉ
  644.  
  645. If you need to delete a key or application click on "Delete Items" (ALT-d). 
  646.  
  647. This will delete either the current application or current key depending on 
  648. which of the menus Delete Application  or Delete Key  you have chosen. 
  649.  
  650. You are asked for confirmation to delete the key or application. The 
  651. application or key name is displayed on the query menu, so you know which key 
  652. it is. 
  653.  
  654. You can switch off confirmation. See hereof the help item Initor's own INI 
  655. file. 
  656.  
  657.  
  658. ΓòÉΓòÉΓòÉ 10.1. Delete Application ΓòÉΓòÉΓòÉ
  659.  
  660. This will delete the applcation pointed at with all keys belonging to THAT 
  661. application and the data belonging to the keys. An application example: 
  662. "AMIUSER" in the provided test.ini! 
  663.  
  664.  
  665. ΓòÉΓòÉΓòÉ 10.2. Delete Key ΓòÉΓòÉΓòÉ
  666.  
  667. This will delete the key and the data. 
  668. A key example of above application "BackUpPath" 
  669.   Data (maybe) for the above key "H:\tmp" 
  670.  
  671. If the key was the only  key to the application, the application is deleted as 
  672. well. 
  673.  
  674.  
  675. ΓòÉΓòÉΓòÉ 11. Copy Items Menu Help ΓòÉΓòÉΓòÉ
  676.  
  677. This option allows you to copy an application or a key with a different name 
  678. into the current INI file. You could use this option for example with IBM's 
  679. "TCPOS2.INI" which contains information for the dialer. You can copy an 
  680. existing dialer setting (application) to another name an change a few settings. 
  681. This will save a fair amount of time clicking through the setup. 
  682.  
  683. This option is also useful to save an application or key before you want to 
  684. make some changes. In case something went wrong you can simply copy it back. 
  685.  
  686. A dialog box will pop up and ask you for the new name. Note that you cannot 
  687. change the "from" value, it is read only. 
  688.  
  689. You can either copy a complete application or a single key . 
  690.  
  691.  
  692. ΓòÉΓòÉΓòÉ 11.1. Copy Application ΓòÉΓòÉΓòÉ
  693.  
  694. This option copies an entire application with all its keys and data to a new 
  695. application with a different name but same content. 
  696.  
  697.  
  698. ΓòÉΓòÉΓòÉ 11.2. Copy Key ΓòÉΓòÉΓòÉ
  699.  
  700. This option copies a key and its data to the same application but with a 
  701. different key name. The data will be identical. 
  702.  
  703.  
  704. ΓòÉΓòÉΓòÉ 12. Save Menu Help ΓòÉΓòÉΓòÉ
  705.  
  706. This menu will save data of INI files and configuration items from INITOR. 
  707.  
  708. Saving INI file data can be done using two types of saving actions: 
  709.  
  710.      Save data to other INI  file(s) 
  711.      Save data to ASCII HEX  file(s). 
  712.  
  713.  Using the following items: 
  714.  
  715.      Save Display Path 
  716.      Save Read Path 
  717.      Save Location 
  718.  
  719.  some of INITOR's own configuration items can be saved into its own INI file. 
  720.  
  721.  
  722. ΓòÉΓòÉΓòÉ 13. Save Data to other INI file ΓòÉΓòÉΓòÉ
  723.  
  724. If you want to save (or copy) an application or key to another file you may do 
  725. so by using the save menu (ALT-s). 
  726.  
  727. The options available are: 
  728.  
  729.      Save Application to other (INI) File 
  730.       This option saves ALL KEYS of one (selected) APPLICATION to a new 
  731.       (specified) file. 
  732.      Save Key to other (INI) File 
  733.       This option saves ONE (selected) KEY of one (selected) APPLICATION to a 
  734.       new (specified) file. 
  735.      Save ALL to other (INI) File 
  736.       This option saves all information of the current file to a new 
  737.       (specified) file. 
  738.  
  739.  After you clicked on one of the three you are asked (dialog box) to specify 
  740.  the file name. If you specify an existing file the information is simply added 
  741.  to the file. If the file already exists, but is NOT a proper INI file, an 
  742.  error message will be displayed and nothing will happen. 
  743.  
  744.  The currently selected item in either of the lists will be the item to be 
  745.  saved to a file selected in the file dialog box. 
  746.  
  747.  If applications or keys with the same name exist in the OPENED file, they are 
  748.  simply overwritten. So you must make sure you do not overwrite the current 
  749.  application in the "save to" file. (You could simply open another copy of the 
  750.  INITOR.) 
  751.  
  752.  
  753. ΓòÉΓòÉΓòÉ 14. Save Data to other ASCII HEX file ΓòÉΓòÉΓòÉ
  754.  
  755. If you want to save (or copy) an application or key to another file in ASCII 
  756. HEX format you may do so by using the save menu (ALT-s) and then selecting one 
  757. of the following options: 
  758.  
  759.      something to say for Save Application to ASCII HEX file 
  760.      something to say for Save Key to ASCII HEX file 
  761.      something to say for Save All to ASCII HEX file 
  762.  
  763.  
  764. ΓòÉΓòÉΓòÉ 15. Save configuration options of INITOR ΓòÉΓòÉΓòÉ
  765.  
  766. Some of initors options used during run time can be saved using the following 
  767. options: 
  768.  
  769.      Save Display Path 
  770.       This option saves the path of the directory last read from, that is the 
  771.       directory of the last file opened using the option 
  772.  
  773.      Save Read Path 
  774.       This option saves the path of the directory last read saved to, that is 
  775.       the directory where ini files are written to. 
  776.  
  777.      Save Window Position 
  778.       This option save the current window location. This option is only of use 
  779.       if the save window upon exit is disabled. 
  780.  
  781.  
  782. ΓòÉΓòÉΓòÉ 16. Read Menu Help ΓòÉΓòÉΓòÉ
  783.  
  784. If you want to read data from a specified INI file into the current displayed 
  785. file simply click on (ALT-r): 
  786.  
  787. There are two choices to read from another file into the current file: 
  788.  
  789.      Read Application from other file. 
  790.      Read other INI file into current file. 
  791.  
  792.  Once you clicked on one of the items, you are asked to specify a filename to 
  793.  read from. 
  794.  
  795.  If you specify a new file it is opened (for saving only). 
  796.  
  797.  If you specify an existing file it is checked and if it's not a proper INI 
  798.  file an error message will be displayed and nothing happens. 
  799.  
  800.  
  801. ΓòÉΓòÉΓòÉ 16.1. Read Application ΓòÉΓòÉΓòÉ
  802.  
  803. Load the INI file you want to add the data and click on the READ menu to "Read 
  804. Application from other file". Once you selected a source file you are asked 
  805. using a select dialog box which application(s) you want to read into the 
  806. current INI file. 
  807.  
  808. Simply select each of the items you want and then click on OK. 
  809.  
  810. If a KEY/APPLICATION of a name in the current file exists, it is simply 
  811. overwritten. No check is made. 
  812.  
  813.  
  814. ΓòÉΓòÉΓòÉ 16.2. Read other INI file ΓòÉΓòÉΓòÉ
  815.  
  816. Load the INI file you want to add data to into INITOR and click on the READ 
  817. menu to "Read other ini file into current". Once you selected to source file in 
  818. the file dialog box and pressed OK the complete file is read into the current 
  819. file and if a KEY or APPLICATION of a name in the current file exists, it is 
  820. simply overwritten. No check is made. 
  821.  
  822.  
  823. ΓòÉΓòÉΓòÉ 17. Split Menu Help ΓòÉΓòÉΓòÉ
  824.  
  825. There is a limitation of how many bytes one can display in a dialog box. 
  826.  
  827. This is set to 32K. However, the HEX editor needs for each byte displayed 3 
  828. bytes to display the entity. (32K / 3) > 10500bytes. 
  829.  
  830.  Therefore if you need to edit a key which is larger than 10500 bytes you need 
  831. to split the key first. Using the SPLIT item from the MISC MENU will split the 
  832. key into 8000 byte chunks, with the last being the remainder of the key, hence 
  833. a 19396 byte long key is split into 2x8000 and 1x3396. 
  834.  
  835. You need to place the cursor on the key to be split. 
  836.  
  837. Using Unsplit will reverse the operation. 
  838.  
  839. Consider the unsplit key is called "testing" and its 19396 long. than the split 
  840. keys are called and sized: 
  841.  
  842.      testing_Initor SplitKey_1, 8000 
  843.      testing_Initor SplitKey_2, 8000 
  844.      testing_Initor SplitKey_3, 3396 
  845.  
  846.  Please leave the names until you unsplit them otherwise the program has no way 
  847.  to find out which key is split and which of the keys belong together. When 
  848.  unsplitting the cursor must be placed on the first key to unsplit. 
  849.  
  850.  
  851. ΓòÉΓòÉΓòÉ 17.1. Split Key ΓòÉΓòÉΓòÉ
  852.  
  853. Using this option will split the key into 8000 byte chunks, with the last being 
  854. the remainder of the key, hence a 19396 byte long key is split into 2x8000 and 
  855. 1x3396. You need to place the cursor on the key to be split. 
  856.  
  857.  
  858. ΓòÉΓòÉΓòÉ 17.2. Unsplit Key ΓòÉΓòÉΓòÉ
  859.  
  860. Using this option will put the keys together again. 
  861.  
  862. If you have edited one of the split keys this will produce a larger key or 
  863. smaller key than the original one, depending on what you have done with the 
  864. split keys. 
  865.  
  866.  
  867. ΓòÉΓòÉΓòÉ 18. PopUp Menus ΓòÉΓòÉΓòÉ
  868.  
  869. POPUP menus are selected when the right mouse button is pressed in either of 
  870. the windows (application or key). 
  871.  
  872. There are two POPUP menus availabe depending the window the cursor is on: 
  873.  
  874.      If the cursor is in the application window, the following popup is 
  875.       displayed: 
  876.         -  Add Application 
  877.         -  Copy Application 
  878.         -  Save Application 
  879.         -  Delete Application 
  880.         -  Edit Application ASCII 
  881.         -  Edit Application HEX 
  882.         -  Refresh 
  883.      If the cursor is in the key window, the following popup is displayed: 
  884.         -  Add Key 
  885.         -  Copy Key 
  886.         -  Save Key 
  887.         -  Delete Key 
  888.         -  Refresh 
  889.  
  890.  If you do not select anyone of the items, nothing will happen. You must hold 
  891.  the right mouse as long as you want to select something. The popup menu 
  892.  disappears as soon as the mouse button is released.