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