home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / pascal / library / dos / edit / viewer / readme.txt < prev    next >
Encoding:
Text File  |  1994-03-09  |  4.0 KB  |  140 lines
  1.                   ===  INSTRUCTIONS ON VIEWER PROGRAMS ===
  2.  
  3. Two programs have been included in this package:
  4.  
  5.    browser.exe - a text file browser with syntax highlighting
  6.  
  7.    qd.exe - the "quick and dirty dump" program
  8.  
  9.    readme.txt - this file (as always)
  10.  
  11.    various demo fodder files
  12.  
  13. They aren't incredibly sophisticated, but I've got enough use out of them
  14. to figure someone else might, too.
  15.  
  16. These programs are free software (at least this release  --  March '94)
  17. subject only to the following restrictions:  The author (Robin Anderson)
  18. retains copyrights to the software, and any copies you distribute must be
  19. distributed with this file (readme.txt).  There!  That sounds like enough
  20. legalese to me.
  21.  
  22. BROWSER ------------------------------------------------------------------
  23.  
  24.    Usage:
  25.    ------
  26.  
  27.       BROWSER <text file> [-x] [ -43 | -50 ]
  28.  
  29.    Summary:
  30.    --------
  31.  
  32.       This program is a text file browser that also does syntax highlighting
  33.       on C/C++ programs, and, partially, Pascal and xBase programs.
  34.  
  35.       This program opens the file in read-only mode.
  36.  
  37.       It can also display in EGA/VGA 43/50 line mode.
  38.  
  39.       Use the cursor keys to move through the file, and the Esc key to quit.
  40.  
  41.       C++ source code is available, please e-mail Rob Anderson at 70353,3430.
  42.  
  43.    Examples:
  44.    ---------
  45.  
  46.       Try the following commands on the sample files included:
  47.  
  48.          browser readme.txt
  49.  
  50.          browser kbtest.c
  51.  
  52.          browser comtst.pas
  53.  
  54.          browser balance.prg
  55.  
  56.    Bugs:
  57.    -----
  58.  
  59.       Program expects a color monitor.
  60.  
  61.       You must specify -43 for EGA only, and -50 for VGA only.
  62.  
  63.       The syntax highlight colors can't be changed.
  64.  
  65.       Horizontal scrolling is quite slow.
  66.  
  67.       Browsed file can be no more than 2000 lines and/or about 150k.
  68.  
  69.       Program does not expand tabs.
  70.  
  71. QD -----------------------------------------------------------------------
  72.  
  73.    Usage:
  74.    ------
  75.  
  76.       QD <binary file>
  77.  
  78.    Summary:
  79.    --------
  80.  
  81.       This program is a binary file dump program.  Unlike most other dump
  82.       utilities, it allows you to alternate between "raw" and "formatted"
  83.       views of the data.
  84.  
  85.       This program opens the file in read-only mode.
  86.  
  87.       Commands:  Q - quit; N (or most keys) - next "record" (advance current
  88.       record length bytes into the file); P - previous (opposite of next);
  89.       O - offset (go to byte n of the file); L - length of record (set
  90.       increment/decrement amount); F - format (select file to be used as a
  91.       "format file" describing a record); R - raw mode (resume display style
  92.       as at program startup).
  93.  
  94.       Numeric arguments can be entered in decimal or in hex (by preceding the
  95.       hex code with an 'x').
  96.  
  97.       Format files have the following layout:
  98.  
  99.          0 to 22 lines with a numeric followed by spaces and a short
  100.          description of a "field".  The numeric is the length of the field,
  101.          the text is the label to display by it.
  102.  
  103.          0 or 1 line containing an '*' immediately followed by a numeric.  The
  104.          numeric is the total "record" length.
  105.  
  106.       ANSI C (Unix compatible) source code is available, please e-mail
  107.       Rob Anderson at 70353,3430.
  108.  
  109.    Examples:
  110.    ---------
  111.  
  112.       Try the following commands on the sample files included:
  113.  
  114.          qd roommate.dbf{Enter}
  115.  
  116.             Ox20{Enter}             (note the 'O' as in offset, not zero)
  117.             Ffld.f{Enter}
  118.             {Enter}
  119.             {Enter}
  120.             O98{Enter}
  121.             Frec.f{Enter}
  122.             {Enter}
  123.             {Enter}
  124.             {Enter}
  125.             Q
  126.  
  127.    Bugs:
  128.    -----
  129.  
  130.       You can continue to "seek" page after page past EOF, but nothing
  131.       displays, of course.
  132.  
  133.       Numerics entered in format files must be in decimal, not hex.
  134.  
  135.       Hex numerics are entered by preceding the digits with an 'x', but are
  136.       displayed as ????h.
  137.  
  138. --------------------------------------------------------------------------
  139. March 1994
  140.