Changes between Version 4 and Version 5 of Building eFTE2 by Alfredo Fernández Díaz

Timestamp:

Dec 13, 2017, 12:39:06 AM (7 years ago)

Author:

Alfredo Fernández Díaz

Comment:

--

Building eFTE2 by Alfredo Fernández Díaz

@@ +1 @@
+An encouraging note beforehand: this is not difficult AT ALL -- "other stuff" (e.g. to learn what I needed) took me WAY longer than getting everything up and running.
+
+Thus, it is all summarized here for your convenience, in case you don't have a dependable connection or the time to keep jumping from site to site to gather every necessary bit of information and try out every release or beta of every tool out there. If you stick to the stuff I link, you should have no problems.
+
 == Building on OS/2-based platforms ==
-(Without modifying a thing in the sources as of 2017-12)
+(Without modifying a thing in the sources as they are in December 2017)
 
 === Ingredients ===
 To build eFTE2 on ArcaOS, OS/2, or eCS you will need:
 
-* A subversion client. [http://os2ports.smedley.id.au/index.php?page=subversion Paul Smedley's SVN port], still at version 1.7.21 as of December 2017, works for me.
+* A Subversion client. [http://os2ports.smedley.id.au/index.php?page=subversion Paul Smedley's SVN port], still at version 1.7.21 as of December 2017, works for me.
 * The source code for eFTE2. It is available [http://svn.netlabs.org/repos/efte/ here at Netlabs]
 * Some text editor. I use eFTE2 itself.
-* Open Watcom 1.9 or newer. Check http://www.openwatcom.org/. We have a newer beta [ftp://ftp.netlabs.org/incoming/ here at Netlabs]. This builds the EXE files.
+* Open Watcom 1.9 or newer. Check http://www.openwatcom.org/. You can find a newer v2.0 beta 1 [ftp://ftp.netlabs.org/incoming/ here at Netlabs]. Both worked for me. This builds the EXE files.
 * [http://hobbes.nmsu.edu/h-search.php?sh=1&button=Search&key=PMPrintF PMPrintF] at %PMPRINTFDIR% or the default U:\PMPrintF. This adds some debugging stuff to the EXEs.
-* A working Perl environment. I installed mine, a RPM packaged version, with [https://www.arcanoae.com/resources/downloadables/arca-noae-package-manager/ ANPM]. This will create .map files for the EXEs.
-* MapXQS from [http://home.earthlink.net/~steve53/betas/ ExceptQ 7.1 by Steven H. Levine]. This will create .XQS files from the .map ones to further help debugging.
-* !LxLite from the same place, or Hobbes (but I use Steve's one for this project). This will cute the size of linear OS/2 EXE (LX) files roughly in half.
+* A working Perl environment. I installed mine, a RPM packaged version, with [https://www.arcanoae.com/resources/downloadables/arca-noae-package-manager/ ANPM]. This will create .map files for the EXEs for debugging.
+* IBM !MapSym Version 4 (Symbol File Generator, 2001) from some OS/2 Toolkit (e.g. in eCS CD2). Will create .sym files for kernel debugging.
+* MapXQS from [http://home.earthlink.net/~steve53/betas/ ExceptQ 7.1+ by Steven H. Levine]. This will create .XQS files from the .map ones to further help debugging.
+* Steve's !LxLite 1.35 from the same place. This will cute the size of linear OS/2 EXE (LX) files roughly in half.
 
-It might be possible to build eFTE2 with other tools, but I'd rather devote time to Get Shit Done™. The Perl requirement almost drove me off, for reasons unrelated to this project. Contact me through the mailing list and we can find out together.
+It might be possible to build eFTE2 with other or newer tools, but I'd rather devote time to Get Shit Done™ first. The Perl requirement almost drove me off, for reasons unrelated to this project. Contact me through the mailing list and we can find out together.
 
 === What to do ===
-Once you have all of the above up and running, the process is as simple as !ChDiring to trunk/src in your local copy of the SVN source, and issuing the command "wmake". This defaults to the first target in the makefile, which will generate efte.exe, and eftepm.exe, along with their .map and .xqs symbol files.
+Once you have all of the above, the process is as simple as !ChDiring to trunk/src in your local copy of the SVN source, and issuing the Open Watcomm command "wmake". This defaults to the first target in the makefile, which will generate efte.exe (the VIO executable), and eftepm.exe (the PM version), along with their .sym, .map, and .xqs symbol files.
 
-Or you can start fiddling with your makefile, other targets, etc.
+You can build either of them individually with "wmake efte.exe" or "eftepm.exe".
+
+Or, you can start fiddling with your makefile, other targets, etc.
 
 == Building on other platforms (Win32) ==