Re: [jamboost] template main-target documentation

From: David Abrahams (david.abrahams_at_[hidden])
Date: 2002-03-07 19:09:49

----- Original Message -----
From: "Thomas Witt" <witt_at_[hidden]>

>
> Hi,
>
> I finally managed to write the documentation for the proposed new
main-target
> "template".

I like it! A full doc patch would be in HTML, of course...

> Please note that the documentation describes template as I
> initially wanted it to be. Note that the supplied patch does not fully
> implement template as it is documented it only cares about the
requirement
> section.

I didn't get a patch. Did you post one?

> There were already a few comments on the name and further design
issues. I
> left these out so that you can see what I want to achieve. This does
not mean
> I think they are all wrong.
>
> As for the name I think requirement-set is not a suitable name for
template as
> it is documented. Its scope goes well beyond requirements. If we
decide only
> the requirement portion is needed requirement-set would certainly be a
good
> name for such a thing.

I agree with you, and wouldn't like to limit the scope. Just
experimenting with different names, how does "base" sound to you?

> Dave, I still think the analogy between templates and targets is ok.
These
> things _are_ pretty much like targets. Basically they are incomplete
targets.
> I hope the documentation makes this clear.

Yes, it does.

-Dave