doc_file 0.0.1

Move your Rust crate's documentation into external files. 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

# `doc_file`

Move your Rust crate's documentation into external files.

## Why?

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

## Example usage

```rust
#![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 = "...")]`.

[issue]: https://github.com/rust-lang/rust/issues/15470