Commit a277751c authored by simonmar's avatar simonmar
Browse files

[project @ 2005-01-28 12:57:00 by simonmar]

Comment updates only (platform-related)
parent 153b9cb9
...@@ -56,6 +56,13 @@ ...@@ -56,6 +56,13 @@
# will be built as HC files for the target system, and likely won't # will be built as HC files for the target system, and likely won't
# build on this host platform. # build on this host platform.
# #
# An important invariant is that for any piece of source code, the
# platform on which the code is going to run is the HOST platform,
# and the platform on which we are building is the BUILD platform.
# Additionally for the compiler, the platform this compiler will
# generate code for is the TARGET. TARGET is not meaningful outside
# the compiler sources.
#
# Guidelines for when to use HOST vs. TARGET: # Guidelines for when to use HOST vs. TARGET:
# #
# - In the build system (Makefile, foo.mk), normally we should test # - In the build system (Makefile, foo.mk), normally we should test
...@@ -65,11 +72,10 @@ ...@@ -65,11 +72,10 @@
# #
# - In the compiler itself, we should test HOST or TARGET depending # - In the compiler itself, we should test HOST or TARGET depending
# on whether the conditional relates to the code being generated, or # on whether the conditional relates to the code being generated, or
# the platform on which the compiler is running. For stage 2, # the platform on which the compiler is running. See the section
# HOSTPLATFORM should be reset to be TARGETPLATFORM (we currently # on "Coding Style" in the commentary for more details.
# don't do this, but we should).
# #
# - In the RTS and library code, we should be testing TARGET only. # - In all other code, we should be testing HOST only.
# #
# NOTE: cross-compiling is not well supported by the build system. # NOTE: cross-compiling is not well supported by the build system.
# You have to do a lot of work by hand to cross compile: see the # You have to do a lot of work by hand to cross compile: see the
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment