home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / inicnv.zip / INICNV.HLP (.txt) < prev    next >
OS/2 Help File  |  1992-04-06  |  11KB  |  337 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. The IniCnv application will read program definitions that have been created in 
  5. OS2 1.x style INI files and make OS2 2.0 program folders and references. 
  6.  
  7. IniCnv is a ShareWare program.  Please see the registration topic. 
  8.  
  9. You must specify the source of the INI information by using the File pulldown 
  10. menu. 
  11.  
  12. You may, then, use three dropdown combination list boxes to examine 1.x program 
  13. definitions and select them for conversion. 
  14.  
  15. Use the push buttons that are located at the bottom of the IniCnv window to 
  16. control the selection and conversion processes. 
  17.  
  18. OS2 2.0 is still very new.  Some restrictions apply to this utility. 
  19.  
  20.  
  21. ΓòÉΓòÉΓòÉ 1.1. INI Files ΓòÉΓòÉΓòÉ
  22.  
  23. Initialization (INI) files are created by applications and the system.  The 
  24. primary system INI file is called OS2.INI and normally resides in the OS2 
  25. system directory. 
  26.  
  27. When you created program definintions and program groups under OS2 version 1.2 
  28. and 1.3, records were created in the system INI file that held the information 
  29. that you entered.  IniCnv can read these records and use that information to 
  30. create OS2 2.0 folders and program reference icons. 
  31.  
  32. Other programs may have also created INI files that contain program and group 
  33. records.  One such program is IniUtil.  Files created by IniUtil can also be 
  34. used as input to IniCnv. 
  35.  
  36.  
  37. ΓòÉΓòÉΓòÉ 1.2. Examining Program Info ΓòÉΓòÉΓòÉ
  38.  
  39. The client area of the IniCnv application window will display several different 
  40. items of information: 
  41.  
  42.  Root Folder         Always NFDC 
  43.  SubFolder           Name taken from the 1.x group box.  Will be the folder 
  44.                      that is created in the NFDC root folder, if you press the 
  45.                      convert button. 
  46.  Groups              List of groups from the INI 
  47.  Program Titles      Definition titles found in groups 
  48.  Selected Titles     Titles that you have selected and which will be converted 
  49.                      if you press the convert button. 
  50.  Program Type        Appears under the group list box.  If the program was 
  51.                      defined with NoAutoClose, that will also appear. 
  52.  ExeName             The executeable pathname 
  53.  Parameters          The defined parms for the program 
  54.  StartupDir          The directory path that will be made current before the is 
  55.                      invoked. 
  56.  
  57.  The program information displayed is that for the title currently displayed in 
  58.  either the Program Titles or Selected Titles combination list box, whichever 
  59.  had the input focus last. 
  60.  
  61.  If an icon was defined for the program entry, it will also be used to create 
  62.  the 2.0 program reference.  The icon path, however, will not be displayed in 
  63.  IniCnv's client area. 
  64.  
  65.  
  66. ΓòÉΓòÉΓòÉ 1.3. Title Selection ΓòÉΓòÉΓòÉ
  67.  
  68. When the Program Titles drop down combination list box has the input focus, the 
  69. Select and SelectAll buttons will be enabled. 
  70.  
  71. Press the Select button to remove the highlighted title from the Program list 
  72. and add it to the Selected list.  Press the SelectAll button to move all of the 
  73. Program Title entries to the Selected Titles list. 
  74.  
  75. When the Selected Titles drop down combination list box has the input focus, 
  76. the Deselect button will be enabled. 
  77.  
  78. Press the Deselect button to remove the highlighted title from the Selected 
  79. Title list and return it to the Progam Title list. 
  80.  
  81.  
  82. ΓòÉΓòÉΓòÉ 1.4. Conversion Processing ΓòÉΓòÉΓòÉ
  83.  
  84. When you press the Convert button, any program definition that was placed in 
  85. the Selected Title combination list box during the selection process will be 
  86. converted. 
  87.  
  88. A folder will be created with the name NFDC and be placed on the desktop, if it 
  89. does not already exist.  A subfolder will be created within this root folder 
  90. and be named using the associated 1.x group box name. 
  91.  
  92. Finally, program references will be created for selected titles. 
  93.  
  94. At the time of this writing, restrictions apply to the conversion process. 
  95.  
  96.  
  97. ΓòÉΓòÉΓòÉ 1.5. Process Restrictions ΓòÉΓòÉΓòÉ
  98.  
  99. Icons do not immediately appear.  For some strange reason, icons will appear 
  100. only after you next reboot.  However, you may move folders and program 
  101. references to new locations and otherwise rearrange things without causing any 
  102. harm. 
  103.  
  104. This utility must run under OS2 2.0 at beta level 6.304 or above. 
  105.  
  106. The OS2 2.0 system must have be installed in an HPFS partition. 
  107.  
  108. The OS2 2.0 desktop must be actively using the directory Desktop on the 
  109. installed partition. 
  110.  
  111.  
  112. ΓòÉΓòÉΓòÉ 1.6. Registration ΓòÉΓòÉΓòÉ
  113.  
  114. SUPPORT SHAREWARE 
  115.  
  116. I hope you find this utility helpful, but (here comes the disclaimer) I am in 
  117. no way responsible for any damages the use of this utility may cause. You are 
  118. free to use this utility at your own risk with no obligation to me, the author, 
  119. for only a short period of time. 
  120.  
  121. This utility includes a registration throttle that allows only 5 program 
  122. references to be converted in a single execution.  When you register IniCnv, 
  123. this throttle will be removed. 
  124.  
  125. If IniCnv is helpful to you or your organization, you should register it. The 
  126. registration fee for individuals is $15 (US).  The site registration fee for 
  127. corporate entities is $150 (US).  Please send registration fees along with a 
  128. daytime phone number to: 
  129.  
  130. Dave Lester
  131. PO Box 461
  132. New Freedom, PA. 17349 USA
  133.  
  134. Comments, suggestions and bug reports may be submitted through CIS Mail ID 
  135. 75600,237.  These will be answered on a "best effort" basis. 
  136.  
  137.  
  138. ΓòÉΓòÉΓòÉ 2. File Action Bar Item ΓòÉΓòÉΓòÉ
  139.  
  140. The File pull down menu item displays the following selections: 
  141.  
  142.  Open                Open and INI file 
  143.  Hini_Userprofile    Use system INI info 
  144.  Exit                Quit the utility 
  145.  
  146.  
  147. ΓòÉΓòÉΓòÉ 2.1. Open Action ΓòÉΓòÉΓòÉ
  148.  
  149. The Open selection will invoke the system default open file dialog for files 
  150. that end with a ".ini" suffix. 
  151.  
  152. Use the drive and directory list boxes to navigate to the location of your INI 
  153. input file.  Select the INI file that you wish to process and press the OK 
  154. button. 
  155.  
  156. You may not select the OS2.INI file that is in use by your system. 
  157.  
  158.  
  159. ΓòÉΓòÉΓòÉ 2.2. Hini_Userprofile Action ΓòÉΓòÉΓòÉ
  160.  
  161. When you select the Hini_Userprofile action item, the IniCnv utility will 
  162. search your existing system definitions for 1.x style program definitions. 
  163.  
  164. Since OS 2.0 is relatively new, many installation programs still create the 
  165. "old" style group and program definitions.  IniCnv allows you to convert these 
  166. entries too.  Once the items are converted, you may safely delete the old group 
  167. boxes. 
  168.  
  169. The name HINI_USERPROFILE is used by the system to access the OS2.INI file.  I 
  170. didn't make up that name and am not referencing any person or thing's 
  171. posterior. 
  172.  
  173.  
  174. ΓòÉΓòÉΓòÉ 2.3. Exit Action ΓòÉΓòÉΓòÉ
  175.  
  176. You may select Exit to terminate the IniCnv utility. 
  177.  
  178.  
  179. ΓòÉΓòÉΓòÉ 3. GroupNames ComboBox ΓòÉΓòÉΓòÉ
  180.  
  181. The Groupnames drop down combination list box will display the title of each 
  182. 1.x group entry that was found in the INI file that you opened for processing. 
  183.  
  184. When you select a Groupname list item, any title previously placed in the 
  185. Selected Titles list is removed and the contents of the Program Titles list is 
  186. replaced with titles found in the newly selected group. 
  187.  
  188. You may then examine information about each of the Program Titles and begin the 
  189. selection process. 
  190.  
  191.  
  192. ΓòÉΓòÉΓòÉ 4. ProgramTitles ComboBox ΓòÉΓòÉΓòÉ
  193.  
  194. For each program defined in the selected Groupname, a title will be placed in 
  195. the Program Titles list. 
  196.  
  197. If the Program Tiles list has the input focus, the information displayed in 
  198. IniCnv's client area will reflect the currently selected item. 
  199.  
  200. The Select button will also be enabled so that the currently selected title may 
  201. be transfered to the Selected Titles list for conversion processing. 
  202.  
  203.  
  204. ΓòÉΓòÉΓòÉ 5. Selected Titles ComboBox ΓòÉΓòÉΓòÉ
  205.  
  206. Each title removed from the Program Titles list will be placed in the Selected 
  207. Titles list. 
  208.  
  209. If the Selected Tiles list has the input focus, the information displayed in 
  210. IniCnv's client area will reflect the currently selected item. 
  211.  
  212. The Deselect button will be enabled so that the currently selected title may be 
  213. returned to the Program Titles list. 
  214.  
  215. The Convert button will also be enabled so that conversion processing can be 
  216. initiated. 
  217.  
  218.  
  219. ΓòÉΓòÉΓòÉ 6. Keys Help ΓòÉΓòÉΓòÉ
  220.  
  221. The list of keys is arranged in groups. 
  222.  
  223. ACCELERATOR KEYS 
  224.  
  225.        Ctrl+o
  226.       Open an INI file 
  227.  
  228.        F3
  229.       Exit program 
  230.  
  231.  Program Details Environment Edit Keys 
  232.  
  233.  ALT-Insert 
  234.       Add contents of Combo Edit Box to Environment List 
  235.  
  236.  ALT-Delete 
  237.       Delete contents of Combo Edit Box from Environment List 
  238.  
  239.  HELP KEYS 
  240.  
  241.  F1 
  242.       Get help 
  243.  
  244.  F2 
  245.       Get extended help (from within any help window) 
  246.  
  247.  Alt+F4 
  248.       End help 
  249.  
  250.  F9 
  251.       Go to a list of keys (from within any help window) 
  252.  
  253.  F11 
  254.       Go to the help index (from within any help window) 
  255.  
  256.  Esc 
  257.       Previous Help Panel, or End help if only one panel 
  258.  
  259.  Alt+F6 
  260.       Go to/from help and programs 
  261.  
  262.  Shift+F10 
  263.       Get help for help 
  264.  
  265.  SYSTEM KEYS 
  266.  
  267.  Alt+F6 
  268.       Switch to the next windowed program 
  269.  
  270.  Alt+Esc 
  271.       Switch to the next program, including full-screen programs 
  272.  
  273.  Ctrl+Esc 
  274.       Switch to the Task List 
  275.  
  276.  WINDOW KEYS 
  277.  
  278.  F3 
  279.       Close a window 
  280.  
  281.  F10 
  282.       Go to/from the action bar 
  283.  
  284.  Arrow keys 
  285.       Move among choices 
  286.  
  287.  End 
  288.       Go to the last choice in a pull-down 
  289.  
  290.  Esc 
  291.       Cancel a pull-down or the system menu 
  292.  
  293.  Home 
  294.       Go to the first choice in a pull-down 
  295.  
  296.  PgUp 
  297.       Scroll the contents of the window up one page 
  298.  
  299.  PgDn 
  300.       Scroll the contents of the window down one page 
  301.  
  302.  Underlined letter 
  303.       Move among the choices on the action bar and pull-downs 
  304.  
  305.  Alt+F10 
  306.       Go to/from the action bar 
  307.  
  308.  Alt+F4 or F3 
  309.       Close the window 
  310.  
  311.  Alt+F5 
  312.       Restore the window 
  313.  
  314.  Alt+F7 
  315.       Move the window 
  316.  
  317.  Alt+F8 
  318.       Size the window 
  319.  
  320.  Alt+F9 
  321.       Minimize the window 
  322.  
  323.  Alt+F10 
  324.       Maximize the window 
  325.  
  326.  Ctrl+PgDn or Shift+F8 
  327.       Scroll the contents of the window right one page 
  328.  
  329.  Ctrl+PgUp or Shift+F7 
  330.       Scroll the contents of the window left one page 
  331.  
  332.  Shift+Esc or Alt+Spacebar 
  333.       Go to/from the system menu 
  334.  
  335.  Shift+Esc or Alt 
  336.       Go to/from the system menu of a text window 
  337.