Re: [tlug] linux@example.com How many widely can we do that?

["Stephen J. Turnbull" <stephen@example.com>]

Edward Middleton writes:

 > Stephen, I take it your argument against inline documentation

First off, my original argument was against documentation *generated
from* code, not documentation *mixed with* code.

 > There is also the added advantage that inconsistencies between spec
 > and actual behavior become more obvious.

That depends on whether the users agree that the inline documentation
is the spec.  See my response to Curt regarding choice of version.