home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 May / Chip_1998-05_cd.bin / sharewar / far / FARREG11.ZIP / README.ENG < prev    next >
Text File  |  1997-10-22  |  8KB  |  188 lines
  1.  
  2.                 Registry Viewer and Editor for FAR
  3.                 ==================================
  4.  
  5.                     Version 1.1 beta, 22.10.97.
  6.  
  7.  
  8. DISTRIBUTION: FREEWARE, under condition that the given product and this
  9. text are left unchanged.
  10.  
  11. DISCLAIMER: The author is not responsible for any consequences of using
  12. this product, though in testing he didn't find anything terrible in it :)
  13.  
  14. ------------------------------------------------------------------------------
  15. WARNING: Always backup your registry, especially before experimenting with it!
  16. ------------------------------------------------------------------------------
  17.  
  18. Brief description
  19. -----------------
  20.  
  21. This FAR plugin allows you to do with registry keys and variables exactly the
  22. same things as with directories and files.
  23.  
  24. There are two operation modes: "keys as directories" and "keys as files".
  25. The keys treated as files have the standard .REG format; REGEDIT.EXE
  26. is called automatically to transform keys to files and to import them back
  27. to registry (when editing or copying).
  28.  
  29. Import and export of single variables is done by the plugin itself
  30. by usual file I/O operations. For string variables, the trailing zero is
  31. truncated on export and added on import.
  32.  
  33. Values of all variables and default values of all keys are shown in the
  34. standard Descriptions column. Binary values are converted to readable form.
  35. Under Windows NT, the key owners are also shown in the standard Owner column.
  36.  
  37. You can see everything by yourself if you experiment pressing F3 or F4
  38. on registry keys and values.
  39.  
  40. Some new keyboard shortcuts are introduced in this plugin: Shift-F1, Shift-F2,
  41. Shift-F7, Ctrl-F, Ctrl-G, Ctrl-N, Ctrl-A (description see below). You can also
  42. get into the plugin if you type in the command line the prefix reg: followed
  43. by path to the key you want to see.
  44.  
  45.  
  46. Installation and running
  47. ------------------------
  48.  
  49. Copy registry.dll and registry.hlf (if you need a help file) to the Plugins
  50. subdirectory of your FAR directory, or to any subdirectory under Plugins.
  51. Restart FAR, and a new item, Registry Browser, will appear in the
  52. Plugins menu (F11). Select it, and you will get to the root keys of registry.
  53.  
  54.  
  55. Basic advantages over regedit.exe
  56. ---------------------------------
  57.  
  58. 1. You can edit keys as text files with FAR built-in editor or with any other
  59.    text editor (using file associations) with automatic export and import.
  60. 2. You can work with binary values from any binary editor (using file
  61.    associations).
  62. 3. Directly jump to a key by its path pasted from clipboard (using command "cd")
  63.    quick jump to predefined keys using FAR user menu or keyboard macros.
  64. 4. Default values for all keys are displayed simultaneously.
  65.    Numerical values are displayed in readable format.
  66. 5. Integration with FAR (copying keys to the other panel, sorting etc.).
  67. 6. Under Windows NT: display of the key's owner (it's also done by
  68.    regedt32.exe) and auto-refreshing.
  69. 7. The plugin remembers its last position.
  70. 8. You can change the values type.
  71.  
  72.  
  73. Notes
  74. -----
  75.  
  76. 1. There are two operation modes of the plugin:
  77.  
  78. 1) Keys as files. The keys can be distinguished from variables only if
  79. displaying sizes is enabled, the size of keys displayed is 0. Regedit is
  80. used to export keys as files.
  81. Disadvantages of this mode: since FAR doesn't allow to intercept Ctrl-PgDn,
  82. this key cannot be used to get into a registry key like into a directory.
  83. To do this, use <Enter> or "cd" command. Moreover, it's hard to see the
  84. difference between keys and values in the panel.
  85.  
  86. 2) Keys as directories. Ctrl-PgDn works here. Keys are color-highlighted
  87. properly (if files highlighting is enabled in FAR) and displayed, according
  88. to sorting rules, before the values. View/Edit work exactly like in the
  89. "keys as files" mode, but their windows are modal.
  90. Disadvantages of this mode are: (1) viewing/editing keys are possible
  91. only in modal windows, that is, no window switching if a key is viewed/edited;
  92. (2) the built-in key NumPad5 doesn't work. But you can redefine it using
  93. a macro which "presses" F3 when you press NumPad5.
  94.  
  95. To toggle between these modes, press Shift-F7.
  96.  
  97. 2. Copy.
  98. In this version, everything entered in copy dialog is considered as a
  99. directory name. If the directory does not exist, it is created. In the
  100. "keys as directories" mode, the keys are still exported as .REG files
  101. rather than copied as trees of files made of values.
  102.  
  103. 3. Move.
  104. Move is not implemented (do you really need it?). Instead, Copy works only.
  105.  
  106. 4. Creating new keys and values.
  107.  
  108. You can create empty keys with F7, like usual directories.
  109.  
  110. You can create new values either pressing Shift-F4, specifying the name of your
  111. new value and editing it, or copying a previously created file with the same
  112. name into the registry.
  113.  
  114. If the imported file has .REG file format (begins with REGEDIT4), then the
  115. file name doesn't matter, and regedit.exe is launched to import it.
  116.  
  117. If the file imported as a new value is either empty or contains characters
  118. beyond the 0x20..0x7e range, then the type of the new value is String,
  119. otherwise it's Binary. If you need to create variables of another type, such
  120. as DWORD, you can create the value as proposed and change its type with the
  121. Ctrl-A command (see below), or edit the parent key (in .reg format).
  122.  
  123. 5. Deleting.
  124. When deleting a whole key, confirmation is asked only once, like on a usual
  125. file! (Like regedit does, to the point.) If there are both a key and a value
  126. under the same name, then the value is deleted. (This version can distinguish
  127. between keys and values only by name.)
  128.  
  129. Under Windows 95+, keys containing subkeys are deleted OK, under NT
  130. they are not deleted; you will have to remove all their subkeys.
  131.  
  132. 6. Search (Alt-F7)
  133. Even though on the panel keys are considered as files, in search operations
  134. they are directories. Strings are searched only in values, not in names.
  135. Binary values are taken physically, rather than hex-formatted or so.
  136.  
  137. 7. Shortcuts in registry.
  138. There are two built-in shortcuts:
  139.   Shift-F1 goes to HKEY_CURRENT_USER\Software\Far,
  140.   Shift-F2 goes to HKEY_LOCAL_MACHINE\Software\Far.
  141.  
  142. 8. The cd command is supported. The plugin understands both complete root
  143. handle names (HKEY_CURRENT_USER) and reduced ones (HKCU).
  144. They are case-insensitive.
  145.  
  146. 9. On Ctrl-F, the complete name of a key under cursor bar is put to the
  147. command line. It's provided by FAR 1.5 automatically.
  148.  
  149. 10. On Ctrl-G, the contents of Description column is put to the command line.
  150.  
  151. 11. Ctrl-N toggles display of binary values in the Descriptions field:
  152. between hex dump and decimal number - for four-byte values,
  153. between hex dump and ASCII string - for other values.
  154. The standard meaning of Ctrl-N is of no use here.
  155.  
  156. 12. Ctrl-A, pressed on a value, pops up a menu of value types, the current type
  157. of the value is selected. Selecting the new type in the menu, you can change
  158. this value type.
  159.  
  160. 13. Two panel modes are overridden, 6 and 7. Default sort mode is Unsorted.
  161.  
  162. 14. Under Windows 95+ the plugin understands key HKEY_DYN_DATA, showing
  163. the current information on system.
  164. Under Windows NT, similar information is extracted from the key
  165. HKEY_PERFORMANCE_DATA, but the plugin does not work with it since its format
  166. is complicated and tells little in binary form. Use separate utilities such as
  167. Performance Monitor (perfmon).
  168.  
  169. 15. All settings and the current path are saved before exit from the plugin.
  170.  
  171. 16. Under NT the owners of keys are shown, but only if in the current"folder"
  172. the number of keys is less than 100. Otherwise it dramatically decreases the
  173. performance. Do you really need it? :)
  174.  
  175. 17. You can get to any registry key from the command line by the prefix reg: ,
  176. followed by the path to the key. For example, if you type
  177. reg:HKCU\Software\Far\Plugins\YMS\Registry , you will get to the place
  178. where this plugin saves its settings.
  179.  
  180. 18. Please don't complain on some obscured error messages. I just show the
  181. messages provided by Windows.
  182.  
  183. -----------------------------------------------------------------
  184. Michael Yutsis
  185. michael.y@sapiens.com
  186. Fidonet: 2:405/333.15, 2:4626/3.11
  187. Rehovot, Israel
  188.