Re: [jamboost] Re: Re: V2 documentation feedback from a newbie

From: Vladimir Prus (ghost_at_[hidden])
Date: 2004-01-26 07:52:05

> le Friday 23 January 2004 14:27, ghost_at_[hidden] écrivit :
> > I see. Maybe, the beginning of "Reference" section should start with:
> >
> > Boost.Build consists of Boost.Jam binary -- which is a build tool with
> > it's own interpreted language -- and Boost.Build itself, which is written
> > in Boost.Jam language. On startup, bjam loads Boost.Build modules as
> > described in <link>. After that, Boost.Build starts to loading files
>
> "starts loading", the "to" shouldn't be there, if I am not mistaken.

You're right.

> > describing project -- Jamfiles, creating targets along the way. After
> > that the targets are build.
> >
> > Does this clarify anything?
>
> ah yes, that's great. I had tried my own phrasing in the meantime, in my
> other post, but it's nicer this way.

Ok, let it be this way.

> I still think the synopsis being in a separate index.html file is not right
> though.

My primary motivation was to have newcome immediately see a list of benefits.

- Volodya