[rustc.git] / src / doc / book / first-edition / src / README.md

# The Rust Programming Language

Welcome! This book will teach you about the [Rust Programming Language][rust].
Rust is a systems programming language focused on three goals: safety, speed,
and concurrency. It maintains these goals without having a garbage collector,
making it a useful language for a number of use cases other languages aren’t
good at: embedding in other languages, programs with specific space and time
requirements, and writing low-level code, like device drivers and operating
systems. It improves on current languages targeting this space by having a
number of compile-time safety checks that produce no runtime overhead, while
eliminating all data races. Rust also aims to achieve ‘zero-cost abstractions’
even though some of these abstractions feel like those of a high-level language.
Even then, Rust still allows precise control like a low-level language would.

[rust]: https://www.rust-lang.org

“The Rust Programming Language” is split into chapters. This introduction
is the first. After this:

* [Getting started][gs] - Set up your computer for Rust development.
* [Tutorial: Guessing Game][gg] - Learn some Rust with a small project.
* [Syntax and Semantics][ss] - Each bit of Rust, broken down into small chunks.
* [Effective Rust][er] - Higher-level concepts for writing excellent Rust code.
* [Glossary][gl] - A reference of terms used in the book.
* [Bibliography][bi] - Background on Rust's influences, papers about Rust.

[gs]: getting-started.html
[gg]: guessing-game.html
[er]: effective-rust.html
[ss]: syntax-and-semantics.html
[gl]: glossary.html
[bi]: bibliography.html

## Source Code

The source files from which this book is generated can be found on
[GitHub][book].

[book]: https://github.com/rust-lang/book/tree/master/first-edition/src
Commit	Line	Data
8bb4bdeb	1	# The Rust Programming Language
92a42be0 SL	2
	3	Welcome! This book will teach you about the [Rust Programming Language][rust].
	4	Rust is a systems programming language focused on three goals: safety, speed,
	5	and concurrency. It maintains these goals without having a garbage collector,
	6	making it a useful language for a number of use cases other languages aren’t
	7	good at: embedding in other languages, programs with specific space and time
	8	requirements, and writing low-level code, like device drivers and operating
	9	systems. It improves on current languages targeting this space by having a
	10	number of compile-time safety checks that produce no runtime overhead, while
	11	eliminating all data races. Rust also aims to achieve ‘zero-cost abstractions’
	12	even though some of these abstractions feel like those of a high-level language.
	13	Even then, Rust still allows precise control like a low-level language would.
	14
	15	[rust]: https://www.rust-lang.org
	16
9cc50fc6	17	“The Rust Programming Language” is split into chapters. This introduction
92a42be0 SL	18	is the first. After this:
	19
	20	* [Getting started][gs] - Set up your computer for Rust development.
9cc50fc6	21	* [Tutorial: Guessing Game][gg] - Learn some Rust with a small project.
92a42be0	22	* [Syntax and Semantics][ss] - Each bit of Rust, broken down into small chunks.
9cc50fc6	23	* [Effective Rust][er] - Higher-level concepts for writing excellent Rust code.
92a42be0 SL	24	* [Glossary][gl] - A reference of terms used in the book.
	25	* [Bibliography][bi] - Background on Rust's influences, papers about Rust.
	26
	27	[gs]: getting-started.html
9cc50fc6	28	[gg]: guessing-game.html
92a42be0 SL	29	[er]: effective-rust.html
92a42be0 SL	30	[ss]: syntax-and-semantics.html
92a42be0 SL	31	[gl]: glossary.html
	32	[bi]: bibliography.html
	33
83c7162d	34	## Source Code
92a42be0 SL	35
	36	The source files from which this book is generated can be found on
	37	[GitHub][book].
	38
83c7162d	39	[book]: https://github.com/rust-lang/book/tree/master/first-edition/src