Is it too late/undesirable to have an explicit, separate syntax for docstrings, a bit like Lisps/Python?
On 1 May 2013 18:32, Patrick Walton <[email protected]> wrote: > On 5/1/13 10:29 AM, John Clements wrote: > >> Currently, the set of doc comments includes (among other things) >> lines beginning with three slashes, *unless* they're entirely >> slashes. Presumably, this is to ensure that things like >> >> ///////////// // Time to go get some coffee! //////////// >> >> ... aren't parsed as two doc comments consisting entirely of slashes >> (with an ignored comment in between. >> >> This makes sense to me. >> >> However, it also means that things like >> >> /// My awesome procedure /// /// - does everything, /// /// - is >> kinda slow. >> >> is parsed as three lines of doc comments, rather than five. >> >> I propose that '///' should be treated as a doc comment, essentially >> by special-casing it. >> >> The risk is that certain existing normal-comments would be changed >> into doc-comments, causing compilation failure. If people think this >> change is (otherwise) sensible, I'll naturally check it locally on my >> tree before inflicting it on anyone else. >> > > +1. The current behavior just plain seems like a bug. > > Patrick > > > ______________________________**_________________ > Rust-dev mailing list > [email protected] > https://mail.mozilla.org/**listinfo/rust-dev<https://mail.mozilla.org/listinfo/rust-dev> >
_______________________________________________ Rust-dev mailing list [email protected] https://mail.mozilla.org/listinfo/rust-dev
