Re: [BBv2 doc editorial] Tutorial

From: David Abrahams (dave_at_[hidden])
Date: 2005-09-20 16:37:56

Andrey Melnikov <melnikov_at_[hidden]> writes:

> David Abrahams wrote:
>> I have no comments on this section; just posting it here for the
>> record and so that others can comment:
>
>>>Chapter 23. Tutorial
>>>
>>>Table of Contents
>>>
>>>Hello, world
>>>Properties
>>> 
>>> Build Requests and Target Requirements
>>> Project Attributes
>>> 
>>>Project Hierarchies
>>>Dependent Targets
>>>Static and shared libaries
>>>Conditions and alternatives
>>>Prebuilt targets
>
> The table of contents looks cryptic for a new user. The terms are used 
> before they are defined:
> - BB project
> - Jam language
> - build variants
> - build targets
>
> The examples don't demonstrate the key BB features and don't have a big 
> practical usage for a newbie.
>
> Look at my Getting Started Guide: http://tinyurl.com/bcgwf
> It isn't perfect, but I think some ideas can be taken from there.

I like that page a lot, but I'm pretty sure that usage of the glob
rule in the first example is wrong.

-- 
Dave Abrahams
Boost Consulting
www.boost-consulting.com