FWIW, I am very much in favor of having 'proper' docstrings instead of comment docstrings. I don't really see any upside to comment docstrings at all...
2013/5/2 Lucian Branescu <lucian.brane...@gmail.com>: > Not necessarily: > > #[doc=""" > Actual docs, free to contain almost any characters, without the need for a > leading > character every line and with optional manual wrapping. > """] > > But since C, C++, Java tend to have comment docstrings, I do realise I'm in > the minority. > > > > On 1 May 2013 22:47, Daniel Micay <danielmi...@gmail.com> wrote: >> >> On Wed, May 1, 2013 at 5:44 PM, John Clements <cleme...@brinckerhoff.org> >> wrote: >> > >> > On May 1, 2013, at 10:57 AM, Graydon Hoare wrote: >> > >> >> On 13-05-01 10:32 AM, Lucian Branescu wrote: >> >>> Is it too late/undesirable to have an explicit, separate syntax for >> >>> docstrings, a bit like Lisps/Python? >> >> >> >> We have one: #[doc="..."] >> >> >> >> Doc comments are an alternative syntax for the same attribute because >> >> nobody liked that. >> > >> > I would have, but... c'est la vie. >> > >> > John >> >> The attribute syntax would get ugly pretty quickly for multi-line >> docstrings (which is hopefully eventually most, when they have >> examples). >> _______________________________________________ >> Rust-dev mailing list >> Rust-dev@mozilla.org >> https://mail.mozilla.org/listinfo/rust-dev > > > > _______________________________________________ > Rust-dev mailing list > Rust-dev@mozilla.org > https://mail.mozilla.org/listinfo/rust-dev > -- /f I reject your reality and substitute my own. http://courteous.ly/yp3Zgd _______________________________________________ Rust-dev mailing list Rust-dev@mozilla.org https://mail.mozilla.org/listinfo/rust-dev