home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / filutl / fix220.arc / FIX.DOC next >
Text File  |  1989-08-13  |  10KB  |  262 lines
  1.             August 13, 1989
  2.  
  3.  
  4. FIX - File Fix, Version 2.20 - This binary editor will allow you
  5. to conveniently view and edit any type of file - read-only,
  6. hidden or system - in ASCII or hex.  Select files from a
  7. scrollable, pop-up directory window.  Version 2.20 adds two new
  8. features:  1) a command to jump directly to a specified offset
  9. within the file and 2) a simple text-search feature that will
  10. take you to the next record containing the string for which you
  11. are searching.
  12.  
  13. Contents:
  14. =========
  15. Purpose
  16. Installation
  17. Commands
  18. Program background
  19. Other programs
  20. Closing remarks
  21.  
  22. Purpose:
  23. ========
  24. For use on IBM PC's and compatibles to view and edit any type of
  25. file, text or binary, read-only, hidden or system.  Will not
  26. extend the size of a file, only replace characters.
  27.  
  28. This program is especially useful for working with simple
  29. random-record files (e.g. those created by BASICA/GWBASIC
  30. programs).
  31.  
  32. This is FREE software.  This program was written by me for my
  33. personal use.  However, if you or others also find it useful,
  34. you may freely use it or pass it along.  Please include this DOC
  35. file if you do share it.
  36.  
  37. Installation:
  38. =============
  39. No special installation is necessary.  Just copy the FIX.EXE
  40. file to the disk from which you will be invoking the command.
  41. It is suggested, however, that you copy this file to a directory
  42. included on your PATH.
  43.  
  44. The default display mode is color.  However, if you don't have a
  45. color monitor and have trouble viewing the display, try using
  46. the SET FIXCOLOR=OFF command.  The SET command may be invoked
  47. from the DOS prompt, although it will probably be more
  48. convenient to include this command in your AUTOEXEC.BAT file.
  49.  
  50. Included in the distribution archive is SAMPLE.DAT, a sample
  51. binary data file which includes all 256 possible characters in
  52. numerical sequence (all of which are available for viewing in a
  53. file with the exception of ASCII codes 0 and 255).  Use it to
  54. familiarize yourself with how the program displays characters.
  55.  
  56. Commands: 
  57. =========
  58. Invoking the program:
  59. ---------------------
  60. You may specify the file to view either from the command line or
  61. from within the program:
  62.  
  63.     Examples:  fix
  64.                    fix myfile.dat
  65.                    fix c:\command.com
  66.  
  67. To invoke the pop-up directory at program start-up, specify
  68. wildcards, an existing directory name or an existing drive on
  69. the command line:
  70.  
  71.     Examples:  fix *.*
  72.                    fix c:\mydir\
  73.                    fix d:
  74.  
  75. [Tip:  Specifying just a drive designation as in the last
  76. example is useful even if you just want to see what files and
  77. directories are on the disk and don't wish to view their
  78. contents.]
  79.  
  80. Besides using the SET FIXCOLOR=OFF command as described in the
  81. Installation section above, you may also use the "/b" switch to
  82. invoke the program in black-and-white (BW) mode.
  83.  
  84. Examples of using the "/b" switch:
  85.  
  86.         fix /b
  87.                 fix/b c:\*.*
  88.                 fix \autoexec.bat /b
  89.  
  90. There is also a /c option to override the SET FIXCOLOR=OFF
  91. command to run the program in color.
  92.  
  93. Options entered at the command line will take precedence over
  94. the FIXCOLOR environment variable.
  95.    
  96. [There is an "undocumented" feature to toggle the display
  97. between color and BW mode.  This is the <Alt-C> command issued
  98. when at the main command prompt while viewing a file.  This
  99. feature was included to test the appearance of the display
  100. during program development.  It may or may not be supported in a
  101. future release.]
  102.  
  103. When prompted for the name of the file to view, entering
  104. wildcards, the name of a directory (usually terminated in a
  105. backslash) or a drive designation will cause a directory window
  106. to pop up.  (Just pressing <Ret> without entering a filename is
  107. equivalent to entering "*.*".)
  108.  
  109. When in the pop-up directory window, use <Up>, <Dn>, <PgUp>,
  110. <PgDn> to move up and down a line or a page at a time.  <Home>
  111. will take you to the top window for that directory, <End>, the
  112. bottom window.  Pressing <Ret> on a file name will exit the
  113. selection window and display the file.  Pressing <Ret> on a
  114. directory name will take you into that directory.  <Esc> will
  115. take you back to the filename prompt leaving the file
  116. specification as you entered it.
  117.  
  118. Main program commands:
  119. ----------------------
  120.  
  121.     Key  Mnemonic  Description              Alternate Command Keys
  122.     ---  --------  -----------------------  ----------------------------------
  123.     F1   Help      Help screen              H, 1
  124.     F2   Another   Select another file      A, 2
  125.     F3   Size      Change record size       S, 3
  126.     F4   Edit      Edit displayed record    E, 4
  127.     F5   Goto      Select by record number  G, 5
  128.     F6   First     View first record        F, 6, <Home>
  129.     F7   Prev      View previous record     P, 7, <Up>, <PgUp>, <Left>
  130.     F8   Next      View next record         N, 8, <Dn>, <PgDn>, <Right>, <Ret>
  131.     F9   Last      View last record         L, 9, <End>
  132.     F10  Quit      Quit program             Q, 0, <Esc>
  133.  
  134.     Alt-F5         Select by file offset
  135.     Alt-F          Find text
  136.  
  137. New commands:
  138. -------------
  139. <Alt-F5> will prompt for and take you directly to the record
  140. containing a specific offset within the file [0..FileSize-1].
  141. This is useful for quickly moving to a location specified by an
  142. external program that generates offset information - DOS's own
  143. COMP command, for example.
  144.  
  145. Pressing <Alt-F> will cause the program to prompt you for a
  146. string of text to search for.  The search starts from the next
  147. record after the current record in the file.  Once a search
  148. string is specified, the program "remembers" it the next time
  149. the <Alt-F> hot key is used, so you can find successive
  150. occurrences of the same string by repeatedly pressing <Alt-F>
  151. followed by <Ret>.  The search is not case-sensitive so upper-
  152. and lower-case alphabetic characters are handled equivalently.
  153.  
  154. Record-edit mode:
  155. -----------------
  156. When in record-edit mode, you may use the down arrow key to
  157. "cursor down" to the hex level and edit characters by their hex
  158. codes.  The <Tab> key will take you quickly to the ends of the
  159. rows.  To save your changes after editing, press the <Enter>
  160. key.  You will be prompted for comfirmation.  Use the <Esc> key
  161. to abort changes made without saving them.
  162.  
  163. Editing of read-only files is allowed.  After editing such a
  164. file, the file attributes are left unchanged from before, except
  165. that the archive bit is always set.
  166.  
  167. String edit:
  168. ------------
  169. Whenever string input is requested in the program (indicated by
  170. a highlighted input field), you may use the familiar editing and
  171. cursor movement keys to edit your input (eg. <Ins>, <Del>,
  172. <Home>, <End>, <Left>, <Right>, etc.).  If a string has already
  173. been entered, <Esc> will clear the input field.  <Esc> pressed
  174. on an empty field will exit the input function.
  175.  
  176. Cancelling an operation:
  177. ------------------------
  178. When in doubt or you wish to cancel a feature, pressing the
  179. <Esc> key will often work.
  180.  
  181. Program background:
  182. ===================
  183. This program has evolved starting from my CP/M days, when I took
  184. over the work of another programmer in maintaining a set of
  185. BASIC programs that made extensive use of random-record data
  186. files.
  187.  
  188. The original version of this program was written in Pascal
  189. because it seemed the best tool for the job at the time.  As I
  190. progressed through different languages, I rewrote this tool a
  191. number of times, each with little or no reference to previous
  192. source code.  Each resulting program thus had a flavor of its
  193. own.  The current series were written in JPI TopSpeed Modula-2.
  194.  
  195. Other programs:
  196. ===============
  197. Other free programs which I have written and contributed to the
  198. public domain are:
  199.  
  200. CAL100
  201. ------
  202. CAL - Calendar V1.00 - 06/03/89 - A simple, stand-alone calendar
  203. display program that can be used as a sort of perpetual
  204. calendar.  Valid years range from 0001 to 9999 (arbitrary).
  205. This program is NOT memory-resident.  Scroll through the
  206. different months and years.  Although the executable file is
  207. stand-alone, I don't consider this a complete program.  I've
  208. contemplated using the included routines as the starting point
  209. for a scheduling program, for example.  Source code included.
  210.  
  211. CRC-M2
  212. ------
  213. CRC-M2 - Cyclic Redundancy Checker V1.00 - 07/12/89 - This tiny
  214. CRC program accepts wildcards and multiple filespecs from the
  215. command line.  Displays same CRC values as PKPAK and LHarc.
  216. This type of program is usually written in assembly language.
  217. In fact, I adapted the algorithms from some publicly available
  218. assembly language routines.  Source code included.
  219.  
  220. DDEL124
  221. -------
  222. DIRDEL - Directory Delete, Version 1.24 - 07/15/89 - This
  223. program will delete an entire subdirectory trees - even those
  224. containing read-only, hidden and system files and directories.
  225. It will even delete the current directory.  The executable file
  226. for this version is significantly smaller than before.  Source
  227. code included.
  228.  
  229. FND106
  230. ------
  231. FFIND - File Finder, Version 1.06 - 07/31/89 - This program will
  232. find any file or subdirectory on your hard disk, including
  233. hidden and system files.
  234.  
  235.     Usage:  ffind [d:][filename][.ext]
  236.     
  237. Wildcards are accepted.  Improvements for this version include
  238. an overall increase in speed and a smaller executable filesize.
  239. Source code included.
  240.  
  241. All the above programs were written entirely in JPI TopSpeed
  242. Modula-2 (assembly not required).
  243.  
  244. Closing remarks:
  245. ================
  246. Interested users are encouraged to contact me with comments, bug
  247. reports, suggestions and questions about the program.  I can be
  248. reached at the addresses below:
  249.  
  250.  
  251.                 By conventional mail:
  252.                 ---------------------
  253.                Raymond T. Kaya
  254.         P. O. Box 1436
  255.                 Honolulu, HI  96806
  256.  
  257.  
  258.         By electronic mail:
  259.                 -------------------
  260.                CompuServe:  71230,2500
  261.                GEnie:       R.KAYA1
  262.