Of course, most builds are more complicated than in the previous chapter. In this chapter, you will learn about builds that incorporate multiple source files, and then about building multiple targets that share some source files.
You've seen that when you call the Program
builder method,
it builds the resulting program with the same
base name as the source file.
That is, the following call to build an
executable program from the hello.c
source file
will build an executable program named hello
on POSIX systems,
and an executable program named hello.exe
on Windows systems:
Program('hello.c')
If you want to build a program with a different base name than the base of the source file name (or even the same name), you simply put the target file name to the left of the source file name:
Program('new_hello', 'hello.c')
SCons requires the target file name first,
followed by the source file name,
so that the order mimics that of an
assignment statement in most programming languages,
including Python:
"target = source files"
. For an
alternative way to supply this information, see
Section 3.6, “Keyword Arguments”.
Now SCons will build an executable program
named new_hello
when run on a POSIX system:
% scons -Q
cc -o hello.o -c hello.c
cc -o new_hello hello.o
And SCons will build an executable program
named new_hello.exe
when run on a Windows system:
C:\>scons -Q
cl /Fohello.obj /c hello.c /nologo
link /nologo /OUT:new_hello.exe hello.obj
embedManifestExeCheck(target, source, env)