home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / DBASE / DBV122.ZIP / DBV.DOC < prev    next >
Text File  |  1992-08-08  |  7KB  |  172 lines
  1. DBV-DBF View, Version 1.22                             08-Aug-92
  2.  
  3.  
  4. Simple viewer for taking quick looks inside dBASE-compatible .DBF files in
  5. record and browse modes.  Does single-field, scan-across searches.  File
  6. header info, including field definitions, can be displayed either in
  7. interpreted (human-readable) format, or as hex bytes.  Editing of fields in
  8. both record and browse modes enabled by command-line switch.  New:  The /Fx
  9. switch sets different levels of filtering for .DBF files.
  10.  
  11. Contents:
  12. =========
  13. Disclaimer
  14. Purpose
  15. Display
  16. Syntax
  17. Switches
  18. Configuration
  19. Commands
  20. Background
  21.  
  22. Disclaimer:
  23. ===========
  24. DBF View (DBV) and this documentation are offered as is.  The user bears the
  25. entire risk of this software not performing as expected.
  26.  
  27. Purpose:
  28. ========
  29. For taking quick looks into .DBF files without having to load a
  30. full-featured database program.
  31.  
  32. By user request, field editing has been incorporated into the program
  33. starting from Version 1.20.  Editing is enabled by command-line switch (see
  34. "Switches" below).
  35.  
  36. DBV is a generic .DBF file viewer/editor.  As there are different types of
  37. index files, these are ignored in searches and editing.
  38.  
  39. DBV is a free program.
  40.  
  41. Display:
  42. ========
  43. The program displays either in color or "black-and-white" based on the video
  44. mode at program start-up.  However, if the user has a color graphics card,
  45. but no color monitor, the display may be improved by using the DOS command
  46. "MODE BW80".  Conversely, color mode may be forced on by using "MODE CO80".
  47.  
  48. A command-line switch is also available to force black-and-white mode.  See
  49. "Switches" below.
  50.  
  51. EGA/43- and VGA/50-line modes are supported.  At program start-up, an
  52. attempt is made to detect the actual number of lines on the screen, up to a
  53. maximum of 50, and to adjust the display accordingly.
  54.  
  55. Syntax:
  56. =======
  57.  
  58.         Usage:  DBV [switches] [filespec]
  59.  
  60. If no extension is specified for "filespec", ".DBF" is assumed.  If a valid
  61. filename is specified unambiguously, the file is immediately displayed. 
  62. Either specifying "filespec" using wildcards, or specifying a drive or
  63. directory name causes a scrollable directory window to pop up.  Simply
  64. typing the program name is the same as specifying "*.DBF".
  65.  
  66.         Examples:       DBV C:          <- current directory of drive C:
  67.                         DBV D:\         <- root of drive D:
  68.                         DBV \DBASE\DATA <- data subdirectory of \DBASE
  69.  
  70. Switches:
  71. =========
  72. /BW     Black-and-White mode.  Provided as an alternative to using DOS's
  73.         "MODE BW80" command.
  74.  
  75. /E      enable field Edit.  Index files are ignored, and will have to be
  76.         maintained by the user.
  77.      
  78. /Fx     Where 'x' represents 0/1/2, as follows:
  79.  
  80.         F0 - don't filter (fastest)
  81.         F1 - check only for files with the .DBF extension (default)
  82.         F2 - check all files for valid dBASE files (slowest)
  83.  
  84. /W      start program in Wide (browse) mode.
  85.  
  86. Either '/' or '-' may be used to specify switches.
  87.  
  88. Entering an invalid switch causes the program to display a brief help screen
  89. then exit.
  90.  
  91.         Examples:       DBV /h
  92.                         DBV -?
  93.  
  94. Configuration:
  95. ==============
  96. An optional configuration file containing user-selected default switches may
  97. be created or edited with any editor or word processor which can save pure
  98. ASCII text files.  This file should be named "DBV.CFG" and placed in the
  99. same directory from which DBV.EXE is loaded (DOS 3.0 and above).
  100.  
  101. Switches, including switch options, may either be separated by spaces or
  102. placed on separate lines.
  103.  
  104. Incompatible switches used on the command line will override switches
  105. included in DBV.CFG.  Switches are evaluated from left to right on the
  106. command line.
  107.  
  108. A sample DBV.CFG file is included in the distribution archive for DBV. 
  109. After extracting the contents of the distribution archive, DBV.CFG may be
  110. deleted if DBV's defaults are satisfactory.
  111.  
  112. Commands:
  113. =========
  114. <F1>, or the letter 'I', will display overall information on the .DBF file. 
  115. Pressing <F1> a second time, or the letter 'H', will open up a window
  116. showing how this information is represented on disk as hex bytes.
  117.  
  118. <F2>, or the letter 'F', will display general information on each field. 
  119. Pressing <F2> a second time, or the letter 'H', will open up a window
  120. showing how this information is represented on disk as hex bytes.
  121.  
  122. <F3>, or the letter 'E', allows one to edit the current field.  This option
  123. is only available if the /E switch has been specified on the command line or
  124. included in DBV.CFG (see "Configuration" below).
  125.  
  126. <F4> will toggle between Browse and Record modes.
  127.  
  128. <F5>, or the letter 'G', opens up an input window into which you can type
  129. the (sequential) number of the record you wish to jump to.
  130.  
  131. <F7>, or the letter 'S', will allow a forward search for the input string. 
  132. This search is of the "scan-across" variety, i.e. the search will include
  133. embedded strings.  New searches start from the first record.  Subsequent
  134. searches on the same input string (by pressing <Enter> to accept the
  135. previous string) will start from after the current record.
  136.  
  137. <F10>, <Esc>, or the letter 'Q', will quit the program.
  138.  
  139. The <PgUp>, <PgDn>, <Home>, <End> and arrow-keys, possibly used in
  140. conjunction with the <Ctrl> key, will hopefully have the intuitive effects.
  141.  
  142. When in Browse mode, either <Tab> or <Right-Arrow> will move right one field
  143. at a time.  <Shift-Tab> and <Left-Arrow> will have the opposite effect.  The
  144. <Ctrl> key, used in combination with the left- and right- arrow keys will
  145. page left and right, respectively.
  146.  
  147. The letters 'P' (previous) and 'N' (next) are synonyms for the <PgUp> and
  148. <PgDn> keys, respectively.
  149.  
  150. Background:
  151. ===========
  152. I wrote DBV to test my understanding of .DBF file structure.  A pre-release
  153. version of DBV allowed field editing.  I disabled this feature before the
  154. first public release because I was inconvenienced by having to rebuild my
  155. multi-field index files with my regular database program, after editing with
  156. DBV.
  157.  
  158. A few users have requested that I add field editing to DBV.  They don't seem
  159. to mind having to maintain their own index files.  Although I would have
  160. preferred leaving DBV as a simple viewer, adding editing back was simple, as
  161. I already had the required routines at hand.  I've decided that, for now at
  162. least, editing would be enabled only by specifying the appropriate switch.
  163.  
  164. --
  165.  
  166.                 Raymond T. Kaya
  167.                 P. O. Box 1436
  168.                 Honolulu, HI  96806
  169.  
  170.                 CompuServe:  71230,2500
  171.                 GEnie     :  R.KAYA1
  172.