diff INSTALL @ 475:c08ff097b2aa

CHANGES and INSTALL: staged install ability documented
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 13 Feb 2019 06:02:58 +0000
parents 0a01e1c4ea54
children f33d050eac6e
line wrap: on
line diff
--- a/INSTALL	Wed Feb 13 05:20:01 2019 +0000
+++ b/INSTALL	Wed Feb 13 06:02:58 2019 +0000
@@ -56,6 +56,15 @@
 run; this utility has now been moved to a separate freecalypso-ui-dev
 repository and is no longer a part of the core FC host tools package.
 
+CC= and CFLAGS= selection
+=========================
+
+Our Makefile hierarchy is set up to build with CC=gcc and CFLAGS=-O2 by default.
+If you need to change either or both of these selections, you can do it by
+adding CC= and/or CFLAGS= on the make invokation line, for example:
+
+make CC=mygcc CFLAGS="-g -O2 -whatever-options"
+
 libserial and Linux specifics
 =============================
 
@@ -121,3 +130,25 @@
 
 Run 'make all' in target-utils to build some additional target code pieces that
 are needed only for development and only very rarely.
+
+Staged installs
+===============
+
+As already explained above, our FC host tools need to be installed under
+/opt/freecalypso on your system in order to function correctly, and this runtime
+location is not changeable.  However, some users have requested an ability to
+do a staged install: have the 'make install' operation install the finished
+tree of files in some staging location, with the expectation that it will be
+subsequently moved to /opt/freecalypso by some other mechanism.  One use case
+that has been presented to us was automated building of binary distribution
+packages on a build host where writing to /opt/freecalypso is not allowed.
+
+If you need to make a staged install of this sort, you can do it like this:
+
+make install INSTALL_PREFIX=/home/me/my-fc-staging-area
+
+Please note that this INSTALL_PREFIX= scheme changes *only* the location where
+'make install' will deposit the installable files; it does NOT change the
+location where our programs will look for other programs and helper files: the
+latter location is hard-coded as /opt/freecalypso is bazillion places throughout
+our code base.