diff doc/Compiling @ 531:6917ea63bffa

doc/Compiling: Slackware, Wine and mokosrec2bin updates
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 26 Oct 2018 00:29:16 +0000
parents 9363ea39c74c
children f551ffdfe938
line wrap: on
line diff
--- a/doc/Compiling	Thu Oct 25 22:57:17 2018 +0000
+++ b/doc/Compiling	Fri Oct 26 00:29:16 2018 +0000
@@ -4,13 +4,19 @@
 In order to compile our FreeCalypso Magnetite firmware, you will need a
 Unix/Linux system.  Even though we are using a compiler which we got in the
 form of Windows .exe binaries and thus have to use Wine (see below), everything
-that we have built on top of it is Unix-based.  The Mother uses Slackware Linux
-version 13.37, 32-bit.
+that we have built on top of it is Unix-based.  The Mother currently uses
+Slackware Linux release 14.2 (32-bit) and previously used Slackware 13.37,
+also 32-bit.
 
-You will need to install the following four pieces of software on whatever
+You will need to install the following 3 pieces of software on whatever
 machine you will use to run the FC Magnetite build process:
 
-1. Wine: self-explanatory.
+1. Wine: self-explanatory.  The Mother uses the following Slackware package:
+
+   https://www.freecalypso.org/members/falcon/slackware/wine-1.5.23-i486-1sg.txz
+
+   I originally used it with Slackware 13.37 and I am still able to use it
+   with 14.2 without any issues.
 
 2. FreeCalypso Wine environment:
 
@@ -23,20 +29,23 @@
 
    ftp://ftp.freecalypso.org/pub/GSM/TI_src/wine/nowhine.c
 
-   Note that Wine may produce different whines on your system than it
-   does on mine, in which case if you wish to be relieved of those
-   whines, you'll need to edit my nowhine.c hack for your situation.
-   And if wine does not whine at all on your system, you can skip the
-   wrapper and create a nowhine symlink pointing directly to wine.
+   The purpose of this wrapper is to suppress the following obnoxious whine
+   which wine emits on my system:
+
+   preloader: Warning: failed to reserve range 00010000-00110000
+
+   Wine will also emits a bunch of other whines if you have to run it
+   in an environment without an X11 display (e.g., on a machine that you
+   ssh into), and our nowhine wrapper suppresses those as well.
 
-4. mokosrec2bin flash image file format conversion utility:
-
-   ftp://ftp.freecalypso.org/pub/GSM/GTA02/gsm-fw/mokosrec2bin.c
+   If wine does not emit those preloader whines on your system and you
+   never find yourself in a situation of having to run without an X11
+   display and thus you find our nowhine wrapper to be unnecessary,
+   you can skip the wrapper and create a nowhine symlink pointing directly
+   to wine.
 
-Note that the four host software pieces above are exactly the same as what has
-been needed to build our previous TCS211-based fw works such as leo2moko-debug
-and tcs211-c139 - thus if you have built those previously, you should already
-have all of the necessary host tools.
+The mokosrec2bin flash image file format conversion utility is now included
+locally and no longer needs to be provided externally.
 
 Compiling the local helper utilities
 ====================================