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

Reply via email to