Re: [jamboost] V2 UML diagrams

From: Vladimir Prus (ghost_at_[hidden])
Date: 2003-01-13 01:45:18

David Abrahams wrote:
> Vladimir Prus <ghost_at_[hidden]> writes:
> 
> 
>>I've just uploaded a couple of UML diagrams to
>>
>> http://boost.sourceforge.net/boost-build2/diagrams/
>>
>>The first shows main classes, 
> 
> 
> I understand that, and as you can see I've transcribed it into the
> relevant .jam files.

Thanks! I'm yet not on speaking terms with emacs picture-mode,
so hardly could do that. BTW, they look very nice!

>>and the second is a sequence chart
>>showing how a project with simple main target, created by the
>>"make" rule, might be generated.
> 
> 
> I don't understand that one. What are v1 and v2?

First, let's assume that jamfile contains:

make foo : bar : make-foo-from-bar ;

v1 and v2 are two instances of file-target class, v1 corresponds to
the "foo" file, and v2 --- to the "bar" file.

The anonymous instance of make-target creates both v1 and v2, as well as
action "a". (The "create" message means that the recipient of the message
is created). Later, the action for generation of v1 is set, and v1 is returned 
as result of call to generate.

After that, v1 is actualized, as shown by the following messages.

>>Please take a look at those and let me know:
>>1. If diagrams have any change of improving your understanding.
> 
> 
> Yes, the first one helps. The second one still leaves me with
> questions.

Are there remaining questions?

>>2. Is the quality OK? (There're scanned from hand-drawings).
> 
> 
> IMO the scan quality is OK, but the hand-drawings need to be cleaner
> if they're going to communicate well, which is why I converted them to
> ASCII.

What should be improved, precisely. Looking at them now, I see that text
is probably less readable than it should. The arrows looks good, however :-)

- Volodya