FreeCalypso > hg > freecalypso-tools

comparison INSTALL @ 475:c08ff097b2aa

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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
comparison
equal deleted inserted replaced
474:bbb4f92265d2 475:c08ff097b2aa
53 53
54 Previous versions of this FC host tools package included a UI development aid 54 Previous versions of this FC host tools package included a UI development aid
55 utility called fc-lcdemu which needs libX11 to compile and an X11 display to 55 utility called fc-lcdemu which needs libX11 to compile and an X11 display to
56 run; this utility has now been moved to a separate freecalypso-ui-dev 56 run; this utility has now been moved to a separate freecalypso-ui-dev
57 repository and is no longer a part of the core FC host tools package. 57 repository and is no longer a part of the core FC host tools package.
58
59 CC= and CFLAGS= selection
60 =========================
61
62 Our Makefile hierarchy is set up to build with CC=gcc and CFLAGS=-O2 by default.
63 If you need to change either or both of these selections, you can do it by
64 adding CC= and/or CFLAGS= on the make invokation line, for example:
65
66 make CC=mygcc CFLAGS="-g -O2 -whatever-options"
58 67
59 libserial and Linux specifics 68 libserial and Linux specifics
60 ============================= 69 =============================
61 70
62 We have our own private library called libserial which contains our serial port 71 We have our own private library called libserial which contains our serial port
119 'make install' to install these target binaries in /opt/freecalypso/target-bin, 128 'make install' to install these target binaries in /opt/freecalypso/target-bin,
120 which is where loadtools will look for them. 129 which is where loadtools will look for them.
121 130
122 Run 'make all' in target-utils to build some additional target code pieces that 131 Run 'make all' in target-utils to build some additional target code pieces that
123 are needed only for development and only very rarely. 132 are needed only for development and only very rarely.
133
134 Staged installs
135 ===============
136
137 As already explained above, our FC host tools need to be installed under
138 /opt/freecalypso on your system in order to function correctly, and this runtime
139 location is not changeable. However, some users have requested an ability to
140 do a staged install: have the 'make install' operation install the finished
141 tree of files in some staging location, with the expectation that it will be
142 subsequently moved to /opt/freecalypso by some other mechanism. One use case
143 that has been presented to us was automated building of binary distribution
144 packages on a build host where writing to /opt/freecalypso is not allowed.
145
146 If you need to make a staged install of this sort, you can do it like this:
147
148 make install INSTALL_PREFIX=/home/me/my-fc-staging-area
149
150 Please note that this INSTALL_PREFIX= scheme changes *only* the location where
151 'make install' will deposit the installable files; it does NOT change the
152 location where our programs will look for other programs and helper files: the
153 latter location is hard-coded as /opt/freecalypso is bazillion places throughout
154 our code base.