doc_file 0.2.0

Move your Rust crate's documentation into external files.
docs.rs failed to build doc_file-0.2.0
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

doc_file

Build Status

Move your Rust crate's documentation into external files.

Why?

This is a proof of concept implementation of rust-lang/rust#15470. I hope to iron out questions and discover issues out of tree and then contribute this back to rustc itself.

Example usage

#![feature(phase)]

// Paths are relative to the source file.
#![doc_file = "example_crate.markdown"]

#[phase(plugin)] extern crate doc_file;

#[doc_file = "complicated_thing.markdown"]
pub struct ComplicatedThing;

Open issues

The syntax #[doc_file = "..."] is a little ugly. Ideally it would be something like #[doc(file = "...")].