home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / ini_ou.zip / INI_OUTI.TXT < prev    next >
Text File  |  1993-12-06  |  11KB  |  277 lines
  1. INI_OUTI:  Copyright by Charles G. Hoppa
  2.  
  3.  
  4.     INI_OUTI is an OS/2 INI file editor.  This program will allow you
  5.     to add, update, or delete OS/2 INI applications and keys.
  6.  
  7.  
  8. WARNING:
  9.  
  10.     WARNING this program changes data in your INI files.  Remember to
  11.     backup your INI files before using this program.
  12.  
  13.  
  14. Disclaimer:
  15.  
  16.     I make no representation or warranty with respect to the adequacy
  17.     of this documentation or the programs which it describes for any
  18.     particular purpose or with respect to its adequacy to produce any
  19.     particular result.  In no event shall I be liable for special,
  20.     direct, indirect or consequential damages, losses, costs, charges,
  21.     claims, demands, or claim for lost profits, fees or expenses of
  22.     any nature or kind.
  23.  
  24.  
  25. Shareware:
  26.  
  27.     INI_OUTI is Shareware. If you find yourself using this program,
  28.     please register it. Fill out INI_OUTI.REG and send it with
  29.     $15.00 + $1.00 S&H to:
  30.  
  31.         Charles G. Hoppa
  32.         413 Falling Spring Court
  33.         Reisterstown, MD 21136-1622
  34.  
  35.     (Overseas orders, please make payments in US dollars, and
  36.     include $5.00 for shipping.)
  37.  
  38.     When you register you will receive a registered version.  The
  39.     registered version allows the editing of data values up to
  40.     8192(8k) bytes in length.
  41.  
  42.  
  43. Requirements:
  44.  
  45.     The files needed to run this program are as follows:
  46.  
  47.             INI_OUTI.EXE - program
  48.             INI_OUTI.TXT - help text
  49.             INI_OUTI.ICO - icon
  50.             VROBJ.DLL    - VXREXX(1) DLL
  51.  
  52.  
  53.     This program requires OS/2 2.0 with the service pack or a higher
  54.     version of OS/2 and REXX installed on your machine.
  55.  
  56.  
  57. Limitations:
  58.  
  59.     You can only edit key entries up to a length of 2048(2K) bytes
  60.     with the intro version or key entries up to a length of 8192(8K)
  61.     bytes with the registered version.
  62.  
  63.  
  64. Installation:
  65.  
  66.     There are three methods of installing INI_OUTI on your machine.
  67.     The first is to copy the INI_OUTI files(the EXE, ICO, and TXT)
  68.     to an existing program directory and copy the VROBJ.DLL to a
  69.     directory that is contained in the LIBPATH in your CONFIG.SYS
  70.     file.
  71.  
  72.     The second method of installing INI_OUTI is to create a new
  73.     directory and copy all the files into that directory.  Then you
  74.     will need to include this directory in the LIBPATH in your
  75.     CONFIG.SYS file (requires you restart the PC for the changes
  76.     to take affect).
  77.  
  78.     The third method is a combination of the first and second methods.
  79.     Create a new directory and copy the INI_OUTI files to this new
  80.     directory, then copy the VROBJ.DLL to an existing directory that
  81.     is contained in the LIBPATH in your CONFIG.SYS file.
  82.  
  83.  
  84. Starting the application:
  85.  
  86.     After you have finished installing this product and restarted
  87.     your PC to include any changes you made to the LIBPATH in your
  88.     CONFIG.SYS, you can start the program from a command line.
  89.  
  90.     Open an OS/2 Window and make the current drive the drive you
  91.     installed the INI_OUTI.EXE file onto.  Change your directory to
  92.     the directory where you installed the INI_OUTI.EXE file.  Type
  93.     'INI_OUTI' and then press the 'ENTER' key.
  94.  
  95.  
  96. Menu:
  97.  
  98.     The menu bar contains two options "File" and "Help".
  99.  
  100.     The "File" option contains the two selections "Open an INI file"
  101.     and  "Exit."  Use the first of these selections to open an OS/2
  102.     INI file for editing.  This is a required selection.  If you don't
  103.     open a file for editing, you won't be able to do anything with the
  104.     editor.
  105.  
  106.     The "Exit" selection ends the execution of the current edit
  107.     session and returns to the operating system.
  108.  
  109.     The Help option contains the two selections "Help" and "About
  110.     this product".  The "Help" selection contains help information
  111.     about the use of this product.  The "About this product"
  112.     displays release information about the version of the product
  113.     you are currently running.
  114.  
  115.  
  116.  
  117. Screen fields and Objects:
  118.  
  119.  
  120.  
  121. Current INI file:
  122.  
  123.     Displays the name(including drive and path) of the OS/2 INI file
  124.     you are currently editing.
  125.  
  126.  
  127. Application Name(s):
  128.  
  129.     This list box will display all the applications contained in the
  130.     "Current INI File".  In addition to the existing applications, the
  131.     first entry "<  ADD A NEW APPLICATION  >' will allow you to add a
  132.     new application name to the OS/2 INI file.
  133.  
  134.     You can scroll through the list of applications using the vertical
  135.     scroll bar on the right side of the screen.  To view all the keys
  136.     for an application name, click on one of the current applications
  137.     listed in the "Application Name(s)" list box.
  138.  
  139.  
  140. Key Name(s):
  141.  
  142.     This list box will display all the keys for the currently selected
  143.     application contained in the "Current INI File".  In addition to
  144.     the existing keys, the first entry "<  ADD A NEW KEY  >' will
  145.     allow you to add a new key, for the currently selected
  146.     application, to the OS/2 INI file.
  147.  
  148.     You can scroll through the list of keys using the vertical scroll
  149.     bar on the right side of the screen.  To view the "Data Value" for
  150.     the currently selected application and key combination, click on
  151.     one of the current keys listed in the "Key Name(s)" list box.
  152.  
  153.  
  154. Display:
  155.  
  156.     The 'Display' group will allow you to change the data displayed in
  157.     the 'Data Value' field from character('Char') to
  158.     hexadecimal('Hex') and back again.  Switching to hexadecimal will
  159.     allow you to change the existing data to any value needed.  This
  160.     includes special characters or values you cannot produce by using
  161.     the keyboard.
  162.  
  163.  
  164. Data Value:
  165.  
  166.     The 'Data Value' entry field displays the current data that is
  167.     associated with a specific application and key combination.  You
  168.     can type over, insert, or delete the data anywhere in the existing
  169.     'Data Value' entry field.  After editing the current 'Data Value',
  170.     you can update the data by pushing the 'Update' push button and
  171.     following the prompted instructions.  You can reset the 'Data
  172.     Value' field to the original value by pushing the 'Reset' push
  173.     button.
  174.  
  175.     Sometimes the data for an application and key combination may
  176.     contain an embedded NULL(hexadecimal 00), a new line(hexadecimal
  177.     0A), or a carriage return(hexadecimal 0D) character.  The NULL
  178.     character presents a problem for any entry field because only
  179.     the data up to the first NULL character is displayed and the
  180.     remaining data is truncated.  If the current 'Display' option
  181.     is 'Char', the program converts any embedded NULLS to periods('.').
  182.     Then the program changes the 'Data Value' to 'read only' to
  183.     prevent you from editing the data while the 'Display' option is
  184.     set to 'Char'.  The background color of the 'Data Value' field
  185.     is changed from cyan to pink.  This will allow you to view
  186.     your data in the 'Data Value' entry.  You can change the 'Display'
  187.     option to 'Hex' to edit a character string containing an embedded
  188.     NULL character.
  189.  
  190.     The new line and the carriage return characters are control codes
  191.     that affect the way your data is displayed.  The new line and
  192.     carriage return characters are treated in the same way as a NULL
  193.     character.  The program converts them to periods('.').  Then
  194.     the program changes the 'Data Value' to 'read only' to prevent
  195.     you from editing the data while the 'Display' option is set
  196.     to 'Char'.  The background color of the 'Data Value' field is
  197.     changed from cyan to pink.  This will allow you to view your
  198.     data in the 'Data Value' entry.  You can change the 'Display'
  199.     option to 'Hex' to edit a character string containing either
  200.     an embedded new line or carriage return character.
  201.  
  202.     If the current 'Data Value' does not contain any of the 3 special
  203.     characters, the background color will stay cyan and you can edit
  204.     the data from the keyboard.  The only exception is when the length
  205.     of the data value exceeds the maximum length of data allowed by
  206.     this application(see the limitations section).  If the length
  207.     of the data value exceeds the maximum length of data allowed by
  208.     the application, the background color will change to pink and you
  209.     will not be allowed to edit the data.  You can only view data up
  210.     to the maximum length allowed by this application.
  211.  
  212.  
  213. Length:
  214.  
  215.     The length display field shows the current length of the data in
  216.     the 'Data Value' entry field.
  217.  
  218.  
  219. Update:
  220.  
  221.     The 'Update' push button will allow you to change the data value
  222.     of the current application and key combination.  Enter your change
  223.     in the 'Data Value' entry field, push this button,and follow the
  224.     dialog prompts.
  225.  
  226.  
  227. Delete:
  228.  
  229.     The 'Delete' push button will allow you to delete a specific
  230.     application and key combination or delete all the keys for an
  231.     existing application.  To delete an application and key
  232.     combination, select the application and then select the key value
  233.     you want to delete.  Push this button and follow the dialog
  234.     prompts.
  235.  
  236.     To delete all the keys for an application, select only the
  237.     application value you want to delete.    Push this button and
  238.     follow the dialog prompts.
  239.  
  240.  
  241. Reset:
  242.  
  243.     The 'Reset' push button will allow you to return the data in the
  244.     'Data Value' entry field to its original value.  Just press the
  245.     'Reset' button to remove any editing you have done on this field.
  246.  
  247.     The 'Reset' button will not return the data after a successful
  248.     delete has been performed, and once a successful update is
  249.     performed, the new data becomes the original value.  You cannot
  250.     back out a successful update.
  251.  
  252.  
  253. Add:
  254.  
  255.     The 'Add' push button will allow you to add a new key to an
  256.     existing application or a new application and key combination.  To
  257.     add a new key to an existing application, select the application
  258.     to which you want to add the key to in the 'Application Name(s)'
  259.     list box.  Then select the first entry in the 'Key Name(s)' list
  260.     box(<  ADD A NEW KEY  >).  Press this button and follow the dialog
  261.     prompts.
  262.  
  263.     To add a new application and key combination, select the first
  264.     entry in the 'Applications Names' list box(<  ADD A NEW
  265.     APPLICATION  >).  Press this button and follow the dialog prompts
  266.  
  267.  
  268. Trademarks:
  269.  
  270.     All registered trademarks contained or referenced in this
  271.     documentation and program, whether notated or not, are the
  272.     property of the owners of those registered trademarks.
  273.  
  274.     (1) VXREXX is a trademark of WATCOM International Corporation.
  275.  
  276.  
  277.