afcc.1 3.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157
  1. .TH AFCC 1
  2. .SH NAME
  3. afcc \- fast ACK compatible C compiler
  4. .SH SYNOPSIS
  5. .B afcc
  6. [
  7. .B \-c
  8. ]
  9. [
  10. .B \-O
  11. ]
  12. [
  13. .B \-v
  14. ]
  15. [
  16. .B \-vn
  17. ]
  18. [ \fB\-D\fIname\fR ]
  19. [ \fB\-D\fIname\fB=\fIdef\fR ]
  20. [
  21. .BI \-I pathname
  22. ]
  23. [
  24. .B \-w
  25. ]
  26. [
  27. .B \-o
  28. .I outfile
  29. ]
  30. [
  31. .B \-R
  32. ]
  33. [
  34. .BI \-U name
  35. ]
  36. [
  37. .BI -M compiler
  38. ]
  39. .I sourcefile ...
  40. .SH DESCRIPTION
  41. .LP
  42. .I Afcc
  43. is a fast
  44. .B C
  45. compiler. It translates
  46. .B C
  47. programs
  48. into ack(1ACK)-compatible relocatable object modules, and does so in one pass.
  49. Then, if the \fB\-c\fP flag is not given,
  50. .I afcc
  51. offers the object modules to a link-editor,
  52. to create an executable binary.
  53. .LP
  54. .I Afcc
  55. accepts several types of filename arguments. Files with
  56. names ending in
  57. .B .c
  58. are taken to be
  59. .B C
  60. source programs.
  61. They are compiled, and the resulting object module is placed in the current
  62. directory.
  63. The object module is named after its source file, the suffix
  64. .B .o
  65. replacing
  66. .BR .c
  67. in the name of the object.
  68. .LP
  69. Other arguments refer to loader options,
  70. object modules, or object libraries.
  71. Unless the
  72. .B \-c
  73. flag is given, these modules and libraries, together with the results of any
  74. specified compilations, are passed (in the order given) to the
  75. link-editor to produce
  76. an output file named
  77. .IR a.out .
  78. You can specify a name for the executable by using the
  79. .B \-o
  80. option.
  81. .SH OPTIONS
  82. .LP
  83. The \fB\-l\fIlib\fR, \fB\-d\fP, \fB\-n\fP, \fB\-N\fP,
  84. \fB\-r\fP, \fB\-s\fP, \fB\-S\fP, \fB\-i\fP, and \fB\-u\fP options are
  85. passed to the link-editor program.
  86. The \fB\-u\fP option takes an extra argument.
  87. .IP \fB\-c\fP
  88. .br
  89. Suppress the loading phase of the compilation, and force an object module to
  90. be produced, even if only one program is compiled.
  91. A single object module can be named explicitly using the
  92. .B \-o
  93. option.
  94. .IP \fB\-D\fIname\fR\fB=\fIdef\fR
  95. Define a symbol
  96. .I name
  97. to the
  98. preprocessor, as if by "#define".
  99. .IP \fB\-D\fIname\fR
  100. .br
  101. same as \fB\-D\fIname\fB=1\fR.
  102. .IP \fB\-I\fIpathname\fR
  103. .br
  104. Add
  105. .I pathname
  106. to the list of directories in which to search for
  107. .B #include
  108. files with filenames not beginning with slash.
  109. The compiler first searches for
  110. .B #include
  111. files in the directory containing
  112. .I sourcefile,
  113. then in directories in
  114. .B \-I
  115. options, then in the ACK include directory,
  116. and finally, in
  117. .I /usr/include.
  118. .IP "\fB\-o \fIoutput\fR"
  119. Name the final output file
  120. .I output.
  121. .IP \fB\-O\fP
  122. .br
  123. Use a version of the compiler that is just a bit slower, but produces
  124. better code.
  125. .IP \fB\-U\fIname\fR
  126. .br
  127. Remove any initial definition of
  128. .I name.
  129. .IP \fB\-v\fP
  130. .br
  131. Verbose. Print the commands as they are executed.
  132. .IP \fB\-vn\fP
  133. .br
  134. Verbose, no execute. Only print the commands, do not execute them.
  135. .IP \fB\-w\fP
  136. suppress warning messages.
  137. .IP \fB\-R\fP
  138. .br
  139. test for more compatibility with Kernighan & Ritchie C [1].
  140. .IP \fB\-M\fIcompiler\fR
  141. .br
  142. use \fIcompiler\fR as C-2 compiler instead of the default.
  143. .LP
  144. Object modules produced by ack(1ACK) and
  145. .I afcc
  146. can be freely mixed.
  147. .SH "SEE ALSO"
  148. .IP [1]
  149. B.W. Kernighan, D. Ritchie, "\fIThe C programming Language\fP", Prentice-Hall Inc., 1978
  150. .IP [2]
  151. E.H. Baalbergen, "\fIThe ACK CEM compiler\fP".
  152. .IP [3]
  153. ack(1ACK) manual page.
  154. .SH DIAGNOSTICS
  155. Diagnostics are intended to be self-explanatory.
  156. .SH REMARKS
  157. You need the 4th ACK distribution to be able to use this program.