From: Vladimir Prus (ghost_at_[hidden])
Date: 2003-11-03 04:07:10
David Abrahams wrote:
> > The same situation is in the docs -- which I'm tweaking at the moment.
> > Sometimes "target" refers to "main target", and sometimes to real file
> > target. What if we decide that targets which can produce different files
> > when generated with different properties are called "metatargets" and
> > file targets are called just "targets"?
> That sounds good to me.
> > For now, this will affect only docs, but I hope
> > code will be changed, too?
> That sounds bad to me. Code and docs must stay in synch or it will
> be a nightmare.
Okay, then I won't push this convention in docs until I can find the time to
update the code accordingly.
> > Second question. When writing docs, I find that the word "rule" does not
> > make much sense for a newcomer. I'd like to user more obvious "function"
> > instead. Is this idea reasonable? I might cause a confusion by the time
> > user finds that syntax for declaring "function" starts with "rule"
> > keyword, but at that time he won't be a newbiew any more.
> I suggest that we just hyperlink all uses of "rule" in the docs to a
> little description.
Hmm... is it good that user who just wants to write his first Jamfile needs to
follow a link just to find out what's 'rule'? If that user can pass the first
use of 'rule' without problem, anything else does not matter much.
Boost-Build list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk