Subversion Repositories gelsvn

Rev

Rev 39 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 39 Rev 58
Line 70... Line 70...
70 
 
 70 
 
71 
The PLATFORM is a string concatenation of the os cpu and compiler, e.g.
 71 
The PLATFORM is a string concatenation of the os cpu and compiler, e.g.
72 
 
 72 
 
73 
Linux_i686_g++
 73 
Linux_i686_g++
74 
 
 74 
 
75 
The TARGET is either `debug' or `release'
 75 
The TARGET is either `debug' or `release'. By default it is debug. It is
- 
 
 76 
recommended that you do _not_ hardwire your own default into the makefiles
- 
 
 77 
as I did for many years. It seems better to define the variable when running
- 
 
 78 
make, using "make TARGET=release" or by setting the target variable in the
76 
 
 79 
environment.
77 
 
 80 
 
78 
 
 81 
 
79 
Make'ing from the source root
 82 
Make'ing from the source root
80 
-----------------------------
 83 
-----------------------------
81 
 
 84 
 
Line 84... Line 87...
84 
 
 87 
 
85 
from the root of the source tree will cause first every library and
 88 
from the root of the source tree will cause first every library and
86 
then every application to be remade. However, there are several
 89 
then every application to be remade. However, there are several
87 
targets.
 90 
targets.
88 
 
 91 
 
- 
 
 92 
make all			 - equivalent to "make lib app"
- 
 
 93 
 
89 
make lib       - make all libraries
 94 
make lib       - make all libraries
90 
 
 95 
 
91 
make app       - make all applications
 96 
make app       - make all applications
92 
 
 97 
 
93 
make clean     - clean all library directories and app directories.
 98 
make clean     - clean all library directories and app directories.
Line 96... Line 101...
96 
                 removes generated libraries.
101 
                 removes generated libraries.
97 
 
 102 
 
98 
make distclean - cleans and completely removes all build directories.
103 
make distclean - cleans and completely removes all build directories.
99 
 
 104 
 
100 
make platform  - copies a template to OS_CPU_COMPILER.mk in the
 105 
make platform  - copies a template to OS_CPU_COMPILER.mk in the
101 
                 makefiles directory
 106 
                 makefiles directory. Use this only if you know what you
- 
 
 107 
								 are doing.
- 
 
 108 
 
- 
 
 109 
make install   - Copies header files and libraries to the appropriate place
- 
 
 110 
							   which is /usr/local by default. The libraries which are
- 
 
 111 
								 copied are either the debug or release versions depending
- 
 
 112 
								 on the active target. Right now, install does not install
- 
 
 113 
								 applications since many are little test programs that do
- 
 
 114 
								 not belong in your path.
- 
 
 115 
 
102 
 
 116 
 
103 
Make'ing in subdirectories
 117 
Make'ing in subdirectories
104 
--------------------------
 118 
--------------------------
105 
 
 119 
 
106 
Go to a subdirectory of src, say src/somedir.
120 
Go to a subdirectory of src, say src/somedir.
107 
Here you have the following options:
 121 
Here you have the following options:
108 
 
 122 
 
- 
 
 123 
make
109 
make lib
 124 
make lib
110 
make clean
 125 
make clean
111 
 
 126 
 
112 
The former will rebuild all sourcefiles and put them in a library
127 
The first two invocations are identical and will rebuild all sourcefiles and
113 
directory. The latter will remove all object and dependency files
128 
put them in a library directory. The latter will remove all object and
114 
(but only for the current platform (e.g. Linux_i686_g++_debug)
129 
dependency files (but only for the current platform
115 
The default target is lib.
 130 
(e.g. Linux_i686_g++_debug) The default target is lib.
116 
 
 131 
 
117 
Go to a subdirectory of apps, say apps/somedir.
132 
Go to a subdirectory of apps, say apps/somedir.
118 
Here you have the following options:
 133 
Here you have the following options:
119 
 
 134 
 
- 
 
 135 
make
- 
 
 136 
 
- 
 
 137 
or
- 
 
 138 
 
120 
make app
 139 
make app
121 
 
 140 
 
122 
will recompile the source files in the current directory and build the
141 
will recompile the source files in the current directory and build the
123 
programs. This is the default target. When compiled, the application is
 142 
programs. This is the default target. When compiled, the application is
124 
moved to ./bin
 143 
moved to wherever/GEL/bin
125 
 
 144 
 
126 
make force
 145 
make force
127 
 
 146 
 
128 
does the same but tries first to recompile all libraries that the
147 
does the same but tries first to recompile all libraries that the
129 
applications in somedir depend on. This is the safe way to recompile,
 148 
applications in somedir depend on. This is the safe way to recompile,
Line 196... Line 215...
196 
Copy appropriate source files to these directories and then edit
 215 
Copy appropriate source files to these directories and then edit
197 
 
 216 
 
198 
makefiles/config.mk
 217 
makefiles/config.mk
199 
 
 218 
 
200 
to tell us which compiler to use (leave blank to use default)
219 
to tell us which compiler to use (leave blank to use default)
201 
and to set the target to debug or release.
 - 
 
- 
 
 220 
 
202 
Finally, from the source root type
221 
Finally, from the source root type
203 
 
 222 
 
204 
make platform
 223 
make platform
205 
 
 224 
 
206 
Depending on your compiler you may now have to edit the makefile called
 225 
Depending on your compiler you may now have to edit the makefile called