home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / c1 / clib / !clib / !Help < prev    next >
Encoding:
Text File  |  1997-06-21  |  2.0 KB  |  76 lines
  1. The Shared C Library
  2. ====================
  3.  
  4. This is release 1.01.
  5.  
  6. Introduction
  7. ------------
  8.  
  9. This directory contains the necessary header files and object file to enable
  10. programs to use the SharedCLibrary module.
  11.  
  12. This library is © 1997 Nick Burrett
  13.  
  14. You are free to use this library but THERE IS NO WARRANTY OF ANY SORT
  15.  
  16.  
  17. Files
  18. -----
  19.  
  20. All header files are accessible through the path C: or Clib:
  21.  
  22. All programs must additionally link with the Acorn Object Format (AOF)
  23. file C:o.stubs (or clib:o.stubs).
  24.  
  25.  
  26. Installation
  27. ------------
  28.  
  29. Copy the directory !clib somewhere on your hard disc. Double-clicking on it
  30. will setup the necessary paths, ready for use.
  31.  
  32. With a slight modification, this library can be used with Easy C and Acorn C.
  33. To do this, you need to obtain the stdarg.h and varargs.h header files
  34. appropriate to your compiler and copy them into !clib.h.stdarg and
  35. !clib.h.varargs. You must also copy the definition of va_list and put it
  36. towards the start of !clib.h.stdio, renaming va_list to __va_list.
  37.  
  38. Using the SharedCLibrary library
  39. --------------------------------
  40.  
  41. For general use, all that is needed is an extra command line option to GCC:
  42.   -mstubs
  43. This will force GCC to search the GCC: and C: paths instead of the usual
  44. GCC: and Unix: paths.
  45.  
  46. The library to link against is c:o.stubs
  47.  
  48. The following commands will compile the file c.hellow:
  49.   *gcc -c c.hellow -O2 -mstubs
  50.   *drlink -o hellow o.hellow gcc:o.libgcc c:o.stubs
  51.  
  52. If you use LD, then add '-Lc: -lstubs' to the command line.
  53.  
  54.  
  55. SharedCLibrary and the CallASWI module
  56. --------------------------------------
  57.  
  58. Code linked for execution with the SharedCLibrary will not need to have the
  59. CallASWI module distributed with it.
  60.  
  61.  
  62. History
  63. -------
  64.  
  65. Release 1.00 [1 June 1997]
  66.   * The first release
  67.  
  68. Release 1.01 [21 June 1997]:
  69.   * A patch applied to <stdio.h> and o.stubs to allow GCC to pass
  70.     variadic arguments to vprintf(), vfprintf() and vsprintf() properly.
  71.  
  72. Contacting me
  73. -------------
  74.  
  75. I can be contacted by e-mail at: nick.burrett@btinternet.com
  76.