cemcom.1 3.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. .TH CEMCOM 1 local
  2. .SH NAME
  3. cemcom \- C to EM compiler
  4. .SH SYNOPSIS
  5. \fBcemcom\fP [\fIoptions\fP] \fIsource \fP[\fIdestination \fP[\fInamelist\fP]]
  6. .SH DESCRIPTION
  7. \fICemcom\fP is a compiler that translates C programs
  8. into EM compact code.
  9. The input is taken from \fIsource\fP, while the
  10. EM code is written on \fIdestination\fP.
  11. If either of these two names is "\fB-\fP", standard input or output respectively
  12. is taken.
  13. The file \fInamelist\fP, if supplied, will contain a list of the names
  14. of external, so-called \fBcommon\fP, variables.
  15. When the preprocessor is invoked to run stand-alone, \fIdestination\fP
  16. needs not be specified.
  17. .br
  18. \fIOptions\fP is a, possibly empty, sequence of the following combinations:
  19. .IP \fB\-C\fR
  20. list the sequence of input tokens while maintaining the comments.
  21. .IP \fB\-D\fIname\fR=\fItext\fR
  22. .br
  23. define \fIname\fR as a macro with \fItext\fR as its replacement text.
  24. .IP \fB\-D\fIname\fR
  25. .br
  26. the same as \fB\-D\fIname\fR=1.
  27. .IP \fB\-E\fR
  28. list the sequence of input tokens and delete any comments.
  29. Control lines of the form
  30. .RS
  31. .RS
  32. #\fBline\fR <\fIinteger\fR> "\fIfilename\fR"
  33. .RE
  34. are generated whenever needed.
  35. .RE
  36. .IP \fB\-I\fIdirname\fR
  37. .br
  38. insert \fIdirname\fR in the list of include directories.
  39. .IP \fB\-M\fP\fIn\fP
  40. set maximum identifier length to \fIn\fP.
  41. .IP \fB\-n\fR
  42. do not generate EM register messages.
  43. The user-declared variables are not stored into registers on the target
  44. machine.
  45. .IP \fB\-p\fR
  46. generate the EM \fBfil\fR and \fBlin\fR instructions in order to enable
  47. an interpreter to keep track of the current location in the source code.
  48. .IP \fB\-P\fR
  49. like \fB\-E\fR but without #\fBline\fR control lines.
  50. .IP \fB\-R\fR
  51. interpret the input as restricted C (according to the language as
  52. described in \fIThe C programming language\fR by Kernighan and Ritchie.)
  53. .IP \fB\-U\fIname\fR
  54. .br
  55. get rid of the compiler-predefined macro \fIname\fR.
  56. .IP \fB\-V\fIcm\fR.\fIn\fR,\ \fB\-V\fIcm\fR.\fIncm\fR.\fIn\fR\ ...
  57. .br
  58. set the size and alignment requirements.
  59. The letter \fIc\fR indicates the simple type, which is one of
  60. \fBs\fR(short), \fBi\fR(int), \fBl\fR(long), \fBf\fR(float), \fBd\fR(double) or
  61. \fBp\fR(pointer).
  62. The \fIm\fR parameter can be used to specify the length of the type (in bytes)
  63. and the \fIn\fR parameter for the alignment of that type.
  64. Absence of \fIm\fR or \fIn\fR causes the default value to be retained.
  65. To specify that the bitfields should be right adjusted instead of the
  66. default left adjustment, specify \fBr\fR as \fIc\fR parameter.
  67. .IP \fB\-w\fR
  68. suppress warning messages
  69. .IP \fB\-\-\fItext\fR
  70. .br
  71. where \fItext\fR can be either of the above or
  72. a debug flag of the compiler (which is not useful for the common user.)
  73. This feature can be used in various shell scripts and surrounding programs
  74. to force a certain option to be handed over to \fBcemcom\fR.
  75. .LP
  76. .SH FILES
  77. .IR /user1/cem/bin/cemcom :
  78. binary of the CEM compiler.
  79. .br
  80. .IR /user1/cem/bin/cem :
  81. a \fIcc\fP(1)-like driver for the VAX running 4.1BSD UNIX.
  82. .br
  83. .IR /user1/sjoerd/bin/CC :
  84. a \fIcc\fP(1)-like driver for the 68000 running Amoeba.
  85. .SH DIAGNOSTICS
  86. All warning and error messages are written on standard error output.
  87. .SH BUGS
  88. Debugging and profiling facilities may be present during the development
  89. of \fIcemcom\fP.
  90. .br
  91. Please report all bugs to ..tjalk!cem or ..tjalk!erikb
  92. .SH REFERENCE
  93. Baalbergen, E.H., D. Grune, M. Waage ;"\fIThe CEM compiler\fR",
  94. Informatica Manual IM-4