home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 8 / CDACTUAL8.iso / share / os2 / utilidad / initor / readme.1st < prev   
Encoding:
Text File  |  1996-10-17  |  20.6 KB  |  485 lines
  1. ---------------------------------------------------------------------------
  2. |                                                                         |
  3. | Initor 1.7 ( INIfile ediTOR )                                           |
  4. |                                                                         |
  5. | OS2 Ini File Editor                                                     |
  6. | CopyRight (C) 1996 Jobst Schmalenbach                                   |
  7. |                                                                         |
  8. | Email: jhs@dgs.monash.edu.au                                            |
  9. |                                                                         |
  10. | Snail Mail:  Jobst Schmalenbach                                         |
  11. |              19 York Street                                             |
  12. |              Caulfield South, VIC, 3162                                 |
  13. |              Australia                                                  |
  14. |                                                                         |
  15. |                                                                         |
  16. |            The file README.1ST and the file LICENSE.TXT                 |
  17. |                    BE KEPT TOGETHER WITH INITOR!                        |
  18. |                                                                         |
  19. ---------------------------------------------------------------------------
  20. This file and the file LICENSE.TXT must be kept together with the INITOR.
  21. (If not may your inner conscious slowly crawling up you back and over your
  22.  head and give you a terrible freight when you finally see it in front.)
  23. This program is free software; you can redistribute it and/or modify
  24. it under the terms of the attached License.
  25. This program is distributed in the hope that it will be useful,
  26. but WITHOUT ANY WARRANTY; without even the implied warranty of
  27. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  28. attached License for more details.
  29. You should have received a copy of the file LICENSE.TXT
  30. along with this program; if not, write to the author below.
  31.  
  32. ___________________________________________________________________________
  33. ___________________________________________________________________________
  34.  
  35. WHAT DOES THIS PROGRAM DO?
  36. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  37. Initor enables you to edit OS2 "INI" files. You are able to add, deleted 
  38. and edit applications, keys and key data. Further more you are able to
  39. save and read data from the current INI file to and from  another INI file.
  40. DO NOT USE THIS PROGRAM IF YOU DONT KNOW WHAT YOU ARE DOING!!!!
  41. I take no responsibilty if you bugger up your INI files and I have NOT
  42. included "safety keys" into the application. 
  43. BUT: therefore its very fast and efficient!
  44. I have written this program because the LOTUS INI file editor drove me nuts!
  45. You cannot size it to a different window size, it comes up with
  46. this silly window at startup and does not remember the last directory were
  47. you edited a file. So I used the basic structure of Real World Programmings
  48. INI file editor and changed a few things and bugs to make INITOR.
  49.  
  50.  
  51. UNZIPPING AND LOCATION OF FILES:
  52. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  53. Since you are reading this file you must have unzipped the archive.
  54. All you need to do now is to copy the files:
  55.     initor.exe
  56.     initor.hlp
  57.     initor.ini
  58. into the same directory. 
  59. You might want to copy the files into a directory of you PATH statement.
  60.  
  61.  
  62. HOW DOES IT WORK?
  63. ~~~~~~~~~~~~~~~~~
  64. Simply start INITOR from the command line or have an icon pointing to this
  65. program somewhere on the desktop. Refer to the OS2 help files how to make
  66. a program icon.
  67.  
  68. You can drop an icon (or specify a filename on the command line) and initor
  69. starts up with that INI file opened. You can associate *.ini with initor
  70. and double click on the INI file icon and INITOR will start up with the
  71. file opend. (see OS/2 reference about association and/or dropping).
  72.  
  73. Initor starts with the "OS2.INI" (USERINI) file opened when no filename
  74. is specified on the command line or double clicked on INITOR icon.
  75.  
  76.  
  77. CHANGING INI FILES:
  78. ~~~~~~~~~~~~~~~~~~~
  79. If you want to change to another INI file click on "File" (ALT-f).
  80.  
  81. You can choose:
  82.   - USER INI FILE (os2.ini)
  83.   - SYSTEM INI FILE (os2sys.ini)
  84.   - USER AND SYSTEM FILE (above together)
  85.   - Other INI files (this could be for example AmiPro's INI FILES)
  86.  
  87. If you click on USER or SYSTEM file the user and/or system INI file are opemed
  88. as set in the enviromental variable which must be set in the config.sys file.
  89. If you choose "Other .." a file dialog box is opened with the directory shown
  90. where INITOR was started up. You can open another (personal) INI file.
  91.  
  92. If file is not an INI file, an error message will be displayed.
  93.  
  94. If you save the path as shown below "Saving ..." the next time you 
  95. open INITOR the file dialog box opens with the last saved path.
  96.  
  97.  
  98. MOVING AROUND:
  99. ~~~~~~~~~~~~~~
  100. You simply click on an application to go to another application in the
  101. "Application Name" Window using scroll bars as well.
  102.  
  103. You can use the TAB key to switch between the applicatio or key windows
  104. and scroll using the cursor keys.
  105.  
  106. All key names of that application will be displayed in the "Key Name" window.
  107.  
  108. The data of the first key will be displayed in HEX and ASCII.
  109. If you need another key, click on another key and the new data will be 
  110. displayed with offset and the number of bytes in HEX and ASCII.
  111.  
  112.  
  113. EDIT KEYS AND KEY DATA:
  114. ~~~~~~~~~~~~~~~~~~~~~~~
  115. To change the data of an  application use "Edit Application" (alt-e).
  116.  
  117. A Dialog box will appear with the application name in the first row,
  118. the key name in the second row and the key data last.
  119.  
  120. You cannot change the application name, that is set read only but you can
  121. change the key name and the data.
  122.  
  123. The first dialog box is for ASCII strings with values above 32 and below
  124. 127 (ASCII). If key data is shown with values below 32 you can click
  125. on "HEX" button and another dialog box appears to be able to change
  126. binary data.
  127.  
  128. If you want to edit keys larger than 10500 bytes you might consider reading
  129. the SPLIT/UNSPLIT option below.
  130.  
  131.  
  132. HEX DATA EDITING:
  133. ~~~~~~~~~~~~~~~~~
  134. If you clicked on the HEX button in the "ADD-EDIT" dialog box above a
  135. dialog box appears to edit hex (binary) data. 
  136.  
  137. Just edit data as required keeping a space between each BYTE and use 
  138. HEX and BINARY numbers to enter data into the window.
  139.  
  140. You must keep a space between each byte or else your data will not
  141. be accepted. The box will stay until the data is accepted 
  142. or you press CANCEL.
  143.  
  144. You must end the data in the hex window with a "00" and a space. 
  145. The "00" is part of the key data in the INI files and the space
  146. is the programs way to determine a byte separated from another byte.
  147.  
  148. I dont think this is a major problem although it might seem a little
  149. awkward in the first place.
  150.  
  151. If you want to edit keys larger than 10500 bytes you might consider reading
  152. the SPLIT/UNSPLIT option below.
  153.  
  154.  
  155. DELETING APPLICATIONS AND KEYS:
  156. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  157. If you need to delete a key or application click on "Delete Items" (ALT-d).
  158.  
  159. "Delete Application" will delete the applcation pointed at with all keys 
  160. belonging to THAT application and the data belonging to the keys.
  161. An application example:  "AMIUSER" in the provided test.ini!
  162.  
  163. "Delete Selected Key" will only destroy the key and the data.
  164. A key example of above application:  "BackUpPath"
  165. Data for the above key:              "d:\tmp"
  166.  
  167. You are asked for confirmation to delete the key/application.
  168. The key name is displayed on the query mennu, so you know which key it is.
  169.  
  170.  
  171. ADDING APPLICATIONS AND KEYS:
  172. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  173. If you need to add a new application or add a key to an existing 
  174. application choose "Add Items" (ALT-A).
  175.  
  176. "Add new application" adds a new application to the INI file. An 
  177. application is for example "AmiPro". If you add a new application 
  178. it will be sorted alphabetically (not in the INI file).
  179.  
  180. "Add new key" adds a new KEY to the current application pointed at.
  181. A new key would be for example "INIPATH" (data in my case: d:\os2).
  182.  
  183.  
  184. SAVING (COPYING) DATA AND SCREEN LOCATION:
  185. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  186. The data is saved automatically when you press OK in the ADD or EDIT
  187. (HEX EDIT) dialog boxes.
  188.  
  189. If you want to save (or copy) an application or key to another file
  190. you may do so by using the save menu (ALT-s): 
  191.  
  192. There are three options available:
  193.     Save Application to other (INI) File
  194.     Save Key to other (INI) File
  195.     Save ALL to other (INI) File
  196.  
  197. After you clicked on one of the three you are asked (dialog box) to specify
  198. the file name. If you specify an existing file the information is simply added
  199. to the file. If the file is NOT a proper INI file an error message will
  200. be displayed and nothing will happen.
  201. If the file opened and if applications or keys with the same name exist
  202. in the OPENED file exist, they are simply overwritten. So you must make sure
  203. you do not overwrite the current application in the "save to" file.
  204. (You could simply open another copy of the INITOR.)
  205.  
  206. The first option saves ALL KEYS of one APPLICATION to a new file.
  207. The second option saves ONE KEY of one APPLICATION to a new file.
  208. The third option saves all information in the current file to a new file.
  209.  
  210. You can save the window location (quite handy) by selecting "Screen Location".
  211.  
  212. You can save the last paths:
  213.     SAVEREAD PATH saves the path of the directory last read from/save to.
  214.     DISPLAY PATH saves the path of the last INI file displayed.
  215.  
  216. These information is stores in a file called INITOR.INI in the programs
  217. directory. You can edit it and have a look at it.
  218.  
  219.  
  220. READING IN OF DATA OF OTHER INI FILES:
  221. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  222. If you want to read data from a specified INI file into the current displayed
  223. file simply click on (ALT-r):
  224.  
  225. There are two choices to read from another file into the current file:
  226.      Read Application form other file.
  227.      Read other INI file into current file.
  228.  
  229. Once you clicked on one of the items, you are asked to specify a filename
  230. to read from. If you specify a new file it is opened (for saving only).
  231. If you specify an existing file it is checked and if it's not a proper INI 
  232. file an error message will be displayed and nothing happens.
  233.  
  234. Read other INI file into current file.
  235. Load the INI file you want to add the data and click on the READ menu 
  236. to read in the data from a specified file. Note that the complete file is read
  237. into the current file and if a KEY/APPLICATION of a name in the current file
  238. exists, it is simply overwritten. No check is made.
  239.  
  240. Read Application form other file:
  241. Load the INI file you want to add the data and click on the READ menu 
  242. to read in the data from a specified file. You are asked afterwards in a 
  243. select dialog box which applications you want to read into the current file.
  244. Simply select each of the items you want an click on OK.
  245. If a KEY/APPLICATION of a name in the current file exists, it is 
  246. simply overwritten. No check is made.
  247.  
  248.  
  249. POPUP MENUS:
  250. ~~~~~~~~~~~~
  251. There are two POPUP menus availabe depending the window the cursor is on.
  252. These POPUP menus are selected when the right mouse button is pressed
  253. in either of the windows.
  254.  
  255. If the cursor is in the application window, the following popup is displayed:
  256.   ADD  Application
  257.   Save Application
  258.   Delete Application
  259.   Edit Application ASCII
  260.   Edit Application HEX
  261.   Refresh
  262.  
  263. If the cursor is in the key window, the following popup is displayed:
  264.   ADD Key
  265.   Save Key
  266.   Delete Key
  267.   Refresh
  268.  
  269. If you do not select anyone of the items, nothing will happen.
  270. You must hold the right mouse as long as you want to select something.
  271. The popup menu disappears as soon as the mouse button is released.
  272.  
  273.  
  274. ACCELERATOR KEYS:
  275. ~~~~~~~~~~~~~~~~~
  276. A number of accelerator keys are available to jump to certain options:
  277.  
  278. SHIFT       A:       Displays the about box.
  279. SHIFT       U:       Loads the USER PROFILE into the editor.
  280. SHIFT       S:       Loads the SYSTEM PROFILE into the editor.
  281. SHIFT       O:       Opens up a diaplog box to load in user specified INI file.
  282. SHIFT       R:       Refreshes data displyed in editor window.
  283. ALT         X:       Exit INITOR.
  284.            F1:       Help window is displayed.
  285. SHIFT   SPACE:       Edit selected application in HEX window.
  286.         SPACE:       Edit selected application in ASCII window.
  287. SHIFT  INSERT:       Add key to selected application.
  288.        INSERT:       Add application to current INI file.
  289. SHIFT  DELETE:       Delete current key selected (Question box appears).
  290.        DELETE:       Delete current application selected.
  291.                      (Question box appears).
  292.           TAB:       Switch between application and key window.
  293.  
  294. The keys are displayed on the menus as well.
  295.  
  296.  
  297. SPLIT AND UNSPLIT KEYS:
  298. ~~~~~~~~~~~~~~~~~~~~~~~
  299. There is a limitation of how many bytes one can display in a dialog box.
  300. This is set to 32K. However, the HEX editor needs fo each byte used 3 bytes
  301. to display the entity. 32K / 3 > 10500bytes.
  302.  
  303. Therefore if you need to edit a key which is larger than 10500 bytes you
  304. need to split the key first. Using the SPLIT item from the MISC MENU will
  305. split the key into 8000 byte chunks, with the last being the remainder
  306. of the key, hence a 19396 byte long key is split into 2x8000 and 1x3396.
  307. You need to place the cursor on the key to be split.
  308.  
  309. Using the UNPLIT option will put the keys together again. If you have edited
  310. one of the split keys this will produce a larger key or smaller key than
  311. the original one, depending on what you have done with the split keys.
  312.  
  313. Consider the unsplit key is called "testing" and its 19396 long.
  314. than the split keys are called and sized:
  315.  
  316.      testing_Initor SplitKey_1, 8000
  317.      testing_Initor SplitKey_2, 8000
  318.      testing_Initor SplitKey_3, 3396
  319.  
  320. Please leave the names until you unsplit them otherwise the program has no
  321. way to find out which key is split and which of the keys belong together.
  322. When unsplitting the cursor must be placed on the first key to unsplit.
  323.  
  324.  
  325. HELP:
  326. ~~~~~
  327. Help is diplayed by using Help on the menu.
  328.  
  329.  
  330. NOTE:
  331. ~~~~~
  332. Note that this editor was written with speed in mind. I am looking 
  333. after a few systems (LanServer 4.0 etc) and needed a quick INI editor 
  334. to change a few settings to make a few applications "behave" a little better. 
  335. I got frustrated with LOTUS INI editor because it doesn't remember the last 
  336. path, screen location and comes up with this box at startup telling you its 
  337. dangerous to change something in you INI files (dont we all know?????).
  338. So I wrote this one and use it (and a few friends too) nearly every day.
  339. An I left out a few things to make this program faster to work with
  340. and not have to press too many buttons.
  341.  
  342.  
  343. TEST INI FILE:
  344. ~~~~~~~~~~~~~~
  345. I have included a test INI file which you can load an try out a few things 
  346. before you want to change the "real" ones. It has a number of applications,
  347. keys and key data in it. The file is taken from my LOTUS AmiPro.
  348. It is the "AMIUSER3.INI" files which contains all the setttings of a user.
  349. The first APPLICATION is the "AMIUSER" in that file.
  350. A KEY is for example the "BACKUPPATH" and the KEYDATA is "H:\AMIPRO\TMP"
  351. (AmiPro's direcotry on my machine is on "H").
  352. Try a few things here and you get the idea.
  353.  
  354. You could test run INITOR'S INI file. Dont worry if you changed something 
  355. incorrectly. Simply resave in that case.
  356.  
  357.  
  358. BUGS:
  359. ~~~~~
  360. I tested this thouroughly and it worked fine with me and one other person,
  361. but as you can see below, a few came up anyway.
  362. This bugs mean that the DATA VALUES are saved/read correctly. I am certain
  363. that these is correct, but they might be some other (non data) related bugs.
  364.  
  365. It has run on a number of systems with different types of WARP installed.
  366. Warp plain, Warp fixpak5, Warp fixpak10, Warp fixpak17.
  367. This program, however, is not fancy. 
  368. It is straight to the point and useful for somebody do some work quickly.
  369.  
  370. PLEASE PLEASE PLEASE PLEASE PLEASE PLEASE PLEASE PLEASE !!!! 
  371. PLEASE                                           PLEASE !!!!
  372. PLEASE          Report bugs to the author.       PLEASE !!!!
  373. PLEASE                                           PLEASE !!!!
  374. PLEASE PLEASE PLEASE PLEASE PLEASE PLEASE PLEASE PLEASE !!!! 
  375.  
  376. Email: jhs@dgs.monash.edu.au
  377.  
  378. I really would like to hear from you if you found any, so I can enhance
  379. the program. I believe in (some) free stuff.
  380.  
  381.  
  382. FUTURE ENHANCEMENTS:
  383. ~~~~~~~~~~~~~~~~~~~~
  384. The memory usage is a bit heavy, will change this to better heap allocation.
  385. Some of the scroll bars and menus havent got ALL functions, soon to come....
  386. Add command line options so the program can be executed without the need 
  387. of a PM window.
  388. Open two windows of INITOR and copy/paste between editors to get/save keys.
  389. Including options to enable/disable query menus (initor.ini).
  390. Other ideas anyone????
  391.  
  392.  
  393. SUGGESTIONS:
  394. ~~~~~~~~~~~~
  395. Very wellcome. Semd me some EMAIL: jhs@dgs.monash.edu.au
  396.  
  397.  
  398. HISTORY:
  399. ~~~~~~~~
  400. June 1996: INITOR 1.0
  401. June 1996: INITOR 1.1
  402.             - added very simple help menu (shows readme file).
  403.             - added abilty to edit and add BINARY data (hex data).
  404.             - fixed last path saved (path was cut off when longer the 20).
  405.             - fixed redraw when canceling add/edit dialog box.
  406.             - fixed some data appearing in key data window 
  407.               when adding new key.
  408.             - fixed some data appearing in key data window 
  409.               when adding new application.
  410. September 1996: INITOR 1.2
  411.             - added copy action for saving key data.
  412.             - added copy action for saving one application and all its keys.
  413.             - added entire file copy.
  414.             - fixed bug in the hex edit part, too small edit buffer.
  415.               (still only 10K).
  416.             - fixed bug in memory allocation of data (leak?).
  417.             - fixed saving of changed data (quicker and more efficient).
  418.             - fixed bug of help file not found.
  419.               (using argument passed to main now).
  420.             - fixed a bug in my email address.
  421. October 1996: INITOR 1.3
  422.             - added reading in of other entire INI file into current INI file.
  423.               (ALL OF IT).
  424. October 1996: INITOR 1.4
  425.             - fixed "cancel" button in the edit application dialog box.
  426.             - added display of error message when incorrect INI file is used
  427.               for reading/writing.
  428.             - changed the font in the hex box to courier (monospaced).
  429.             - added reading in of applications from other file into 
  430.               current INI file.
  431. October 1996: INITOR 1.5
  432.             - Icons can now be dropped onto INITOR.
  433.             - On the commandline you can call up INITOR 
  434.               with a filename specified.
  435.             - POPUP menus now working.
  436.             - Accelerate Keys now working.
  437.             - Partly fixed the memory usage.
  438.             - Rearranged the menus so there's now a FileMenu.
  439.             - Menus now include accelerator key names.
  440.             - Use TAB key now to jump between Application and Key window 
  441.               and scroll with key to the next item.
  442.             - There are now two paths to be saved to the initor ini file:
  443.               + path name for display files.
  444.               + path name for save/read files.
  445.             - INITOR has its OWN ini file now. Must/will be located in the 
  446.               same directory as the program itself.
  447.             - Fixed: Title specifies name of INI file now correct.
  448. October 1996: INITOR 1.6
  449.             - Fixed bug of being able to edit application even if "No Entries"
  450.             - Fixed wrong display of accelerator keys on the menus.
  451.               (there I tell my students ALL the time to be careful using
  452.                copy/paste functions and then I do it myself....)
  453.             - added filename to query menus to make sure that the
  454.               CORRECT key gets deleted!
  455.             - added SPLIT/UNSPLIT menu to be able to edit *LARGE* keys.
  456.               (I mean *!LARGE!*)
  457. October 1996: INITOR 1.7
  458.             - Fixed bug from 1.5 and 1.6 where I forgot to switch of the
  459.               dynamic inclusion of standard libraries. It was working with
  460.               on my machine, coz the library was found in one of my path.
  461.  
  462. WHY FREE?
  463. ~~~~~~~~~
  464. Well, easy. I use a lot of the GNU stuff:
  465.   GTAK, GTAR, emacs, gcc, gnu utils, emtex, ghostview and many many more.
  466. I have used a lot of free stuff as well.
  467. So why shouldn't I make some free programs available?
  468.   
  469.  
  470. AUTHOR:
  471. ~~~~~~~
  472. Jobst Schmalenbach
  473. 19 York Street
  474. Caulfield South, VIC, 3162
  475. Australia
  476.  phone: 61  3 9523 7348
  477. mobile: 61 41 141  6843
  478. EMAIL: jhs@dgs.monash.edu.au
  479.  
  480.  
  481. AND LAST BUT NOT LEAST:
  482. ~~~~~~~~~~~~~~~~~~~~~~~
  483. ENJOY!
  484.  
  485.