home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / i / icon / !Help < prev    next >
Encoding:
Text File  |  1991-05-01  |  5.0 KB  |  133 lines
  1. CCompile: Acorn ANSI C Compiler Desktop Front-End
  2. =================================================
  3.  
  4. This application is a desktop front-end for Acorn's ANSI C
  5. compiler.
  6.  
  7. Usage
  8. -----
  9.  
  10. Drag a source from a directory 'c' to the icon bar icon of
  11. !CCompile. The application calls the C compiler and optionally
  12. also the linker.
  13. Important: the system variable CC$Dir is used to locate the
  14. C compiler directories Library (with the compiler and linker),
  15. RISC_OSLib (with the RISC OS library headers and code) and
  16. CLib (with the C library headers and code). Default this is
  17. the application directory of !CCompile. This means you must
  18. place the C compiler directories into the !CCompile directory.
  19. If you do not want this, you must change the !Run obey file
  20. of !CCompile. As an alternative you can use explicit directory
  21. paths in the Options dialogue window of !CCompile.
  22.  
  23. If you drag a C source file to the icon bar icon the
  24. application performs the following list of actions and
  25. commands:
  26. - Check if the file is a text file in a directory 'c'.
  27. - If a directory 'o' does not exist at the same level as 'c'
  28.   then it is created.
  29. - If the List file icon of the Options window is selected a
  30.   directory 'l' is created at the same level as 'c' and 'o'
  31.   directories if it does not exist.
  32. - The current directory is set to the parent directory of
  33.   these directories 'c' and 'o'.
  34. - Set C$LibRoot to the contents of the Options window
  35.   C$LibRoot icon, only if something is specified in this icon.
  36. - Call the C compiler with the following command:
  37.   [<ccdir>.]CC <prefix>.c.<file> -c [-i <include>] [-list]
  38.   where: ccdir:   the contents of the Compiler icon of the
  39.                   Options window (if empty not included),
  40.          file:    the name of the dragged file,
  41.          prefix:  the parent directory of the 'c' directory
  42.                   from which 'file' is dragged,
  43.          include: the contents of the Include icon of the
  44.                   Options window (if empty not included),
  45.   while the '-list' part is only included when the List file
  46.   button of the Options window is selected.
  47. - Write the output of the compiler to a report file if the
  48.   Report on file button in the Options window is selected AND
  49.   a file name for this report file is entered in the Report
  50.   icon of this Options window (in all other cases a command
  51.   window is used), but only if errors are detected.
  52. - If the Link button of the Options window is selected AND
  53.   no errors are detected, call the linker with the following
  54.   command:
  55.   [<ccdir>.]LINK -o <image> <prefix>.o.<file> [<library>]
  56.   [-via <via>] [-verbose]
  57.   where: image:   the contents of the Image icon of the
  58.                   Options window,
  59.          library: the contents of the Library icon of the
  60.                   Options window
  61.          via:     the contents of the Via icon of the
  62.                   Options window (if empty not included).
  63.   while the '-verbose' part is only included when the Verbose
  64.   icon of the Options window is selected.
  65. - Remove the object file in the 'o' directory if the Remove
  66.   object button of the Options window is selected.
  67. - Call the squeezer if the Squeeze image icon of the Options
  68.   window is selected with the following command:
  69.   [<ccdir>.]SQUEEZE <image>
  70.  
  71. Please note that you can specify more than one include
  72. directory (in the Include icon) by using the , character, but
  73. you can specify more than one library file (in the Library
  74. icon) by using the space character! This is a peculiarity
  75. of the CC and LINK commands.
  76.  
  77. Note also that if you do not specify paths in the Image and
  78. Report icons the image and report files are written in the
  79. current directory, i.e. the parent directory of directory
  80. 'c' from which the source is dragged. Especially for the
  81. report file it is recommended to use a RAM disk, for
  82. instance: RAM:$.Bugs
  83.  
  84.  
  85. Versions
  86. --------
  87.  
  88. 1.20  -via option included
  89.       options window restructured
  90.  
  91. Conditions of Use
  92. -----------------
  93.  
  94.   This application is supplied free to everyone 'as is', I
  95. do not give any guarantee that it is free of bugs, or
  96. supply any warranty about it's suitabliliy for use. However
  97. if there are any problems with it and you notify me of them
  98. then I probably will do my best to recify them.
  99.  
  100.   You are may give this application to anyone, via any
  101. medium, so long as:
  102.  
  103.   1) It is delivered with ALL the supplied files and
  104.      unaltered
  105.   2) It is not supplied on a disc you are charging for.
  106.  
  107.   You have permission to use any part or the whole
  108. application in a project you intend to place in the public
  109. domain, as long as I am fully credited. If you wish to use
  110. these routines in a program that is for sale (for however
  111. much and for whatever reasons) or released as copyright
  112. material then my express permission in writing must be
  113. obtained. I maintain copyright on all the material
  114. supplied and reserve the right to amend these conditions in
  115. case where I deem misuse.
  116.  
  117. Contacts
  118. --------
  119.  
  120. My address:
  121.  
  122. Brouwersgracht 190 C
  123. 1013 HC Amsterdam
  124. The Netherlands
  125.  
  126. You can also contact me via:
  127.  
  128. Acorn BBS, Amsterdam   tel. (0)20-6631849
  129. Usenet/Eunet EMAIL     walther@econ.vu.nl
  130.  
  131.  
  132. Walther Schoonenberg
  133.