cemcom.1 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104
  1. .TH EM_CEMCOM 6ACK
  2. .ad
  3. .SH NAME
  4. em_cemcom \- C to EM compiler
  5. .SH SYNOPSIS
  6. \fB~/em/lib/em_cemcom\fP [\fIoptions\fP] \fIsource \fP[\fIdestination \fP[\fInamelist\fP]]
  7. .SH DESCRIPTION
  8. \fICemcom\fP is a compiler that translates C programs
  9. into EM compact code.
  10. The input is taken from \fIsource\fP, while the
  11. EM code is written on \fIdestination\fP.
  12. If either of these two names is "\fB-\fP", standard input or output respectively
  13. is taken.
  14. The file \fInamelist\fP, if supplied, will contain a list of the names
  15. of external, so-called \fBcommon\fP, variables.
  16. When the preprocessor is invoked to run stand-alone, \fIdestination\fP
  17. needs not be specified.
  18. .br
  19. \fIOptions\fP is a, possibly empty, sequence of the following combinations:
  20. .IP \fB\-D\fIname\fR=\fItext\fR
  21. .br
  22. define \fIname\fR as a macro with \fItext\fR as its replacement text.
  23. .IP \fB\-D\fIname\fR
  24. .br
  25. the same as \fB\-D\fIname\fR=1.
  26. .IP \fB\-I\fIdirname\fR
  27. .br
  28. insert \fIdirname\fR in the list of include directories.
  29. .IP \fB\-M\fP\fIn\fP
  30. set maximum identifier length to \fIn\fP.
  31. .IP \fB\-g\fP
  32. produce a DBX-style symbol table.
  33. .IP \fB\-n\fR
  34. do not generate EM register messages.
  35. The user-declared variables are not stored into registers on the target
  36. machine.
  37. .IP \fB\-L\fR
  38. don't generate the EM \fBfil\fR and \fBlin\fR instructions
  39. that usually are generated to enable
  40. an interpreter to keep track of the current location in the source code.
  41. .IP \fB\-p\fR
  42. generate code at each procedure entry to call the routine
  43. .BR procentry ,
  44. and at each return to call the routine
  45. .BE procexit .
  46. These routines are supplied with one parameter, a pointer to a
  47. string containing the name of the procedure.
  48. .IP \fB\-A\fR[\fIfile\fR]
  49. .br
  50. if \fIfile\fR is not given, generate a list
  51. of makefile dependencies and write them to the standard output.
  52. If \fIfile\fP is given,
  53. generate the list of makefile dependencies on file \fIfile\fP.
  54. .IP \fB-i\fR
  55. when generating makefile dependencies, do not include files from
  56. /usr/include.
  57. .IP \fB-m\fR
  58. when generating makefile dependencies, generate them in the following format:
  59. .RS
  60. .IP "file.o: file1.h"
  61. .RE
  62. .IP ""
  63. where "file.o" is derived from the source file name. Normally, only a list
  64. of files included is generated.
  65. .IP \fB\-R\fR
  66. interpret the input as restricted C (according to the language as
  67. described in \fIThe C programming language\fR by Kernighan and Ritchie.)
  68. .IP \fB\-U\fIname\fR
  69. .br
  70. get rid of the compiler-predefined macro \fIname\fR.
  71. .IP \fB\-V\fIcm\fR.\fIn\fR,\ \fB\-V\fIcm\fR.\fIncm\fR.\fIn\fR\ ...
  72. .br
  73. set the size and alignment requirements.
  74. The letter \fIc\fR indicates the simple type, which is one of
  75. \fBs\fR(short), \fBi\fR(int), \fBl\fR(long), \fBf\fR(float), \fBd\fR(double) or
  76. \fBp\fR(pointer).
  77. The \fIm\fR parameter can be used to specify the length of the type (in bytes)
  78. and the \fIn\fR parameter for the alignment of that type.
  79. Absence of \fIm\fR or \fIn\fR causes the default value to be retained.
  80. To specify that the bitfields should be right adjusted instead of the
  81. default left adjustment, specify \fBr\fR as \fIc\fR parameter.
  82. .IP \fB\-w\fR
  83. suppress warning messages.
  84. .IP \fB\-s\fR
  85. suppress stricts.
  86. .IP \fB\-a\fR
  87. suppress warnings and stricts.
  88. .IP \fB\-o\fR
  89. suppress warnings and stricts about old-style.
  90. .IP \fB\-\-\fItext\fR
  91. .br
  92. where \fItext\fR can be either of the above or
  93. a debug flag of the compiler (which is not useful for the common user.)
  94. This feature can be used in various shell scripts and surrounding programs
  95. to force a certain option to be handed over to \fBcemcom\fR.
  96. .LP
  97. .SH FILES
  98. .IR ~em/lib/em_cemcom :
  99. the compiler
  100. .SH DIAGNOSTICS
  101. All warning and error messages are written on standard error output.
  102. .SH REFERENCE
  103. Baalbergen, E.H., D. Grune, M. Waage ;"\fIThe CEM compiler\fR",
  104. Informatica Manual IM-4