Re: V2 documentation format: a resolution?

From: Zbynek Winkler (zwin_at_[hidden])
Date: 2004-02-09 11:32:41

Christopher Currie wrote:

>>As I understood this would be the only documentation on Boost.Build2 
>>so it probably should not be called User Manual either.
> 
> Do you have a suggestion for a better name? Volodya has commented that 
> he thought that a "developer's manual" should be a separate document, so 
> if we broke those bits out would it be better?

I think that the problem here is that I am not sure who is "user" and who is 
"developer". Could someone supply some examples? IMHO such a distinction is 
difficult to make. At which point a user writing a Jamfile becomes a developer 
writing a Jamfile? I am not very fond of splitting the docs in such a matter. 
Maybe Volodya has some reasons I am no aware of?

Zbynek

-- 
http://zw.matfyz.cz/ http://robotika.cz/
Faculty of Mathematics and Physics, Charles University, Prague, Czech Republic