Re: [jamboost] [BBv2 docs editorial] Installation

From: Vladimir Prus (ghost_at_[hidden])
Date: 2005-09-21 09:26:07

On Wednesday 21 September 2005 02:50, Andrey Melnikov wrote:
> Zbynek Winkler wrote:
> > Andrey Melnikov wrote:
> >>>>Go to the
> >>>> Boost.Build root directory and run bjam --version. You should see:
> >>>>
> >>>> Boost.Build V2 (Milestone N)
> >>>> Boost.Jam xx.xx.xx
> >>>>
> >>>> where N is the version of Boost.Build you're using.
> >>
> >>IMO we can omit this step at all. Or we can add it to a more
> >>comprehensive Installation Troubleshooting guide. We should follow the
> >>80/20 rule - 80% of users will need only 20% of the documentation.
> >
> > IMO it is a necesity. I remember when I was installing bb2 for the first
> > time, this wasn't in the documentation, so I never verified that bjam
> > can find the bb2 files (which it could not - surprise!). I just went to
> > an example project, run bjam and got a horribly looking back-trace,
> > never knowing what went wrong.
>
> I don't understand how these paragraphs can help you. N isn't mentioned
> any more, and it isn't clear for what do you need to run this bjam
> --version and why do you need to know "the version you're using".

Well, they do verify that bjam is installed correctly, I think. We probably 
can give more specific instructions what to do if error is printed, but 
otherwise this paragraph looks fine.

- Volodya

-- 
Vladimir Prus
http://vladimir_prus.blogspot.com
Boost.Build V2: http://boost.org/boost-build2