Changeset 2102 for trunk

Timestamp:

Jun 29, 2005, 12:54:21 AM (20 years ago)

Author:

bird

Message:

* empty log message *

File:

• trunk/HowToBuild.txt (modified) (1 diff, 1 prop)

trunk/HowToBuild.txt

@@ -1 @@
-You didn't get this from anywhere or you own all the necessary licenses.
 
-1. go to the tools/ directory and do: unzip packages/*.zip
-2. back to root.
+Tree Preparation
+-----------------
+
+1. Check out the tree / Unpack the source and tools zip into an empty tree
+   It is possible to use the netlabs CVS for src/emx.
+2. Prepare the tools:
+    a) From tools/ directory and do: 
+        unzip packages/*.zip
+    b) Copy / unzip the gcc installation to tools/x86.os2/gcc/.
+    c) Rename tools/x86.os2/gcc/usr to tools/x86.os2/gcc/staged.
+    d) Execute tools/x86.os2/gcc/staged/lib/MakeOmfLibs.cmd.
 3. Setup the environment: tools/env.cmd
-4. Do a 'make' to build everything - look in Makefile for 
-   subtargets (all-emx, all-gcc, all-binutils).
-5. The output goes into obj/OS2/DEBUG/[emx|gcc|binutils]. During the 
-   build the built stuff is installed into obj/OS2/DEBUG/builtunix/ and 
-   used since this is the head of all the search paths.
-6. The distributable stuff goes into bin/OS2/DEBUG/3.3.5-beta5/.
 
+
+
+Building 
+--------
+
+Make sure you have setup up the environment, see 3. above.
+
+Use 'make' from the root directory to build things. The default target
+is called 'quick' and will to a quick build of everything assuming that
+gcc and libs level is pretty much the same as the one you're building. 
+
+When doing this kind of build, we install the subcomponent as they are
+built into 'obj/OS2/DEBUG/builtunix' and uses them for the building the 
+rest. The builtunix directory is at the head of all paths setup by the 
+env.cmd script.
+
+When everything has been built, it is installed into 
+bin/OS2/DEBUG/3.3.5-beta5/ (or whatever the release is set to).
+
+
+Other common targets are:
+    'double-quick'              - used for releases. do two cycles of 'quick'.
+    'emx'                       - builds emx
+    'emx-quick-libs'            - libraries
+    'emx-quick-libs-install'    - installs into builtunix
+    'emx-quick-rest'            - toolchain
+    'emx-quick-rest-install'    - installs into builtunix
+    'binutils-quick'            - builds binutils
+    'binutils-quick-installstage' - installs into builtunix
+    'gcc-quick'                 - builds gcc
+    'gcc-quick-installstage'    - installs into builtunix
+    'gcc'                       - bootstraps gcc (might be broken)
+
+See Makefile for full reference on these and other targets.