home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / assemblr / library / sampler0 / display.doc < prev    next >
Text File  |  1987-10-20  |  5KB  |  109 lines
  1.  
  2.                         DISPLAY Version 1.1
  3.  
  4.         (c) Copyright Douglas Clark and William .C. Parke 1987
  5.  
  6.  Command  DISPLAY
  7.  ----------------
  8.  Purpose:  To quickly display  the contents of an ASCII text file,  page by
  9.            page or a single page, with the ability to show intense, reverse
  10.            video,  underline,  color, and  blinking characters using simple
  11.            text codes which can be entered from a standard text editor.
  12.  
  13.            DISPLAY  is particularly useful in batch files because of its
  14.            screen display speed and the ability to display words with
  15.            special attributes set.
  16.  
  17.  Format:   DISPLAY  [d:][path]filename [/p=string]
  18.  
  19.  Requirements:  MS-DOS 2.0 or higher; IBM PC or Compatible
  20.  
  21.  Using DISPLAY:  
  22.  
  23.    Operation:
  24.  
  25.            If no file name is given, DISPLAY shows a help screen.           
  26.         
  27.            If no page is given, DISPLAY loads the given file into memory
  28.            and shows its first page (23 lines).  Use the PgDn key to show
  29.            the next page, PgUp the previous page, Home to show the first
  30.            page, and End to return to the last shown page.  Use the ESC
  31.            key or CTL-C to exit DISPLAY.  Note, however, that DISPLAY
  32.            will automatically exit if the file has no more than one page
  33.            of text.
  34.  
  35.            If the /p=string switch is given, then DISPLAY will load the
  36.            given file into memory and search for the given page string
  37.            which is enclosed in a double carot prefix and suffix.  
  38.  
  39.            For example, if /p=MENU is on the command line, then the string
  40.  
  41.                      ^^MENU^^
  42.  
  43.            will be searched for.  If it is not found, an error message
  44.            is generated.  If it is found, then the following text will be
  45.            shown, after which DISPLAY exits automatically, putting the
  46.            cursor at the end of that text.
  47.    
  48.    DISPLAY in Batch Files:
  49.  
  50.            A principle use of DISPLAY is the fast generation of several
  51.            lines of text and extended IBM character graphics (including
  52.            boxes) from within batch files (command text files with the
  53.            extension BAT).  
  54.   
  55.            The 'standard' way for showing text from a batch file is to
  56.            use the ECHO command.  As users of BAT files know, several
  57.            such ECHO lines are generated at noticeable slow speeds 
  58.            compared to screen updates they may be accustomed to.
  59.            Moreover, it is often desirable to enhance menu choices
  60.            in BAT files with color, intense text, and graphic
  61.            boarders.
  62.  
  63.            DISPLAY lets the user generate a screen for his BAT file
  64.            using his favorite text editor.  By including special
  65.            text codes, enhanced displays can be designed.  Several
  66.            such screens can be put into one text file, with each
  67.            screen labeled by a page identifying string.  By including
  68.  
  69.                 DISPLAY file /p=string
  70.  
  71.            as a line in the BAT file, a very rapid display of the
  72.            custom screen identified by the string will be shown
  73.            when the BAT file is run.
  74.            
  75.    Using Special Text Enhancements:
  76.  
  77.            By including a backslash character followed by a one or
  78.            two letter mnemonic code, one can turn on special text
  79.            enhancements and attributes, such as intense, color,
  80.            reverse video, etc.  The attributes will remain in
  81.            effect until changed or turned off by a second such
  82.            code.
  83.  
  84.            The table below gives the code necessary to control text
  85.            attributes from within a text file:
  86.  
  87.            Monochrome:  Start Stop    Color: Character Screen
  88.            --------------------------------------------------
  89.             hide           \H   \h      blue       \cb    \sb
  90.             underline      \U   \u      green      \cg    \sg
  91.             reverse video  \R   \r      turquoise  \ct    \st
  92.             blinking       \B   \b      red        \cr    \sr
  93.             intense        \I   \i      violet     \cv    \sv
  94.             alternate ibm-              pink       \cp    \sp
  95.              character set \A   \a      white      \cw    \sw
  96.             
  97.            Some combinations of attributes are meaningful.  For 
  98.            example, \I\cr\sb will set intense red text characters
  99.            on a blue background screen.
  100.  
  101. Distribution:
  102.  
  103.            DISPLAY is supplied for personal, private use only.  The authors
  104.            can be reached through CHUG, the Capitol Heath/Zenith Users'
  105.            Group, Arlington, Virginia.
  106.  
  107.  
  108.  
  109.