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 <[email protected]> wrote: > On Wed, May 1, 2013 at 5:44 PM, John Clements <[email protected]> > 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 > [email protected] > https://mail.mozilla.org/listinfo/rust-dev >
_______________________________________________ Rust-dev mailing list [email protected] https://mail.mozilla.org/listinfo/rust-dev
