Changeset 123 for trunk/src/emx/build.txt

Timestamp:

May 12, 2003, 12:48:43 PM (23 years ago)

Author:

zap

Message:

Started the work for re-designing the EMX C runtime library to not require
EMX.DLL. The new design is projected to be as follows:

• all emx syscalls are replaced with the routines from the old sys.lib library which is now compilable in both a.out and OMF formats.
• the sys.a library should be made replaceable and selectable by some gcc switch (e.g. -msyslib=emx would link with emx.a instead of sys.a which would give almost full backward compatibility with emx).
• All C functions names were renamed to not contain the starting underscore (e.g. fopen and not _fopen). The underscored aliases will be added later with the c_alias library (which will be generated automatically from all public symbols of libc; any exported symbol that do not start with an underscore will be given an underscored alias unless such a symbol is already defined).

Also a lot of updates to the building system. It is now much faster (thanks
to Knut's suggestion of using ash's builtin echo).
Also re-wrote thunk1.asm and thunk2.asm to GAS format; this removes the need
for MASM and makes it possible to use 16-bit functions in a.out programs
without the need for EMX.DLL.
Also made a lot of small changes I don't remember now.

File:

• trunk/src/emx/build.txt (modified) (4 diffs, 1 prop)

trunk/src/emx/build.txt

@@ -95 +95 @@
   'make help' in the module list section.
 
+
+
+
 .TARGET - The name of target (e.g. executable or library file name without dir).
   For example: .TARGET=myfile.exe
@@ -100 +103 @@
 .TKIND - (optional) The kind of target. It can consist of up to three
   components, the first one defines the object file format (omf or aout,
-  if not defined defaults to omf), the second defines the threadness
-  (st or mt, defaults to st), third can be 'prof' to build in profiling mode.
-  Example: .TKIND=omf st prof
+  if not defined defaults to omf), the second 
+  profiling mode.
+  Example: .TKIND=omf prof
 
 .TDEP - Dependencies for target (not built from a source file). For example,
@@ -141 +144 @@
 mklib.smak - this builder creates a library. It defines all rules required
   for building all object files and then runs the librarian which binds all
-  object files together in a single library.
+  object files together in a single library. Besides, if the file format is
+  a.out, it also defines a target called '$(.MODULE)@omf' (e.g. for module
+  zzz it also defines a module called zzz@omf) which will build the OMF
+  library from its a.out counterpart by using emxomf.
 
 Here is a simple example of a submakefile that will build a simple helloworld
@@ -195 +201 @@
 files from a single source file they are put under different output directories
 (e.g. single-threaded OMF object files go into $(OUT)/omf-st/ directory while
-multi-threaded a.out object files with profiling go into $(OUT)/aout-mt-prof/
+multi-threaded a.out object files with profiling go into $(OUT)/aout-prof/
 directory). This way, you can have several targets that are built from the
 same source files with different compilation options.