home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / program / a / c_compile / !C_Compile / !Help next >
Encoding:
Text File  |  1992-02-05  |  5.3 KB  |  150 lines
  1. !Help for !C_Compile version 2.00
  2.  
  3. Have you had problems running C off the desktop?
  4.  
  5. Are you sick and tired of typing in the options at
  6. every compilation ?
  7.  
  8. Well, you need !C_Compile...
  9.  
  10. What the program does :
  11. -----------------------
  12.  
  13. This is a short application that allows you to compile
  14. C programs by dragging the source file onto the icon.
  15.  
  16. It also allows options to be typed in, and stored for
  17. frequent use.
  18.  
  19. How to use the program :
  20. ------------------------
  21.  
  22. Load it in the usual way. An icon will appear on the
  23. bottom left hand side. Presing Menu will reveal the
  24. following options :
  25.  
  26. Info ->        The usual info
  27. Options ->     The options the program is currently
  28.                set up for
  29. Quit           Quit (funnily enough)
  30.  
  31. How to compile a C program :
  32. ----------------------------
  33.  
  34. Assume the options have been set up correctly. In order
  35. to compile a file, it must be in a c. directory. i.e. it
  36. must have the form :
  37.  
  38. adfs::SomeDrive.$.CFiles.User.C.ThisCProgm
  39.  
  40. This means that the file must be preceded by a '.C.' or a
  41. '.c.'. This is beacause you need somewhere to store the
  42. object and the other code. You also need (at the same level
  43. as the 'c') a directory called 'o' and some other ones if
  44. you wish to use some other features of the compiler (see the
  45. Acorn manual for more details).
  46. So, if you want to set up a directory for compiling C
  47. programs, you would have to have the directory structure :
  48.  
  49. $.<PATH_ELEMENTS>.C
  50. $.<PATH_ELEMENTS>.O
  51.  
  52. and the various other directories.
  53.  
  54. When you wish to compile the program, drag the text file onto
  55. the icon. If it is not in a 'C' directory, then it will
  56. complain.
  57. The computer will then start compiling the C code if all is well.
  58. Any errors will be reported in the command screen in the middle
  59. of the desktop.
  60. For more details of the C compilation, and the options available,
  61. consult the Acorn manual, or type *CC -help <return> at the
  62. command line. This will display all the options you can type in at
  63. the options window.
  64.  
  65. Options :
  66. ---------
  67.  
  68. If you don't want you CLib et al on your root (I certainly don't -
  69. it looks messy), then you need to set your library directories, in
  70. order for the C compiler (and the linker) to compile (and link)
  71. files. To do this, there are a couple of points you may need. In
  72. order to reduce the number of characters sent to the CLI handler,
  73. you can use the *SET command to set the CLib directory, and the
  74. Risc_OSLib directory. These are set in the !Run of !C_Compile,
  75. and you can change them for your own directory. I have set mine as
  76.  
  77. CLib       : scsi::Jitter.$.C.CLib
  78. Risc_OSLib : scsi::Jitter.$.C.Risc_OSLib
  79.  
  80. The default include directory needs to be changed to <Clib>, and
  81. the <Risc_OSLib> needs to be Included in the list.
  82.  
  83. The linker needs to be told where the Risc_OSLib and the CLib is.
  84. This is achieved in the Libraries section of the options window.
  85. The two libraries it needs are <Clib>.o.stubs, and
  86. <Risc_OSLib>.o.Risc_OSLib and if these are entered (separated by
  87. a comma), then everything (apart from the Dhrystone tests) will
  88. compile.
  89.  
  90. The various options at the top of the window control the compiler's
  91. flags directly. You set these to make them take effect. Another
  92. option is the change object file. If you are compiling the Desktop
  93. example programs provided in release 3, then they need to be
  94. compiled into !RunImage. If the option is off, then it will use the
  95. c.<file> name, otherwise it will use the name given. You don't need
  96. to give the pathname (unless you wish to compile it elsewhere),
  97. since the CSD is changed to <dir> of the <dir>.c.<file>.
  98.  
  99. Another option is the path of the C compiler itself. This must be
  100. set if you either havn't got it in a library, or you are using the
  101. compiler on a different filing system to the source. If, for example,
  102. the C compiler is in adfs::CDisc1.Compiler, and it's called CC, then
  103. you enter adfs::CDisc1.Compiler.CC as the pathname.
  104.  
  105. Versions this program will work on :
  106. ------------------------------------
  107.  
  108. This is originally based to work on the C release 1. It was re-
  109. written when I worked out how to do module tasked properly, but
  110. I don't see any reason why it shouldn't work on any version of C.
  111. (It works fine on Release 3).
  112.  
  113. Updates since pre 1.00 :
  114. ------------------------
  115.  
  116. 1.00       - Load and save ability put in. Re-written so it
  117.              didn't cause an error on quitting. Called !C.
  118. 1.01       - Improved saving ability.
  119. 1.02       - Didn't crash as much.
  120. 1.02b      - New sprite.
  121. 1.03       - Stopped working (bad code - couldn't work out why
  122.              it stopped :-( ).
  123. 2.00       - Totally re-written as an application (rather than
  124.              a module. Neater arrangement of windows - used
  125.              template files, and each option can be specified
  126.              directly, rather than having to remember each of
  127.              the options. Icon moved to the left. Also renamed
  128.              to !C_Compile.
  129.  
  130. And Finally :
  131. -------------
  132.  
  133. If you would like a FREE update (assuming one available), send
  134. me a disc, AND return postage, and I'll be glad to send you one
  135. along.
  136.  
  137. Also if you have any comments about this program, or any others
  138. I have written, please contact me :
  139.  
  140. The World Of Cryton : Jason "P" Tribbeck   (#140)
  141. Arcade              : Jason "p" Tribbeck   (#836)
  142. Equinox             : Jason Tribbeck
  143.  
  144. Jason Tribbeck
  145. 36 Nettlecombe Ave.,
  146. Southsea,
  147. Hants.
  148. PO4 OQW.
  149.  
  150. Tel : (0705) 755210 (if I'm in)