home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / database / datamage.arj / DOCS.ZIP / VIEW.DOC < prev    next >
Encoding:
Text File  |  1991-09-26  |  5.1 KB  |  106 lines
  1. Monte Ward
  2. 623 S. 7th St.
  3. Terre Haute, In
  4. 47807 - U.S.A.
  5. January 27, 1991
  6.  
  7. THE VIEW UTILITY:
  8.  
  9. View  is a program designed to allow browsing and printing of text  files.   It
  10. will  operate  with ascii, wordstar or binary files.  The  hex  display  leaves
  11. something to be desired, namely the cursor and the offset of the cursor in  the
  12. file.  This is not the real purpose of the program.  I just threw it in.
  13.  
  14. PROGRAM STARTED WITH NO COMMAND LINE ARGUMENTS:
  15.  
  16. If  you  just  type  VIEW from your DOS command line  you  have  bypassed  file
  17. selection.   In this case the program will respond by reading the files in  the
  18. default  directory and presenting them in a window.  You may select a  file  by
  19. pressing  your up/down arrow keys, the page up/down keys or the home/end  keys.
  20. When you have your file highlighted in the window, hit return/enter.
  21.  
  22. When  you  have finished your viewing/printing of the file press  escape.   You
  23. will return to the window, and you may select another file.  Or, you can  press
  24. escape  again.   If you do, you will be prompted for the pathname  for  another
  25. window full of files.  If you wish to terminate the program press return/enter.
  26.  
  27. Let's  say you start VIEW from your C:\WS directory, containing  your  Wordstar
  28. and  it's text files.  You then select a file and, using  character  filtration
  29. mode two (for Wordstar files), you quickly browse a Wordstar file.
  30.  
  31. Then you hit escape to end your access of that file.  The screen with the  file
  32. selection  window re-appears.  Now, you want to read a  DATAMAGE  documentation
  33. file.   By pressing escape a second time you get a prompt for the  pathname  of
  34. the files you want to access.  DATAMAGE docs are in the C:\MAGE\DOCS directory.
  35.  
  36. So, you enter C:\MAGE\DOCS.  The program reads your disk and displays a  window
  37. filled  with the DATAMAGE docs.  You select one of these files, then the  ascii
  38. character filtration mode.  You read and/or print this file.
  39.  
  40. Now,  you  wish to terminate the VIEW program, as you  have  finished  browsing
  41. files.   Press escape to end the access to the DATAMAGE doc file, press  escape
  42. to  bypass  selection  of another file in the current window,  and  then  press
  43. return/enter to end the VIEW program and return to the MS-DOS command level.
  44.  
  45. COMMAND LINE ARGUMENTS:
  46.  
  47. You may specify the target file, the character filtration mode or both from the
  48. command line.  If you do the program will load the file and display it.
  49.  
  50. Let's say your default directory is now C:\WS,  and  you start VIEW by entering
  51. VIEW  C:\MAGE\DOCS\MAIN.DOC.  The program opens the file, then prompts you  for
  52. the  character filtration mode.  The file is then displayed, and when  you  hit
  53. escape  the program displays the files window to select another file.  You  may
  54. access a file from the menu or press escape.  If you press escape you may enter
  55. the pathname for another file, or hit return/enter to exit VIEW.
  56.  
  57. If  you enter VIEW C:\MAGE\DOCS\MAIN.DOC 1 the program loads the file with  the
  58. ascii  character  filtration mode and displays it.  When you  hit  escape,  the
  59. program ends without displaying the files window, etc.
  60.  
  61. PRINTING FILES:
  62.  
  63. VIEW will print any file it loads.  But it is a bit more useful than that as it
  64. starts  printing  at the top of the current screen.  If you wish  to  print  an
  65. entire file be certain that you press your HOME key first.  That will move  the
  66. display to the first of the file, and you will get the whole file.
  67.  
  68. When you print a file the screen will display what is being printed.  The  text
  69. will scroll by you on the screen.  If you wish to print only part of a file you
  70. may  hit  a key at any time during the printing process.  This  will  stop  the
  71. printout.  At least one full screen will print.
  72.  
  73. HOW IT WORKS:
  74.  
  75. Unlike the TYPE (FILENAME)|MORE utility offered by MS-DOS, VIEW does NOT make a
  76. copy of the file.  It can be used on full or write-protected disks.
  77.  
  78. When VIEW loads a file the file is read and the lines in the file are stored as
  79. offsets  into the file in the computer's memory.  As you browse the file it  is
  80. read in off disk, piece by piece, and displayed.
  81.  
  82. LIMITATIONS:
  83.  
  84. The  program  is limited to files having eight thousand lines  or  less.   That
  85. includes most all files.  If the file is longer than eight thousand lines  only
  86. the first eight thousand lines can be displayed/printed.
  87.  
  88. REGISTRATION:
  89.  
  90. If you feel that VIEW offers facility to you and if you are the (rare) kind  of
  91. person  who would like to pay for what you have I will accept registrations  in
  92. any amount.  Five dollars is suggested.
  93.  
  94. For  those  of you who send in ten dollars or more I will send you,  by  return
  95. mail,  a  shareware  copy of DATAMAGE, my database.  I will  also  send  you  a
  96. receipt good for the amount you sent off the registration price of DATAMAGE.
  97.  
  98. SOURCE CODE:
  99.  
  100. The code for VIEW is available for $25.  I used quick c 2.5 to do it.  There is
  101. not so much as a single byte of code or object that was bought, borrowed copied
  102. or stolen.  There is no "toolkit" involved.
  103.  
  104. The $25, however, is NOT refundable towards DATAMAGE registration.  But I  will
  105. also send you a shareware DATAMAGE.
  106.