home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / PRINTER / XC3.ZIP / XC3.DOC < prev   
Encoding:
Text File  |  1985-02-22  |  2.6 KB  |  55 lines
  1. 'XC' is a cross-reference printing utility for 'C' programs. It has the 
  2. ability to handle nested include files to a depth of 8 levels and 
  3. properly process nested comments. Important features of 'XC' are as
  4. follows:
  5.                                  
  6. - Provides the capability to set the printer to compressed print mode. 
  7.     
  8.     The program may be customized for any printer by modifying the print
  9.     control strings in the program.  These string are:
  10.  
  11.               cprint_hdr sets the printer to compressed print mode       
  12.               cprint_trlr resets the printer to "normal" mode            
  13.  
  14.     These strings can be found in the source code with a text editor and
  15.     modified to comform to the user's printer.
  16.  
  17. - If a form feed is detected in the source file, a new page is started.  This 
  18.     is useful for structuring the source code by placing each major
  19.     section on a separate page.  You do this by embedding a form feed
  20.     (control L) in a comment.  The text following the form feed will be 
  21.     placed on the top of the new page.  The page numbering will be
  22.     incremented and a new header line will be placed on the    new page.                                 
  23.  
  24. -  Tab characters in the file are expanded to every 8 positions.
  25.  
  26.     This may be changed by changing the TABCNT define in the source code. 
  27.         
  28. -  The current date and time and the file latest update date and time are 
  29.     included in the page header line.  The file date and time are 
  30.     identical to that found in a DIR listing.
  31.  
  32.         NOTE: This feature utilizes PC-DOS 2.0 calls and will
  33.         probably not operate correctly on DOS 1.1.  This feature
  34.         also utilizes two CI C-86 library functions (sysint and
  35.         segread).  If you wish to modify the program, these functions
  36.         or their equivalent must be used.  Segread returns the
  37.         4 segment registers, and sysint allows the user to 
  38.         issue an interrupt and set the registers prior to the 
  39.         interrupt as well as returns the values of the registers to
  40.         the caller. 
  41.  
  42. -  Control characters (other than \n, \f, or \t) are stripped from the input 
  43.     stream (converted to blanks).  This prevents extraneous control 
  44.     characters in the input file from interfering with the operation of XC.
  45.                          
  46. Usage: xc <filename> <flag(s)>               
  47.                                  
  48.       Flags: -i        = Enable file inclusion       
  49.            -l        = Generate listing only       
  50.              -c            = Compressed print listing (Prism/Microprism printer
  51.          -e           = Compressed print listing (Epson printer)
  52.            -r        = Cross-ref reserved words       
  53.            -o <filename> = Write output to named file    
  54.                                  
  55.