Re: obj/tools vs obj/tooldir-x-y

[Martin Husemann <martin%duskware.de@localhost>]

On Tue, Jan 08, 2019 at 07:09:08PM +0100, Edgar Fuß wrote:
> I'm confused what's in obj/tools and what's in obj/tooldir-x-y-z.
> 
> In particular:
> What are these directories called if you want to talk about one of them?
> Which one does $TOOLDIR/build.sh -T refer to (I guess tooldir-x-y-z)?

No. $TOOLDIR (set by build.sh -T) is the directory into which tools
are installed. This can be anywhere (e.g. I often use -T /work/tools-$BRANCH
as I have to invoke things in there manualy during debugging - main
example: /work/tools-8/bin/nbmake-sparc64 to compile something for
sparc64 on the netbsd-8 branch).

The default for -T is inside the OBJDIR (if you do not use the -T option
for build.sh) because we can assume there is writable space.

Independend of the tools install directory ($TOOLDIR) there will be
obj dirs for the tool build - you can think of them as temporary files,
they are not needed ones the tools are build and installed into $TOOLDIR.
Keeping them around may speed up the next update build though.

> What does build.sh tools build?

All tools that are required to build the rest of the system.

> Which one(s) must be re-built in case src is updated?

build.sh handles that itself usually. Only rarely manual intervention
is needed and documented in src/UPDATING.

Martin