On 06/20/2013 04:47 PM, Corey Richardson wrote:
On Thu, Jun 20, 2013 at 7:30 PM, Brian Anderson <[email protected]> wrote:
On 06/19/2013 01:01 PM, Corey Richardson wrote:
I am going to rewrite and redesign rustdoc. Current bikeshed:
https://github.com/mozilla/rust/wiki/Bikeshed-rustdoc
Please discuss, give me your feature requests, comments, etc.
This is great news. Here are my thoughts about rustdoc: the next generation.
[snip]
The big, big problem with both these things is that to do them right
requires running resolve. Running resolve to produce documentation though is
not generally possible because it requires upstream crates to already be
compiled.
I think this is a problem with rust overall right now, and it's one of
the things that a header system allows quite nicely: usage of API
declaration without compilation. I'm not sure what the best way to
solve this is, though. The best I can come up with is maybe an `.rmd`
file that just contains extracted crate metadata, and that there be a
rustc mode that allows this. I don't know the exact details of the
metadata: maybe someone else could elaborate on what it is, where it
comes from, and what it is used for? (This would fit in with my goal
of "replace the monstrosity that is ebml"). It might be worth looking
into how .NET or other platforms with similar architecture accomplish
this, if at all.
This has the same problem though - the compiler still must be run on
upstream crates to produce the metadata.
_______________________________________________
Rust-dev mailing list
[email protected]
https://mail.mozilla.org/listinfo/rust-dev
