home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Trees / V6 / usr / man / man1 / cref.1 < prev    next >
Encoding:
Text File  |  1975-06-26  |  2.4 KB  |  143 lines
  1. .th CREF I 2/5/73
  2. .sh NAME
  3. cref  \*-  make cross reference listing
  4. .sh SYNOPSIS
  5. .bd cref
  6. [
  7. .bd \*-acilostux123
  8. ] name ...
  9. .sh DESCRIPTION
  10. .it Cref
  11. makes a cross reference listing
  12. of program files in assembler or C format. The files
  13. named as arguments in the command
  14. line are searched for symbols 
  15. in the appropriate syntax.
  16. .s3
  17. The output report is in four columns:
  18. .nf
  19. .s3
  20. (1)    (2)    (3)    (4)
  21. symbol    file    see    text as it appears in file
  22.         below
  23. .s3
  24. .fi
  25. .it Cref
  26. uses either an
  27. .it ignore
  28. file or an
  29. .it only
  30. file.
  31. If the
  32. .bd \*-i
  33. option is given, the next
  34. argument is taken to be an
  35. .it ignore
  36. file; if the
  37. .bd \*-o
  38. option is given, the next
  39. argument is taken to be
  40. an
  41. .it only
  42. file.
  43. .it Ignore
  44. and
  45. .it only
  46. files are lists of symbols separated by new lines.
  47. All symbols in an
  48. .it ignore
  49. file
  50. are ignored in columns (1) and (3) of the output.
  51. If an
  52. .it only
  53. file is given, only symbols in that
  54. file appear in column (1).
  55. At most one of
  56. .bd \*-i
  57. and
  58. .bd \*-o
  59. may be used.
  60. The default setting
  61. is
  62. .bd \*-i.
  63. Assembler predefined symbols or C keywords are ignored.
  64. .s3
  65. The
  66. .bd \*-s
  67. option causes current symbols to be
  68. put in column 3.
  69. In the assembler, the current symbol
  70. is the most recent name symbol;
  71. in C, the current function name.
  72. The
  73. .bd \*-l
  74. option causes the line number within the file
  75. to be put in column 3.
  76. .s3
  77. The
  78. .bd \*-t
  79. option causes the next available argument
  80. to be used as the name
  81. of the intermediate temporary
  82. file (instead of /tmp/crt??).
  83. The file is created and
  84. is not removed at the end of the process.
  85. .s3
  86. Options:
  87. .s3
  88. .lp +5 3
  89. \fBa\fR    assembler format (default)
  90. .lp +5 3
  91. \fBc\fR    C format input
  92. .lp +5 3
  93. \fBi\fR    use
  94. .it ignore
  95. file (see above)
  96. .lp +5 3
  97. \fBl\fR    put line number in col. 3 (instead of current symbol)
  98. .lp +5 3
  99. \fBo\fR    use
  100. .it only
  101. file (see above)
  102. .lp +5 3
  103. \fBs\fR    current symbol in col. 3 (default)
  104. .lp +5 3
  105. \fBt\fR    user supplied temporary file
  106. .lp +5 3
  107. \fBu\fR    print only symbols that occur exactly once
  108. .lp +5 3
  109. \fBx\fR    print only C external symbols
  110. .lp +5 3
  111. \fB1\fR    sort output on column 1 (default)
  112. .lp +5 3
  113. \fB2\fR    sort output on column 2
  114. .lp +5 3
  115. \fB3\fR    sort output on column 3
  116. .s3
  117. .i0
  118. .sh FILES
  119. .dt
  120. /tmp/crt??    temporaries
  121. .br
  122. /usr/lib/aign    default assembler 
  123. .it ignore
  124. file
  125. .br
  126. /usr/lib/cign    default C
  127. .it ignore
  128. file
  129. .br
  130. /usr/bin/crpost    post processor
  131. .br
  132. /usr/bin/upost    post processor for
  133. .bd \*-u
  134. option
  135. .br
  136. /bin/sort    used to sort temporaries
  137. .br
  138. .s3
  139. .fi
  140. .sh "SEE ALSO"
  141. as (I), cc (I)
  142. .sh BUGS
  143.