home *** CD-ROM | disk | FTP | other *** search
/ The C Users' Group Library 1994 August / wc-cdrom-cusersgrouplibrary-1994-08.iso / vol_100 / 186_01 / view151.doc < prev   
Text File  |  1985-08-21  |  3KB  |  83 lines
  1. DOCUMENTATION FOR VIEW, VERSION 1.51
  2. 12/09/85
  3.  
  4.  
  5. This file supplements the information given in VIEW.DOC and TXTPLOT.DOC.
  6. Those files were designed for inclusion with the version of VIEW for the 
  7. NEC PC-8801A that was distributed by the NEC-AIDS group.  VIEW, version
  8. 1.51 has been slightly altered to make it more portable, and is
  9. distributed via the C Users' Group.
  10.  
  11. For information on the usage of VIEW, see VIEW.DOC
  12.  
  13. Compilation and customization notes:
  14.  
  15. VIEW was designed to use memory-mapped video via the BDS C function
  16. txtplot().  This function was enhanced to add the following:
  17.  
  18.     -- All control characters are skipped (except TABS)
  19.     -- Strings can be terminated by a CR or a NUL
  20.     -- Plotting stops at the end of the screen row, whether the
  21.        string is complete or not
  22.     -- Parity is stripped from all characters
  23.     -- Tab size is variable 
  24.  
  25. These enhancements make the use of txtplot() for text-file-oriented
  26. applications easier.  The source code for txtplot() is in TXTPLOT.CSM.
  27. Documentation for this is given in TXTPLOT.DOC.  Although the audience
  28. for TXPLOT.CSM and TXTPLOT.DOC was NEC users, the code can be easily
  29. adapted for any system that supports memory-mapped video.
  30.  
  31. If you use the memory-mapped version of TXTPLOT, you'll want to set
  32. the symbol MAXCOL to your screen width. Note that the documentation
  33. for TXTPLOT.CSM is aimed at the NEC audience, so the exact numbers
  34. mentioned there are not necessarily accurate for anyone else. 
  35.  
  36. A version of the txtplot function that does NOT use memory-mapped video
  37. is given in the file TXTPLOT.C.  This function will work with VIEW,
  38. version 1.51, although not as swiftly as the other.  
  39.  
  40. If you use the non-memory-mapped version of TXTPLOT, you'll have to
  41. customize the gotoxy() function and the MAXCOL symbol.
  42.  
  43.  
  44. To compile VIEW:
  45.  
  46.     CC VIEW
  47.         SUBMIT CASM TXTPLOT    (memory-mapped version)
  48.               or
  49.         CC TXTPLOT        (Non-memory-mapped version)
  50.     L2 VIEW TXTPLOT -L WILDEXP -N
  51.  
  52. There are four macros at the beginning of VIEW151.C that will need
  53. customization. They handle various video escape sequences:
  54.  
  55.     -- clear() clears the screen
  56.     -- home() homes the cursor (upper left corner)
  57.     -- cursbot() moves the cursor to the bottom right corner
  58.     -- lnins() inserts a blank line ahead of the cursor position.
  59.        It is used to get a scroll down.
  60.  
  61. The symbols MAXROW and LASTROW will need to be set for your system.
  62. Also, the symbols BASE, XSIZE, and YSIZE will need to be set to 
  63. initialize the memory-mapped video parameters in C.CCC properly.
  64. If you've changed CCC.ASM to permanently set the proper values
  65. for these, then you can delete the setplot() call in VIEW.
  66.  
  67. The only other customizations that might be necessary involve the
  68. buffer size.  Currently, the buffer is divided into two 16K segments.
  69. If your system does not have enough free memory to handle a 32K buffer,
  70. or if it has enough to handle a larger buffer, then you will want to
  71. redefine the symbol SEGBLKS.
  72.  
  73.  
  74. Enjoy, and please report any bugs or possible enhancements to me.
  75.  
  76. James Pritchett
  77. 275 Bleecker St., Apt. 1
  78. New York, NY  10014
  79.  
  80. 
  81. will produce 4-space tabs.
  82.  
  83. As many filenames as will fit on th