On 19/10/2012 2:18 AM, Lucian Branescu wrote:
I've found first-class documentation to be very useful in Python, and
much more reliable than javadoc-like things.
I'd much rather have an attribute that is clearly linked to the
function rather than a comment floating about.
This was my preference too but enough people wanted the comment-based
syntax that we support it as well. They're synonymous: /** ... */ is
treated merely as a different syntax for #[doc="..."].
-Graydon
_______________________________________________
Rust-dev mailing list
[email protected]
https://mail.mozilla.org/listinfo/rust-dev