How to install SRC Modula-3

Once you have ftp'ed the archives, you need to do the following from the top-level directory to build and install the system:

  1. Unpack the boot-architecture archive and change to its directory:
        $ gunzip < boot-architecture.tar.gz | tar xpof -
        $ rm boot-architecture.tar.gz
        $ cd boot-architecture
    
  2. On Unix platforms, unpack the m3cc archive inside the bootstrap:
        $ gunzip < ../m3cc.tar.gz | tar xpof -
        $ rm  ../m3cc.tar.gz
    
    (Note: if you are going to be doing a port or installing the system for several platforms, save m3cc.tar.gz!)

    The m3cc archive is not needed on Windows/NT or Windows 95. See these extra notes for installing SRC Modula-3 on either of these platforms.

  3. Edit m3build/templates/architecture to reflect your site-specific configuration. It would be wise to make a backup copy of m3build/templates/architecture before you edit it --- just in case.

    If your make does not support the VPATH feature, ensure that GNU_MAKE in your configuration template is set up to use GNU make. According to the GNU documentation, most BSD-based makes do support VPATH. If you're optimistic, skip this step and return here if the you have problems building m3cc. See m3cc/gcc/INSTALL for the gory details about VPATH.

  4. Build and install the system and return to the top-level directory:
        $ m3boot
        $ m3ship
        $ cd ..
    

    The m3ship step will copy the essential pieces of the bootstrap system to the directories (BIN_INSTALL, LIB_INSTALL, ...) specified in m3build/templates/architecture.

    At this point, you may need to tell your shell that new executables (e.g. m3build and m3ship) are present, by resetting your PATH environment variable to include BIN_INSTALL and running rehash, for example.

  5. Now, you should have successfully installed the Modula-3 compiler and driver.

  6. You can now delete the bootstrap directories to conserve space:
        $ rm -rf boot-architecture
    

  7. Build and install the other Modula-3 libraries and tools using the version of m3build installed above.

        $ gunzip < m3.tar.gz | tar xpof -
        $ rm m3.tar.gz
        $ cd m3
    
    Read the README and follow any special instructions. In particular, edit src/m3makefile to select the components you want to build.
        $ m3build
        $ cd ..
        $ rm -rf m3
    

    The top-level m3makefile m3/src/m3makefile takes care of building each Modula-3 source package and shipping it. For your own packages you must run m3build and then explicitly run m3ship.

    Note that the two deletion steps are optional, but do save space. Once the m3build step has completed, nothing in the xyz directory is needed.


[Modula-3 home page]

m3-request@src.dec.com
Last modified on Mon Sep 25 18:17:04 PDT 1995 by heydon                    .
     modified on Fri Jan 20 10:50:45 PST 1995 by kalsow                    .
     modified on Thu Jan  7 18:40:11 PST 1993 by muller                    .