home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / a / ccref.lbr / CCREF.DZC / CCREF.DOC
Encoding:
Text File  |  1993-10-26  |  2.0 KB  |  72 lines
  1.                             CCREF.DOC
  2.  
  3.              CROSS-REFERENCE C PROGRAM SOURCE FILES
  4.  
  5. CCREF will generate a cross-reference listing for a program 
  6. written in the C language.  (Actually, CCREF may be used to 
  7. cross-reference any text file, but C keywords and operators will 
  8. be ignored.)
  9.  
  10. At the > prompt, type
  11.  
  12.      CCREF filname1.typ filname2.typ ...
  13.  
  14. to produce a global cross-reference of the C source files named 
  15. filname1.typ, filname2.typ, etc., and display results on the 
  16. terminal.  One or more source files may be included on the com-
  17. mand line.  It is normally desirable to record results for later 
  18. use; therefore, use the command
  19.  
  20.      CCREF filname1.typ filname2.typ ... >output.fil
  21.  
  22. to cross-reference and save results in the file named output.fil.  
  23. The symbol > followed immediately (with no spaces) by the output 
  24. filename must appear as the last item on the command line.
  25.  
  26. With either command form, it takes considerable time for the 
  27. program to complete.  If the second form is used, there will 
  28. normally be no output sent to the terminal; therefore, CCREF may 
  29. be detached using the MP/M signal <CTRL-D>, freeing the terminal 
  30. for additional activity.
  31.  
  32. Sample output from CCREF is listed below.  This sample was pro-
  33. duced by typing the command
  34.  
  35.      CCREF MODEM.C MODEMF1.C MODEMF2.C >MODEM.REF
  36.  
  37. The first three lines list references to #include statements, 
  38. although this fact is not identified in the output.  Remaining 
  39. lines indicate first the variable name, then line numbers where 
  40. that variable appears, grouped by source file name.  Sample 
  41. output follows:
  42.  
  43.  
  44.  
  45.     MODEM.C     43     46
  46.  
  47.     MODEMF1.C     31     33
  48.  
  49.     MODEMF2.C     37     39
  50.  
  51. abort
  52.  
  53.  
  54.     MODEM.C     62     72
  55.  
  56.     MODEMF1.C    394
  57.  
  58. ACK
  59.  
  60.  
  61.     MODEMF1.C     53
  62.  
  63.     MODEMF2.C    530    533    675    711
  64.  
  65. allrights
  66.  
  67.  
  68.     MODEM.C     39
  69.  
  70.  
  71. This is the end of CCREF.DOC.
  72.