manual -> reference & formatting

'reference' sounds better than 'manual' to me here, and rust.html is
certainly wrong.

I also wrapped everything to 80 cols.
This commit is contained in:
Steve Klabnik 2014-09-19 13:45:20 -04:00
parent 437179ed8b
commit 47682f96de
7 changed files with 4452 additions and 4422 deletions

View File

@ -29,9 +29,9 @@ DOCS := index intro tutorial guide guide-ffi guide-macros guide-lifetimes \
guide-tasks guide-container guide-pointers guide-testing \
guide-runtime complement-bugreport \
complement-lang-faq complement-design-faq complement-project-faq rust \
rustdoc guide-unsafe guide-strings
rustdoc guide-unsafe guide-strings reference
PDF_DOCS := guide rust
PDF_DOCS := guide reference
RUSTDOC_DEPS_rust := doc/full-toc.inc
RUSTDOC_FLAGS_rust := --html-in-header=doc/full-toc.inc

View File

@ -30,7 +30,7 @@ To generate an HTML version of a doc from Markdown manually, you can do
something like:
~~~~
pandoc --from=markdown --to=html5 --number-sections -o rust.html rust.md
pandoc --from=markdown --to=html5 --number-sections -o reference.html reference.md
~~~~
(rust.md being the Rust Reference Manual.)

View File

@ -46,7 +46,7 @@ development of Rust itself is discussed.
# Specification
Rust does not have an exact specification, but an effort to describe as much of
the language in as much detail as possible is in [the manual](rust.html).
the language in as much detail as possible is in [the reference](reference.html).
# Guides

View File

@ -13,7 +13,7 @@ Some things that might be helpful to you though:
## Reference
* [The Rust official site](http://rust-lang.org)
* [The Rust reference manual](http://doc.rust-lang.org/rust.html) (* [PDF](http://doc.rust-lang.org/rust.pdf))
* [The Rust reference](http://doc.rust-lang.org/reference.html) (* [PDF](http://doc.rust-lang.org/reference.pdf))
## Docs
* [The standard library](http://doc.rust-lang.org/std/)

4445
src/doc/reference.md Normal file

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -23,7 +23,7 @@ pub fn expand_syntax_ext<'cx>(cx: &'cx mut ExtCtxt,
-> Box<base::MacResult+'cx> {
cx.span_warn(sp, "`bytes!` is deprecated, use `b\"foo\"` literals instead");
cx.parse_sess.span_diagnostic.span_note(sp,
"see http://doc.rust-lang.org/rust.html#byte-and-byte-string-literals \
"see http://doc.rust-lang.org/reference.html#byte-and-byte-string-literals \
for documentation");
cx.parse_sess.span_diagnostic.span_note(sp,
"see https://github.com/rust-lang/rust/blob/master/src/etc/2014-06-rewrite-bytes-macros.py \