home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / libg_ / libio / !libio / docs / !Readme next >
Encoding:
Text File  |  1996-11-24  |  2.2 KB  |  75 lines
  1. The GNU C++ iostream library
  2. ============================
  3.  
  4. Introduction
  5. ------------
  6.  
  7. This is a port of the GNU C++ iostream library (version 2.7.2) for use with
  8. the C++ programming language to the Acorn range of ARM based machines,
  9. running under RISC OS. As such, this package is covered by the FSF General
  10. Public License (see the files docs.COPYING and docs.COPYINGLIB for details).
  11.  
  12. This port is © 1996 Nick Burrett
  13.  
  14. As with GNU programs, THERE IS NO WARRANTY OF ANY SORT
  15.  
  16.  
  17. Files
  18. -----
  19.  
  20. This distribution does not include any of the C++ source files. For these
  21. you must retrieve them from a suitable GNU archive site listed at the end
  22. of this document.
  23.  
  24. All header files are accessible through the path libio:
  25.  
  26.  
  27. Installation
  28. ------------
  29.  
  30. To install the GNU C++ iostream library, just copy the directory !libio onto
  31. your hard disc. Double clicking on !libio will then setup the relevant
  32. path variables to point to !libio.
  33.  
  34.  
  35. Before attempting to use the iostream library, it should be noted that
  36. you will need the GNU C++ compiler.  This library is not compatible with
  37. Acorn C.
  38.  
  39. If you do not have a copy of GNU C++, it can be retrieved from the files
  40.   ftp://micros.hensa.ac.uk/micros/arch/riscos/b/b013/gccmain.zip
  41.   ftp://micros.hensa.ac.uk/micros/arch/riscos/b/b013/cc1plus.zip
  42. and relevant mirrors.
  43.  
  44. The iostream library requires:
  45.  
  46.   a) The C runtime library, UnixLib 3.7b or later.
  47.     ftp://micros.hensa.ac.uk/micros/arch/riscos/a/a042/unixlib.arc
  48.     or http://www.callan.demon.co.uk/unixlib
  49.  
  50.  
  51. Using the GNU C++ iostream library
  52. ----------------------------------
  53.  
  54. In general usage, all that is needed is an extra command line option to G++:
  55.   -ILibio:
  56.  
  57. The library to link against is libio:o.libio
  58.  
  59. As an example in general use: to compile the example file cc.hellow
  60.   g++ -c cc.hellow -O2 -ILibio:
  61.   drlink -o hellow o.hellow libio:o.libiostrea gcc:o.libgcc unix:o.unixlib
  62.  
  63. should be sufficient. Although adding -rescan to the drlink command line
  64. might help resolve missing link references.
  65.  
  66.  
  67.  
  68. Contacting me
  69. -------------
  70.  
  71. I can be contacted by e-mail at: nickb@digibank.demon.co.uk
  72.  
  73. However, if there is no response from that address I can be contacted
  74. through Simon Callan: gcc@callan.demon.co.uk.
  75.