home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / progm / c-util.zip / XC.DOC < prev    next >
Text File  |  1984-02-05  |  2KB  |  68 lines
  1.           XC  -  A 'C' Concordance (XREF) Utility
  2.           =======================================
  3.  
  4. 'XC' is a cross-reference utility for 'C' programs.  Its has the
  5. ability to handle nested include files to a depth of 8 levels and
  6. properly processes nested comments.  Option flags support the
  7. following features:
  8.  
  9. - Routing of list output to disk
  10. - Cross-referencing of reserved words
  11. - Processing of nested include files
  12. - Generation of listing only
  13. - Output page width
  14.  
  15. Usage: xc <filename> ...  <flag(s)>
  16.  
  17. All files listed are crossreferenced together.  The veriable listing
  18. will show every occurance, for example, of 'var' in every file.
  19.  
  20. Flags: -i            = Enable file inclusion
  21.        -l            = Generate listing only
  22.        -r            = Cross-ref reserved words
  23.        -o <filename> = Write output to named file
  24.        -w width      = Width of output page; default=78
  25.  
  26.        Flags must follow all filenames
  27.  
  28. Examples:
  29.  
  30.        xc my.c
  31.  
  32.        xc main.c sub1.c sub2.c sub3.c -o xref.lst -w 120
  33.  
  34. History:
  35.  
  36. Version 1.0   January, 1982
  37. Copyright (c) 1982 by Philip N. Hisley
  38.         Philip N. Hisley
  39.         548H Jamestown Court
  40.         Edgewood, Maryland 21040
  41.         (301) 679-4606
  42. Released for non-commercial distribution only
  43.  
  44. Converted to IBM/PC CI/C86 by David N. Smith, May/June 1983
  45. with enhancements and Lattice compiler support in December 1983.
  46.         David N. Smith
  47.         44 Ole Musket Lane
  48.         Danbury, CT 06810
  49.         (203) 748-5934
  50.         CompuServe: 73145,153
  51. Changes Copyright (c) 1983 by David N. Smith
  52. Permission granted to copy for non-commercial purporses.
  53.  
  54. PC Enhancements include:
  55.      1)  Nested #INCLUDE statements
  56.      2)  Single spaced cross-reference list
  57.      3)  Removal of tabbing on output device
  58.          (Since many printers don't support it)
  59.      4)  #INCLUDE statements with both "--" and <-->
  60.          syntax and with a full fileid in the quotes.
  61.          (Paths are not supported.)
  62.      5)  Multiple input filenames on command line.
  63.  
  64. The current PC version only supports Lattice.  Conversion to others
  65. should be relatively easy but see the compile time variable "Lattice"
  66. for compiler specific sections.
  67.  
  68.