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