home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.tar / ftp.whtech.com / Geneve / mdos / mdos600.src / how_to_compile_mdos.txt < prev    next >
Internet Message Format  |  2006-10-19  |  4KB
  1. Date: Wed, 28 Mar 2001 23:14:53 -0600
  2. From: "Tim Tesch" <insane_m@hotmail.com>
  3. Subject: MDOS Compilation Instructions :)
  4.  
  5. GENEVE MDOS COMPILATION NOTES
  6. March 28,2001 - Tesch
  7. (I'm at work - so this is from memory.  Dano, correct me if I'm wrong)  :)
  8.  
  9. DESCRIPTION:
  10. MDOS must be compiled with GenASM, GenLINK, GenMAKE which are all part of
  11. Paul Charleton's GenProg package.   These programs are native MDOS programs;
  12. therefore, MDOS must be compiled on a Geneve using a previously compiled
  13. version of MDOS.
  14.  
  15. PROCEDURE:
  16. To compile MDOS, you must have all of the source files in the proper
  17. directory structure starting at the ROOT of the hard drive. The
  18. subdirectories correspond to the MDOS archive filenames.  Files that belong
  19. at the root (MDOS) level are in the ROOT archive.  You must also have the
  20. GenProg utility, which may have been included (though I should not have done
  21. so).
  22. ----------
  23. MDOS\
  24. MDOS\L6
  25. MDOS\L7
  26. ..
  27. ..
  28. MDOS\SCSI
  29. ------------
  30.  
  31. Since the MAKE program is flawed and uses a two-digit year, it becomes more
  32. difficult to track changes and assemble the code.  I disassembled the code
  33. before the last Chicago Faire and was close to fixing it, but there seemed
  34. to be some encryption used within the program.  (Note: perhaps Jim Uzzell
  35. will read this and have an idea of how to crack it? Jim?)  Use the following
  36. command at the MDOS (ROOT) level  to begin a FULL compilation:
  37.     MAKE  HDOS,F
  38.  
  39. This tells MAKE to use the !MAKEFILE dependency file to generate object
  40. code.  The ",F" flag tells MAKE to FORCE a full compilation, meaning every
  41. source file will be assembled and the appropriate object files created in
  42. their respective directories.  HDOS is the "rule" by which MAKE does its
  43. work.  See "!MAKEFILE" for some details.
  44.  
  45. Finally, after the object code is generated, MAKE will launch LINK.  LINK
  46. takes all of the object code, places it into the correct banks of memroy,
  47. links/resolves the labels/addresses, and creates the final product:  HDOS.
  48.  
  49. The TESTH executable can be used to test mdos from the MDOS folder as
  50. follows:
  51.     TESTH  HDOS\HDOS
  52.  
  53. If all goes well, your new MDOS will load and run.
  54. -------
  55. DISTRIBUTION NOTES:
  56. Once the new MDOS is tested, the final step is to imbed the CRC values. The
  57. program in question loads MDOS, calculates CRC values, does some additional
  58. "massaging", then imbeds the codes.   I have a copy of this program, as does
  59. one, perhaps two other people.  I have asked these people to not distribute
  60. the code or the program without consulting me first.
  61.  
  62. Tim
  63. -------
  64.  
  65. Notes From: "Tony Knerr" <knerr@erols.com> (He actually was able to compile)
  66.  
  67. - If you're using a Myarc memory expansion card, remove it. It probably
  68.   will cause a lockup part way through. I took out the Rave speech card,
  69.   too, just in case.
  70.  
  71. - If you have a SCSI card, use it rather than the HFDC. The HFDC gave me
  72.   'Control Character' errors and aborted.
  73.  
  74. - Boot from a virgin copy of MDOS, a modified version probably won't
  75.   work. (and I booted from Floppy, not Ramdisk or Hard Drive.)
  76.  
  77. - Don't run an AUTOEXEC file, that was one source of corruption for
  78.   me. MDOS compiled, but not correctly.
  79.  
  80. - Don't run any other utilities or programs before compiling. Do it
  81.   immediately after booting at the first prompt. You can change the
  82.   directory if need be, but don't do anything else. (running VID2
  83.   caused some trouble.)
  84.  
  85. - Create a directory called MDOS and put the root files there. The
  86.   directory archives (L6, L7, etc.) should be subdirectories of the
  87.   MDOS directory. The type 'CD MDOS' to put yourself in that directory.
  88.  
  89. - Type 'MAKE HDOS,F' exactly as shown - in capitals.
  90.