home *** CD-ROM | disk | FTP | other *** search
/ The C Users' Group Library 1994 August / wc-cdrom-cusersgrouplibrary-1994-08.iso / vol_300 / 345_01 / tlphelp.doc < prev    next >
Text File  |  1989-07-10  |  6KB  |  121 lines
  1. /* -- remove this header before using file! --
  2. HEADER:        The Last Cross-Referencer;
  3. TITLE:        TLC/TLP - The Last Cross-Referencer;
  4. VERSION:    1.01;
  5.  
  6. DESCRIPTION: "TLC/TLP.
  7.             TLP Help documentation (put into shell's help file(s))";
  8.  
  9. KEYWORDS:    Utility, Cross-reference, C, Pascal, Apple, Macintosh, APW, Aztec;
  10. SYSTEM:        Macintosh MPW, v3.0;
  11. FILENAME:    TLPHELP.DOC;
  12. WARNINGS:    "Has not yet been ported to MS-DOS.
  13.             Shareware, $20 Check/Money Order suggested.";
  14.  
  15. SEE-ALSO:    README.TLC,TLCHELP.DOC;
  16. AUTHORS:    Eduard Schwan;
  17. COMPILERS:    AZTEC C65 v3.2b, APPLEIIGS APW C v1.0, APPLE MACINTOSH MPW C v3.0;
  18. */
  19.  
  20. TLP v1.01 Release    * HELP *    Eduard Schwan Programs [ESP]
  21.  
  22. The Last Pascal Cross-referencer (TLP) is a Pascal language cross-referencer
  23. that reads one or more source files, and generates a source file listing (with
  24. line numbers) and a cross-reference list for the non-reserved symbols in
  25. the file(s).
  26. ------------------------------------------------------------------------------
  27. The reserved symbols are read from a text file (TLPresw.dat) during
  28. TLP initialization.  This file should contain only identifiers separated
  29. by spaces or newlines.    Pascal-style comments are also allowed.  Any symbols
  30. put in this file will be treated as reserved words, and will not be cross-
  31. referenced;  And, if any symbols are removed (or commented out) from this
  32. file, they will be cross-referenced.  This allows tracking down the usage
  33. of certain reserved words (like longint or fillchar, etc.)
  34. ------------------------------------------------------------------------------
  35. TLP usually gets the list of source files from the command line.  Sometimes,
  36. however, the list is quite long.  So TLP may be instructed to read a text
  37. file containing filenames (using the "-f filename" option).  This file must
  38. have one filename per line, with no leading or trailing blanks.  Blank lines
  39. and lines that begin with an asterisk ('*') in column 1 are ignored.
  40. ------------------------------------------------------------------------------
  41. TLP can be given additional instructions to tailor its operation and output
  42. by putting instructions into a 'parameter file'.  This is a text file, with
  43. parameter assignment statements in it.    The format is:
  44.     PARMNAME = numeric_value
  45.         or
  46.     PARMNAME = "String_Value"
  47. There may be multiple statements per line, but any statement must be fully
  48. contained on one line.    String values may have C-style embedded escape
  49. sequences in them.    An example of a valid string follows:
  50.     Printer_init = "\033N\x1b?" /* "<ESC>N<ESC>?" */
  51. Parameter names are case-insensitive, and any underscores may be omitted
  52. (e.g. "PRINTER_INIT" and "PrinterInit" are treated as the same.)
  53. The list of parameter names and their range of values is:
  54.  
  55. Parameter Name        Valid Range        Description
  56. --------------        ------------    ---------------------------------------
  57. DO_INCLUDES         0..1 num        1=Read includes in-line, 1=ignore includes
  58. DO_LISTING            0..1 num        1=Output the source listing, 0=Don't
  59. DO_XREF             0..1 num        1=Output the crossref listing, 0=Don't
  60. DO_STATS            0..1 num        1=Output the statistics listing, 0=Don't
  61. OUT_FNAME            1..40 string    Send output to this filename (default:TLP.out)
  62.  
  63. PAGE_LINES            10..255 num        total # of lines per page
  64. PAGE_COLUMNS        10..255 num        # of characters per line between <CR>s
  65. TOP_LINE            1..10 num        first line # of page to begin printing on
  66. BOT_LINE            10..255 num        last valid line # of page to print on
  67. LEFT_COLUMN         1..40 num        leftmost column to begin printing in (indent)
  68. RIGHT_COLUMN        10..255 num        rightmost valid column to print in
  69. USER_HEADING        1..80 string    user-defined heading used as 2nd heading line
  70. DO_SINGLE_SHTS*        0..1 num        1=Pause between pages, 0=continuous paper
  71. PRINTER_INIT        1..80 string    string to send to printer once to init. it
  72. HAS_FORM_FEED        0..1 num        1=send <FF> at end of page, 0=send n <CR><LF>s
  73. FIRST_PAGE            1..9999 num        1st page of listing/xref (starting page #)
  74. LAST_PAGE            1..9999 num        last page of listing/xref (ending page #)
  75.  
  76. EMPH1_LEADIN        1..9 string        string to send printer to start emph1
  77. EMPH2_LEADIN        1..9 string        string to send printer to start emph2
  78. EMPH3_LEADIN        1..9 string        string to send printer to start emph3
  79. EMPH1_LEADOUT        1..9 string        string to send printer to stop emph1
  80. EMPH2_LEADOUT        1..9 string        string to send printer to stop emph2
  81. EMPH3_LEADOUT        1..9 string        string to send printer to stop emph3
  82.  
  83. TAB_WIDTH            0..16 num        width of tabstops
  84. EMPH_COMMENTS*        0..3 num        Emphasize comments in source listing
  85. EMPH_HEADING*        0..3 num        Emphasize the page headings
  86. EMPH_RESERVED*        0..3 num        Emphasize reserved words in source listing
  87. EMPH_FUNCHEADS*        0..3 num        Emphasize func. headings in source listing
  88. PAGING_STRING        1..15 string    do new list page when this string encountered
  89.  
  90. SYMBOL_SIZE         1..32 num        # of significant characters in identifiers
  91. XREF_NUMS            0..1 num        Cross-reference and list all numbers
  92. XREF_STRINGS        0..1 num        Cross-reference and list all strings/chars
  93. DO_CONDITIONALS*     0..1 num        1=Evaluate & skip cond. code (#ifdef), 0=All
  94. DO_CASE_SENS        0..1 num        1=Make symbols case significant, 0=unsig.
  95. DO_XCASE_SENS*        0..1 num        1=Sort xref list case significant, 0=unsig.
  96. DO_UNDERSCORES        0..1 num        1=Make underscores significant, 0=Delete
  97. EMPH_SYMBOLS        0..3 num        Emphasize symbols in cross-reference list
  98.  
  99.     * = Not Implemented Yet
  100. ------------------------------------------------------------------------------
  101. To run The Last Cross-referencer, use the following command (parameters in
  102. square brackets [] are optional:
  103.  
  104. TLP [-f FnameListFile] [-p ParmFile] [-r ResWordFile] [-v] [-d] FileNames..
  105.  
  106. Where:
  107.     -d                    ........Turns on debug messages sent to stderr.
  108.     -f FnameListFile    ........Optional file containing list of source
  109.                                 file names to cross-reference.
  110.     -p ParmFile            ........Optional file containing parameters for
  111.                                 tailoring TLP output.
  112.     -r ResWordFile        ........Optional file containing reserved words
  113.                                 not to be cross-referenced.
  114.     -v                    ........Turns on progress messages sent to stderr.
  115.                                 Repeating this option (-v -v) gives even
  116.                                 more info.
  117.     FileName(s)            ........Source files to be cross-referenced.
  118.  
  119. Example:
  120.     TLP  -v  -r  myresw.dat  file1.inc  file2.inc  file1.pas  file2.pas
  121.