chiark - git - mdw - ssr/blob - StraySrc/BuildTools

   1 Build tools
   2 ~~~~~~~~~~~
   3
   4 Apart from the tools provided, you'll need the following programs to
   5 build the Straylight Source Release:
   6
   7 cc              Acorn's C compiler
   8 objasm          Acorn's ARM assembler
   9 link            Acorn's linker
  10 libfile         Acorn's archiver
  11 squeeze         Acorn's executable compresser
  12 amu             Acorn's rather nasty make utility
  13 ccrunch         A BASIC cruncher
  14 sed             GNU's stream editor
  15
  16 I recommend using the C5 versions of these tools; some of the source
  17 files may require C5 versions, but I'm not sure.
  18
  19 A few pieces of code were deliberately built using the C4 versions of
  20 various tools, to ensure compatibility with people developing for RISC
  21 OS 2.  For this reason, some of the Makefiles assume the presence of
  22 programs `o-cc', `o-objasm', `o-link' and `o-libfile'; these are assumed
  23 to be the earlier versions.  If you only have one version of the
  24 compiler, assembler and tools, you can set aliases to make the
  25 `o-'-prefixed versions run the non-prefixed ones.
  26
  27 The STEEL library may require bits of RISC_OSLib.  You won't be able to
  28 build STEEL or the programs which use it without RISC_OSLib.
  29
  30 Everything else ought to be provided in the package.  There are a
  31 collection of strange tools we've created to help build our programs,
  32 and a few more written specially for this source release:
  33
  34 buildstub       Builds Sapphire extension stubs
  35 enumerate       Run a *command for each file in a directory
  36 fixlink         Patches partially linked AOF files because link 4.00 is
  37                         buggy
  38 hour            Hourglass control from Obey files
  39 inst            Install programs once they've been built
  40 msgaof          Compile a message file to linkable AOF
  41 pathutil        Manipulate path variables properly
  42 resgen          Tool for building DLLs containing shared resources
  43 setdate         Stamp the current date into an AOF file
  44 setslot         A replacement for *WimpSlot which understands flex
  45 ssrclean        Delete a lot of files at once
  46 submake         Tool for making recursive makes work
  47 templaof        Convert a template file into an embedded templates
  48 test            Test conditions in Obey files
  49