Boost logo

Boost-Build :

From: David Abrahams (david.abrahams_at_[hidden])
Date: 2002-04-08 14:59:27


----- Original Message -----
From: "Rene Rivera" <grafik666_at_[hidden]>

> How do you consider the comment "#" style of documentation a better
> programmer interface?

1. Far less redundancy, i.e no need to:
a. write the name of the rule again
b. say that it is a rule as opposed to a variable
c. use special markings to denote arguments

2. Already familiar

3. Doesn't show up in debug output when not being scanned

Also, please see what's happening in the Python world:

http://aspn.activestate.com/ASPN/Mail/Message/python-dev/1097730

-Dave

 


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