Are explicit `mod`s too heavyweight for this?

On Thu, May 2, 2013 at 6:18 AM, Niko Matsakis <n...@alum.mit.edu> wrote:

> I often find when writing code that I want to introduce "sections"
> into my file.  Typically I do this like:
>
>     ////////////////////////////////////////////////////////
>     // Node construction
>     //
>     // Methods for constructing new nodes.
>
> I find this helpful when browsing through the code. I imagine
> something similar would be helpful when browsing through rustdocs.
> Maybe we can find a way to incorporate some sort of "section"
> to use when grouping items, methods, fields, etc. I imagine
> we could draw on Markdown's `#`, `##`, `###` notation to
> define sections, subsections, and so forth, but I'm just
> not sure how we would let rustdoc know about it, since there
> is nothing in particular to attach the attribute to.
>
> Any thoughts? Is this something other people would like?
>
>
> Niko
> _______________________________________________
> 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

Reply via email to