home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 May / Chip_1998-05_cd.bin / sharewar / far / FARREG11.ZIP / REGISTRY.HLF < prev    next >
Text File  |  1997-10-20  |  7KB  |  198 lines
  1. .Language=English,English
  2. .PluginContents=Registry Browser Plugin
  3.  
  4. @Contents
  5. $ #Registry Browser Plugin#
  6.  
  7.    ~Description~@Description@
  8.  
  9.    ~Keyboard Commands~@Keyboard@
  10.  
  11.    ~Copy/Move Implementation~@CopyMove@
  12.  
  13.    ~Creating New Keys and Values~@CreateNew@
  14.  
  15.    ~Deleting Keys and Values~@Delete@
  16.  
  17.  
  18. @Description
  19. $ #Description#
  20.  
  21. This 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~@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. Two panel modes are overridden, 6 and 7. Default sort mode is Unsorted.
  38.  
  39. Prefix #reg:# can be used to get into the plugin from command line or user menu,
  40. for example:
  41.  
  42. @-
  43. C:\>reg:HKEY_CURRENT_USER\Software\Far
  44. @+
  45.  
  46. You can see everything by yourself if you experiment pressing F3 or F4
  47. on registry keys and values.
  48.  
  49.  
  50. #Basic advantages over regedit.exe#
  51.  
  52. 1. You can edit keys as text files with FAR built-in editor or with any other
  53. text editor (using file associations) with automatic export and import.
  54.  
  55. 2. You can work with binary values from any binary editor (using file associations).
  56.  
  57. 3. Directly jump to a key by its path pasted from clipboard (using command "cd")
  58. quick jump to predefined keys using FAR user menu or keyboard macros.
  59.  
  60. 4. Default values for all keys are displayed simultaneously.
  61. Numerical values are displayed in readable format.
  62.  
  63. 5. Integration with FAR (copying keys to the other panel, sorting etc.).
  64.  
  65. 6. Under Windows NT: display of the key's owner (it's also done by
  66. regedt32.exe) and auto-refreshing.
  67.  
  68. 7. The plugin remembers its last position.
  69.  
  70. 8. You can change the values type.
  71.  
  72.  
  73. @Keyboard
  74. $ #Keyboard Commands#
  75.  
  76. In addition to standard FAR keys, Registry Browser provides its own keys:
  77.  
  78. @-
  79. #Ctrl-A#    Look/change ~value type~@ChType@.
  80. #Ctrl-G#    Put the value from Descriptions column to the command line.
  81. #Ctrl-N#    Toggle display of binary values in the Descriptions column:
  82.              hex dump / decimal number - for four-byte values,
  83.              hex dump / ASCII string   - for other non-string values.
  84. #Shift-F1#  Go to HKEY_CURRENT_USER\Software\Far.
  85. #Shift-F2#  Go to HKEY_LOCAL_MACHINE\Software\Far.
  86. #Shift-F7#  Toggle between ~"Keys as files" / "Keys as directories"~@Modes@.
  87.  
  88. #See the documentation for more info!#
  89.  
  90.  
  91. @WinError
  92. $ #Windows Error#
  93.  
  94. This message is shown by Registry Browser when any Windows error is encountered.
  95.  
  96. The message text is provided by Windows.
  97.  
  98. @ChType
  99. $ #Change Value Type#
  100.  
  101. In this dialog box you can change the type of the current registry value.
  102. If you don't know why you may need it, you don't need it :)
  103.  
  104. When this dialog box pops up, the current value type is selected
  105. initially. Thus, you can use this command just to look up the value type.
  106.  
  107. #Don't change the type if you don't know exactly what you do!#
  108.  
  109. Note: this command works only on single keys. No group operation in this
  110. version.
  111.  
  112. @-
  113. Possible Types:
  114. ---------------
  115.  None                     No defined value type.
  116.  String                   A null-terminated string.
  117.  Expanded String          A null-terminated string that contains
  118.                            unexpanded references to environment
  119.                            variables (for example, "%PATH%").
  120.  Binary                   Binary data in any form.
  121.  DWORD                    A 32-bit number (in little-endian format).
  122.  DWORD Big Endian         A 32-bit number in big-endian format.
  123.  Link                     A Unicode symbolic link.
  124.  Multi-String             An array of null-terminated strings,
  125.                            terminated by two null characters.
  126.  Resource List            A device-driver resource list
  127.                            in the resource map.
  128.  Full Resource Descriptor Resource list in the hardware description.
  129. @+
  130.  
  131. @Modes
  132. $ #Operation modes#
  133.  There are two operation modes of the plugin:
  134.  
  135. #Keys as files.# The keys can be distinguished from variables only if
  136. displaying sizes is enabled, the size of keys displayed is 0. Regedit is
  137. used to export keys as files.
  138.  
  139. Disadvantages of this mode: since FAR doesn't allow to intercept Ctrl-PgDn,
  140. this key cannot be used to get into a registry key like into a directory.
  141. To do this, use <Enter> or "cd" command. Moreover, it's hard to see the
  142. difference between keys and values in the panel.
  143.  
  144. #Keys as directories.# Ctrl-PgDn works here. Keys are color-highlighted properly
  145. (if files highlighting is enabled in FAR) and displayed, according
  146. to sorting rules, before the values. View/Edit work exactly like in the "keys as
  147. files" mode, but their windows are modal.
  148.  
  149. Disadvantages of this mode are: (1) viewing/editing keys are possible
  150. only in modal windows, that is, no window switching if a key is viewed/edited;
  151. (2) the built-in key NumPad5 doesn't work. But you can redefine it using
  152. a macro which "presses" F3 when you press NumPad5.
  153.  
  154. In most cases, the "Keys as directories" mode is recommended.
  155.  
  156. To toggle between these modes, press Shift-F7.
  157.  
  158. @CopyMove
  159. $ #Copy/Move#
  160.  
  161. #Copy.#
  162. In this version, everything entered in copy dialog is considered as a
  163. directory name. If the directory does not exist, it is created. In the
  164. "keys as directories" mode, the keys are still exported as .REG files rather than
  165. copied as trees of files made of values.
  166.  
  167. #Move.#
  168. Move is not implemented (do you really need it?). Instead, Copy works only.
  169.  
  170. @CreateNew
  171. $ #Creating new keys and values#
  172.  
  173. You can create empty keys with F7, like usual directories.
  174.  
  175. You can create new values either pressing Shift-F4, specifying the name of your
  176. new value and editing it, or copying a previously created file with the same
  177. name into the registry.
  178.  
  179. If the imported file has .REG file format (begins with REGEDIT4), then the
  180. file name doesn't matter, and regedit.exe is launched to import it.
  181.  
  182. If the file imported as a new value is either empty or contains characters
  183. beyond the 0x20..0x7e range, then the type of the new value is String,
  184. otherwise it's Binary. If you need to create variables of another type, such
  185. as DWORD, you can create the value as proposed and change its type with the
  186. ~Ctrl-A~@ChType@ command, or edit the parent key (in .reg format).
  187.  
  188. @Delete
  189. $ #Deleting Keys And Values#
  190.  
  191. When deleting a whole key, confirmation is asked only #once#, like on a usual
  192. file. (Like regedit does, to the point.) If there are both a key and a value
  193. under the same name, then the value is deleted. (This version can distinguish
  194. between keys and values only by name.)
  195.  
  196. Under Windows 95+, keys containing subkeys are deleted OK, under NT
  197. they are not deleted; you will have to remove all their subkeys.
  198.