home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / util / mg-3b.lha / mg-3b / src.LZH / amiga / README.MANX < prev    next >
Encoding:
Text File  |  1990-05-23  |  3.7 KB  |  92 lines
  1.  
  2. Here are some notes on building MG3 with the MANX compilers.
  3.  
  4. MANX 5.0:
  5.  
  6.   The code should build fairly easily with MANX 5.0.  The important
  7.   things to remember are:
  8.  
  9.     1. Change the variable LIBOBJ in amiga/Makefile.AZTEC to
  10.        point to the location of rexxvars.o and rexxglue.o on
  11.        your system.  If you are not building a version with 
  12.        REXX support, this variable should be NULL.
  13.     
  14.     2. You must have the command makemake installed somewhere
  15.        in your path.
  16.     
  17.     3. You must not put the line 'option use_arp' in your 
  18.        config file.
  19.  
  20.   The current code will not support ARP mainly because I didn't have
  21.   the ARP1.3 bindings for MANX 5.0, but may in the future.  There are
  22.   only 3 functions used in the ARP library anyway and they are pretty
  23.   small.  Maybe the next release of the code will allow the use of
  24.   ARP with MANX5.0.
  25.  
  26.   Due to the way MANX chose to define DOS functions in functions.h we
  27.   have to live with several warnings when building the code.  The code
  28.   is written for LATTICE, and to be honest, their prototypes for the
  29.   DOS functions make more sense.
  30.  
  31.   Warnings will occur in the following modules:
  32.  
  33.       ttymenu.c(2), spawn.c(2), ttyio.c(2), fileio.c(4), dirio.c(2)
  34.  
  35.   for a grand total of 12.  These are all ptr/int conversion warnings
  36.   and are harmless.  If you absolutely cannot stand them, you can replace
  37.   the appropriate definitions in functions.h with the following:
  38.  
  39.     BPTR CurrentDir(BPTR lock);
  40.     long Examine(BPTR lock, struct FileInfoBlock *fileInfoBlock);
  41.     long ExNext(BPTR lock, struct FileInfoBlock *fileInfoBlock);
  42.     long Execute(const char *string, BPTR input, BPTR output);
  43.     BPTR ParentDir(BPTR lock);
  44.  
  45.   It is entirely up to you, the warnings do not affect the generated
  46.   code.  I take no responsibility for any damage or confusion the
  47.   change to functions.h may cause.
  48.  
  49.   After getting through all the config stuff, just type 'make xmg' and
  50.   be prepared to wait a while.  The current makefile doesn't use
  51.   pre-compiled includes, though it probably could without too much
  52.   trouble.  It takes me about 10 minutes to build from scratch in VD0:
  53.   with the compiler, linker, and assembler resident (I have a 5Meg
  54.   2000 with a 2620 board, so your mileage will probably vary).
  55.  
  56.  
  57. MANX 3.6:
  58.  
  59.   Support for this compiler in the code is probably going to go away
  60.   after MANX 5.0 stabilizes, but the current code will build with it.
  61.   Important things to remember are:
  62.   
  63.     1. Change the variable LIBOBJ in amiga/Makefile.MANX to
  64.        point to the location of rexxvars.o and rexxglue.o on
  65.        your system.  If you are not building a version with 
  66.        REXX support, this variable should be NULL.
  67.  
  68.     2. You must have the command makemake installed somewhere
  69.        in your path.
  70.  
  71.   The supplied makefile will cause the code to be built with 32 bit
  72.   ints.  Building with 16 bit ints was not tested and may not work.
  73.   You are on your own if you wish to build a version that uses 16 bit
  74.   ints.
  75.  
  76.   There will be several warnings generated during the make, all of
  77.   which should be ok.  I have run the version of the editor that was
  78.   built with 3.6, but it was not extensively tested.  Here is the
  79.   warning count from the 3.6 BURRITO build (without ARP):
  80.  
  81.       ttymenu.c(1), spawn.c(1), ttyio.c(5), fileio.c(11), dirio.c(2)
  82.  
  83.   There were a few more in dirio.c when ARP support was selected.
  84.   Most of these could be cleaned up with a little effort, but I wasn't
  85.   too interested in 3.6 support.
  86.  
  87.   There are two targets in the makefile, xmg which is the editor
  88.   without ARP, and xmga which adds the ARP link libraries to the link.
  89.   If you place 'option use_arp' in your config file, then you will
  90.   want to build with 'make xmga', otherwise build with 'make xmg'.
  91.  
  92.