summaryrefslogtreecommitdiff
path: root/morph.1.in
diff options
context:
space:
mode:
authorSam Thursfield <sam.thursfield@codethink.co.uk>2013-03-12 17:53:41 +0000
committerSam Thursfield <sam.thursfield@codethink.co.uk>2013-03-15 11:04:55 +0000
commit4b5f45f6c9833f2c81dbbd1eef7a0ff09b73e401 (patch)
treefc21c84453ed0f390aa556cfb183ab385b2bdeb7 /morph.1.in
parentd726c63e2af6d208ecc4cb05e229093cf558a2de (diff)
downloadmorph-4b5f45f6c9833f2c81dbbd1eef7a0ff09b73e401.tar.gz
Update Morph man page regarding environment variables
Diffstat (limited to 'morph.1.in')
-rw-r--r--morph.1.in59
1 files changed, 20 insertions, 39 deletions
diff --git a/morph.1.in b/morph.1.in
index 03e074ed..232ae396 100644
--- a/morph.1.in
+++ b/morph.1.in
@@ -41,7 +41,7 @@ individual chunks for make, gcc, binutils and so forth.
.PP
A chunk is a git repository based on an individual upstream project's revision
control system, converted into git if upstream does not already use it.
-The build is controlled a
+The build is controlled by a
.B something.morph
configuration file
defining how to build the chunk and any other changes required to get the
@@ -66,54 +66,35 @@ itself, or the builds it runs.
.TP
.B PATH
.B morph
-keeps the user's
+supports building chunks in
+.B bootstrap
+mode, which exposes the host's tools for building rather than using a
+controlled chroot. The
.B PATH
-if the
-.B \-\-keep\-path
-option is used.
-Additionally,
-.B morph
-will prepend the location of the
-.BR ccache (1)
-binaries to the path,
-unless the
-.B no-cache
-setting is enabled.
+variable is significant for chunks built in this mode.
.TP
.BR DISTCC_HOSTS ", " TMPDIR ", " LD_PRELOAD ", " LD_LIBRARY_PATH ", " \
FAKEROOTKEY ", " FAKED_MODE ", " FAKEROOT_FD_BASE
.B morph
keeps these environment variable, if set.
.TP
-.B TOOLCHAIN_TARGET
-.B morph
-sets this to the value of the
-.B toolchain\-target
-setting from its configuration.
-.TP
-.B CFLAGS
+.B MORPH_ARCH
+The system morphology defines the architecture it should be built for, and
.B morph
-sets this to the value of the
-.B target\-cflags
-setting from its configuration.
+sets this variable in the build environment accordingly. Only a small set of
+predefined values can be used, and it is expected that morphologies can change
+the configuration of the chunk they are building based on this value.
.TP
-.B PREFIX
-.B morph
-sets this to the value of the
-.B prefix
-setting from its configuration.
+.B TARGET
+This value is set to the GNU machine triplet for the machine
+.B MORPH_ARCH
+defines.
.TP
-.B BOOTSTRAP
-.B morph
-sets this to
-.B true
-if the
-.B bootstrap
-setting from its configuration is enabled.
-Otherwise,
-.B morph
-sets the environment variable to
-.BR false .
+.B TARGET_STAGE1
+The same as
+.B TARGET
+but with the vendor field replaced with
+.BR bootstrap
.TP
.B MORPH_PLUGIN_PATH
.B morph