home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 28 Fixes4x / 28-Fixes4x.zip / xr_m010.1dk / README.REG < prev    next >
Text File  |  1998-07-24  |  11KB  |  384 lines
  1. <        Warp Registry Editor - REGEDIT2.EXE
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.         
  18.  
  19.         
  20.         
  21.  
  22.  
  23.  
  24.         July 10, 1998
  25.  
  26.         
  27.         
  28.         
  29.         
  30.         OS/2 Fix Distribution
  31.         Personal System Products
  32.         Austin, Tx
  33.         
  34.         
  35.         (c) Copyright International Business Machines Corporation, 1994, 1996.
  36.         All rights Reserved.
  37.  
  38.         July 10, 1998 - Warp Registry Editor
  39.  
  40.  
  41.  
  42.  
  43.                      July 10, 1998 - Warp Registry Editor
  44.  
  45.    CONTENTS
  46.  
  47.  
  48.      1.0 Command Support - REGEDIT2  . . . . . . . . . . . . . . . . . . . 1
  49.      1.1 Functional Specification  . . . . . . . . . . . . . . . . . . . . 1
  50.      1.2 Features  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  51.        1.2.1 Editor Arrangement  . . . . . . . . . . . . . . . . . . . . . 1
  52.        1.2.2 Data Editing  . . . . . . . . . . . . . . . . . . . . . . . . 1
  53.      1.3 Menus   . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  54.        1.3.1 Import Registry File  . . . . . . . . . . . . . . . . . . . . 2
  55.        1.3.2 Export Registry File  . . . . . . . . . . . . . . . . . . . . 3
  56.        1.3.3 Open Profile  . . . . . . . . . . . . . . . . . . . . . . . . 3
  57.        1.3.4 Close Profile   . . . . . . . . . . . . . . . . . . . . . . . 3
  58.        1.3.5 Print   . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  59.        1.3.6 Edit New Key  . . . . . . . . . . . . . . . . . . . . . . . . 3
  60.        1.3.7 Edit New String, Binary, DWORD Value  . . . . . . . . . . . . 3
  61.        1.3.8 Delete  . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  62.        1.3.9 Find  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  63.        1.3.10 Find Next  . . . . . . . . . . . . . . . . . . . . . . . . . 4
  64.        1.3.11 View Status Bar  . . . . . . . . . . . . . . . . . . . . . . 4
  65.        1.3.12 View Split Vertical/Horizontal   . . . . . . . . . . . . . . 4
  66.        1.3.13 Refresh  . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  67.        1.3.14 Help   . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  68.        1.3.15 Program Information  . . . . . . . . . . . . . . . . . . . . 5
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.    
  98.                                                                 Contents  ii
  99.  
  100.                      July 10, 1998 - Warp Registry Editor
  101.  
  102.    1.0 COMMAND SUPPORT - REGEDIT2
  103.  
  104.  
  105.  
  106.    1.1 FUNCTIONAL SPECIFICATION
  107.  
  108.    The Warp Registry Editor (REGEDIT2.EXE) was designed to be functionally
  109.    equivalent to the Registry Editor found in Win95 and NT4.0. In addition
  110.    to supporting the Open32 Registry Keys, the Warp Registry Editor also
  111.    supports the standard OS/2 Profile keys and files (*.INI).  This was done
  112.    in a manner as to appear "seamless" to the user providing a single user
  113.    interface that combines both universes on the Warp platform.
  114.  
  115.  
  116.  
  117.    1.2 FEATURES
  118.  
  119.  
  120.  
  121.  
  122.    1.2.1 EDITOR ARRANGEMENT
  123.  
  124.    The registry editor consists of two panes separated by a split bar.  The
  125.    pane on the left holds the Registry Keys and Subkeys while the pane on
  126.    the right holds the Key Values and Data.  When a key is selected in the
  127.    left pane, the Keys Values and Data areautomatically updated in the right
  128.    pane.  The left pane is setup in the traditional OS/2 Folder Tree View
  129.    while the right pane uses the OS/2 Folder Details view.  The split bar
  130.    can be manipulated by clicking on the bar with the left mouse button and
  131.    adjusting it left or right.  The columns in the right pane automatically
  132.    size themselves to hold the data.  If the data is too large to be
  133.    completely viewed in the editor, it is truncated.  This is indicated by
  134.    an ellipse (...) at the end of the data.  To view more data either resize
  135.    the editor or edit the field.
  136.  
  137.  
  138.  
  139.    1.2.2 DATA EDITING
  140.  
  141.    The editor allows you to edit the values of Keys, Values, and Data.  Key
  142.    Names are always edited in place.  The edit feature can be activated by
  143.    selecting the key using the mouse or keyboard arrow keys and then
  144.    pressing Enter on the keyboard, double clicking with the left mouse
  145.    button, or holding the ALT key and clicking with the left mouse button.
  146.    Value Names are also edited in place.  This edit feature can be activated
  147.    by selecting the value using the mouse or keyboard arrow keys and then
  148.    holding the ALT key and clicking with the left mouse button in the Name
  149.    Column to .....  The Value Data is edited using dialog boxes or, in the
  150.    case of String Data only, in place editing.  The Data edit feature can be
  151.    activated by selecting the Value Data using the mouse or keyboard arrow
  152.    keys and pressing Enter on the keyboard, double clicking with the mouse
  153.  
  154.    
  155.                                                Command Support - REGEDIT2  1
  156.  
  157.                      July 10, 1998 - Warp Registry Editor
  158.  
  159.    on the Value (in either Name or Data columns), or by holding the ALT key
  160.    and pressing the left mouse button (activates in place editing for String
  161.    Data) in the Data Column.  There are separate edit dialogs for String,
  162.    DWORD, and Binary data.
  163.  
  164.  
  165.  
  166.    1.3 MENUS
  167.  
  168.    The menu items vary with the context of the Key, Value items selected and
  169.    which of the two panes have focus.  In addition, a popup menu can be
  170.    invoked for any item on the panes by clicking the right mouse button.
  171.  
  172.  
  173.  
  174.    1.3.1 IMPORT REGISTRY FILE
  175.  
  176.    This feature allows you to import any file using the Win95/NT 4.0 ASCII
  177.    Registry Format (*.REG).  This format is not well documented (even on the
  178.    Windows platform) but has the basic form:
  179.  
  180.    
  181.    REGEDIT4       (Format specified at the top of the file)
  182.    
  183.    [KEY]          Example:[HKEY_LOCAL_MACHINE\
  184.                   Software\LOTUS\123\97.0\CONFIGCACHE]
  185.    [BINARYVALUE]  Example:DATE=hex:80,ac,95,5f,d7,02,bc
  186.    [DWORDVALUE]   Example:TOOLCOUNT=dword:00000027
  187.    [STRINGVALUE]  Example:PATH="L123R6.CFG"
  188.    Note:          Separate keys with a newline
  189.    [NEXTKEY]
  190.    [VALUE]
  191.    [VALUE]
  192.  
  193.    This works equally well for OS/2 Profiles where the [KEY] is:
  194.  
  195.    [HINI_SYSTEM_PROFILE\ApplicationName],
  196.    [HINI_USER_PROFILE\ApplicationName], or
  197.    ["X:\SOME\FILE\PATH\PROFILE.INI"\ApplicationName]
  198.  
  199.    The Profile Keys are done exactly the same as for Win Registry Values and
  200.    the Profile Data is the Registry Value data.
  201.  
  202.    The Import Registry File function will create all necessary keys, values,
  203.    and data for both Registry and Profile imports.  In addition, this
  204.    function can create OS/2 Profile files on the fly from an ASCII *.REG
  205.    file.
  206.  
  207.  
  208.  
  209.  
  210.  
  211.    
  212.                                                Command Support - REGEDIT2  2
  213.  
  214.                      July 10, 1998 - Warp Registry Editor
  215.  
  216.    1.3.2 EXPORT REGISTRY FILE
  217.  
  218.    This feature allows you to export any [KEY] and its subkeys and data to a
  219.    file of your choosing.  You can back up the entire Win Registry and/or
  220.    OS/2 System and User Profiles using this feature and then restore them at
  221.    a later date by importing the file (of course take care!).  It is most
  222.    useful for QE/Testing purposes when you need to either wipe out your
  223.    registry or you are trying to support multiple versions of the products
  224.    in several different directories.  By selectively exporting/importing the
  225.    Registry Configurations, you can switch between multiple versions.
  226.  
  227.  
  228.  
  229.    1.3.3 OPEN PROFILE
  230.  
  231.    This feature allow you to open any OS/2 Profile File (*.INI) and
  232.    view/edit its contents.  It is also useful for creating NEW Profile files
  233.    and then adding information to those files using the editor features.
  234.  
  235.  
  236.  
  237.    1.3.4 CLOSE PROFILE
  238.  
  239.    This feature allows you to close any OS/2 Profile File that you
  240.    previously opened using Open Profile
  241.  
  242.  
  243.  
  244.    1.3.5 PRINT
  245.  
  246.    This feature allows you to print to your favorite printer the Keys,
  247.    Subkeys, Values, and Data stored in your Win Registry or OS/2 Profile
  248.    Files.  The format of the print is similar to the format of the Win
  249.    Registry File.
  250.  
  251.  
  252.  
  253.    1.3.6 EDIT NEW KEY
  254.  
  255.    This feature allows you to add a subkey to an existing Win Registry Key,
  256.    or allows you to add an Application or Application Key to an OS/2
  257.    Profile.
  258.  
  259.  
  260.  
  261.    1.3.7 EDIT NEW STRING, BINARY, DWORD VALUE
  262.  
  263.    This feature allows you to add a new Value of the selected data type to
  264.    an existing Registry Key.  In Win95/NT, every Registry Key has at least
  265.    one value called "Default" which is a String Data type.  When a user adds
  266.    a Value to a key, they must identify its data type.  The user interface
  267.  
  268.    
  269.                                                Command Support - REGEDIT2  3
  270.  
  271.                      July 10, 1998 - Warp Registry Editor
  272.  
  273.    supports one of three data types, a String (defined as a NULL terminated
  274.    ASCII value), a DWORD (defined as a 4 byte unsigned long value), and HEX
  275.    (defined as any sequence of binary bytes of arbitrary length).  The OS/2
  276.    Profile does not support data types so the Editor uses the above
  277.    definitions to determine the type of data stored in a Profile Key and
  278.    presents it as such to the user.  This is done to be consistent with the
  279.    UI.
  280.  
  281.  
  282.  
  283.    1.3.8 DELETE
  284.  
  285.    This feature allow you to delete a Registry Key and it's subkeys or a
  286.    Registry Key Value.
  287.  
  288.  
  289.  
  290.    1.3.9 FIND
  291.  
  292.    This feature allows you to search through any combination of Keys,
  293.    Values, and Data for a search string you designate.  In the case of
  294.    binary data, all values are converted to byte hex numbers separated by
  295.    commas during the search (similar to the *.REG format).  For DWORD's, the
  296.    value being searched is converted to an unsigned long value before the
  297.    match is attempted.
  298.  
  299.  
  300.  
  301.    1.3.10 FIND NEXT
  302.  
  303.    This feature allows you to continue a search that has stop on a
  304.    previously found value.
  305.  
  306.  
  307.  
  308.    1.3.11 VIEW STATUS BAR
  309.  
  310.    Enables or disables the status bar at the bottom of the editor.  This
  311.    status bar shows the current Full Key name being viewed.
  312.  
  313.  
  314.  
  315.    1.3.12 VIEW SPLIT VERTICAL/HORIZONTAL
  316.  
  317.    Changes the orientation of the registry editor from Side by Side (Keys on
  318.    left, Values on right) to Top and Bottom (Keys on top, Values on bottom).
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.    
  326.                                                Command Support - REGEDIT2  4
  327.  
  328.                      July 10, 1998 - Warp Registry Editor
  329.  
  330.    1.3.13 REFRESH
  331.  
  332.    Refresh places the editor back to the top of the Key hierarchy and dumps
  333.    all stored data.  This is necessary if values in the Registry have been
  334.    modified by an external source or by the process of importing a file.
  335.    This insures that Keys, Values, and Data are re-read from the registry.
  336.  
  337.  
  338.  
  339.    1.3.14 HELP
  340.  
  341.    A help topics feature is provided.
  342.  
  343.  
  344.  
  345.    1.3.15 PROGRAM INFORMATION
  346.  
  347.    Provides an about dialog information box.
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.    
  383.                                                Command Support - REGEDIT2  5
  384.