[new user] Should I use V1 or V2 jam?

From: codeazure (jeffg_at_[hidden])
Date: 2003-08-14 00:39:39

I'm new to Boost.Jam and still trying to understand all that it can
do, so forgive me missing the obvious. I'm an experienced Make user,
but I'd like to use Boost.Jam on my new project, which will be
Boost.Python based. I plan on building gcc on Linux and msvc++ on
Windows versions of my application.

My question is, should I be using V1 or V2 Jamfiles? The documentation
confuses me about which version it is referring to and what the extent
of the changes between the versions are.

Is all the supplied documentation for v2 only or is it a mixture of v1
& v2?

If I use bjam --v2, does that only use Jamfile.v2 or does it need
Jamfile as well? 

As far as I can gather the current 3.1.4 release supports both v1 and
v2 formats.

I'm interested in using Jam as a tool for a production environment,
not developing and testing Jam in its own right.

Is there an overview of this topic I've missed somewhere? I've spent a
few days trying to come to terms with how it works & it is still
fairly opaque to me.

As you can see, I'm well and truly lost :-) I'm sure it is a
straightforward thing to understand what's happening, but I've gone
off the track somewhere.

Thanks,
Jeff Gray