2014-08-01 16:31:22 -07:00
|
|
|
% Rust Documentation
|
2013-12-22 20:21:45 -06:00
|
|
|
|
2014-08-28 14:52:39 -04:00
|
|
|
Welcome to the Rust documentation! You can use the section headings above
|
|
|
|
to jump to any particular section.
|
|
|
|
|
|
|
|
# Getting Started
|
|
|
|
|
2015-05-08 13:18:04 -07:00
|
|
|
If you haven't seen Rust at all yet, the first thing you should read is the
|
|
|
|
introduction to [The Rust Programming Language](book/index.html). It'll give
|
|
|
|
you a good idea of what Rust is like.
|
|
|
|
|
|
|
|
The book provides a lengthy explanation of Rust, its syntax, and its
|
|
|
|
concepts. Upon completing the book, you'll be an intermediate Rust
|
|
|
|
developer, and will have a good grasp of the fundamental ideas behind
|
|
|
|
Rust.
|
2014-08-28 14:52:39 -04:00
|
|
|
|
2015-11-03 12:47:57 -08:00
|
|
|
[Rust By Example][rbe] teaches you Rust through a series of small
|
|
|
|
examples.
|
2015-04-13 18:07:34 -04:00
|
|
|
|
2015-04-15 12:58:00 -05:00
|
|
|
[rbe]: http://rustbyexample.com/
|
2015-04-13 18:07:34 -04:00
|
|
|
|
2015-09-06 16:07:55 +03:00
|
|
|
# Language Reference
|
2015-09-06 15:25:01 +03:00
|
|
|
|
2015-09-06 16:07:55 +03:00
|
|
|
Rust does not have an exact specification yet, but an effort to describe as much of
|
2015-09-06 15:25:01 +03:00
|
|
|
the language in as much detail as possible is in [the reference](reference.html).
|
|
|
|
|
2015-09-06 16:07:55 +03:00
|
|
|
# Standard Library Reference
|
2015-06-20 19:09:56 -07:00
|
|
|
|
|
|
|
We have [API documentation for the entire standard
|
|
|
|
library](std/index.html). There's a list of crates on the left with more
|
|
|
|
specific sections, or you can use the search bar at the top to search for
|
|
|
|
something if you know its name.
|
|
|
|
|
2015-09-06 15:25:01 +03:00
|
|
|
# Tools
|
|
|
|
|
2015-09-06 16:07:55 +03:00
|
|
|
[Cargo](https://crates.io) is the Rust's package manager providing access to libraries
|
|
|
|
beyond the standard one, and its website contains lots of good documentation.
|
2015-09-06 15:25:01 +03:00
|
|
|
|
2015-09-06 16:07:55 +03:00
|
|
|
[`rustdoc`](book/documentation.html) is the Rust's documentation generator, a tool converting
|
|
|
|
annotated source code into HTML docs.
|
2015-09-06 15:25:01 +03:00
|
|
|
|
2014-05-22 22:01:44 -07:00
|
|
|
# FAQs
|
|
|
|
|
2015-05-12 21:21:26 +10:00
|
|
|
There are questions that are asked quite often, so we've made FAQs for them:
|
2014-08-28 14:52:39 -04:00
|
|
|
|
2014-05-22 22:01:44 -07:00
|
|
|
* [Language Design FAQ](complement-design-faq.html)
|
|
|
|
* [Language FAQ](complement-lang-faq.html)
|
|
|
|
* [Project FAQ](complement-project-faq.html)
|
2015-02-24 23:26:25 +01:00
|
|
|
* [How to submit a bug report](https://github.com/rust-lang/rust/blob/master/CONTRIBUTING.md#bug-reports)
|
2014-05-22 22:01:44 -07:00
|
|
|
|
2015-05-12 21:21:26 +10:00
|
|
|
# The Error Index
|
|
|
|
|
|
|
|
If you encounter an error while compiling your code you may be able to look it
|
|
|
|
up in the [Rust Compiler Error Index](error-index.html).
|
2015-05-24 11:37:11 -04:00
|
|
|
|
|
|
|
# Community Translations
|
|
|
|
|
|
|
|
Several projects have been started to translate the documentation into other
|
|
|
|
languages:
|
|
|
|
|
|
|
|
- [Russian](https://github.com/kgv/rust_book_ru)
|
|
|
|
- [Korean](https://github.com/rust-kr/doc.rust-kr.org)
|
|
|
|
- [Chinese](https://github.com/KaiserY/rust-book-chinese)
|
2015-08-11 11:02:38 +01:00
|
|
|
- [Spanish](https://goyox86.github.io/elpr)
|
2015-10-06 12:31:57 +02:00
|
|
|
- [German](https://panicbit.github.io/rustbook-de)
|