more documentation on linking and separate compilation