Commit Graph

1558 Commits

Author SHA1 Message Date
Steve Klabnik
58946458f4 Merge pull request #65 from rust-lang/lifetimes
Draft of the non-advanced part of 'lifetimes'
2016-01-27 14:02:23 -05:00
Steve Klabnik
56d2508640 Move lifetimes chapter later 2016-01-27 14:02:08 -05:00
Steve Klabnik
f6271f6f22 Draft of the non-advanced part of 'lifetimes' 2016-01-22 13:23:16 -05:00
Steve Klabnik
ec0d93fc4c Remove Makefile
mdbook supports testing now, so there's no need.
2016-01-20 19:31:27 -05:00
Steve Klabnik
cabe126907 Fix the build 2016-01-20 19:26:54 -05:00
Steve Klabnik
fbffce8a6e rephrase dangling section 2016-01-20 16:19:33 -05:00
Steve Klabnik
14c284e6d8 stick with functions 2016-01-20 16:19:33 -05:00
Steve Klabnik
0e0893b893 whoops 2016-01-20 16:19:33 -05:00
Steve Klabnik
4e074c198b first draft: references and borrowing 2016-01-20 16:19:33 -05:00
Steve Klabnik
c7a0e35b95 Fix rendering of Robert Frost
This needs trailing spaces so that the newlines work out
2016-01-20 16:17:27 -05:00
Steve Klabnik
599820b48d Remove old content
I originally wanted it here to compare/contrast with the current text,
but it just ends up making diffs difficult.
2016-01-20 16:16:25 -05:00
Steve Klabnik
1de1dd76ea Merge pull request #58 from rust-lang/ownership
first draft of 'ownership'
2016-01-19 11:10:22 -05:00
Steve Klabnik
307d96b6fe tweaks 2016-01-15 16:20:32 -05:00
Steve Klabnik
9c8c110789 more feedback 2016-01-15 16:15:58 -05:00
Steve Klabnik
8db0057b44 Merge pull request #62 from tehgeekmeister/patch-1
Smooth out a sentence.
2016-01-14 09:37:20 -05:00
Steve Klabnik
284a4acc80 Merge pull request #61 from JIghtuse/master
variable-bindings: Specify example language
2016-01-14 09:37:06 -05:00
Ezekiel Smithburg
4822e86856 Smooth out a sentence. 2016-01-14 01:02:04 -05:00
Boris Egorov
f7c62fc93f variable-bindings: Specify example language 2016-01-14 10:53:47 +06:00
Steve Klabnik
1045fa2c7b fix up some wording 2016-01-13 20:16:35 -05:00
Steve Klabnik
e6b45ea7f3 spelling 2016-01-13 19:26:18 -05:00
Steve Klabnik
63afd0713a whoops, too many any 2016-01-13 18:53:11 -05:00
Steve Klabnik
dcbd0d50b5 some tweaks based on @aturon's feedback 2016-01-13 18:34:48 -05:00
Steve Klabnik
e2a4f19a75 Add a center class for images 2016-01-13 16:45:30 -05:00
Steve Klabnik
3c1bc560f6 Add dot images
These aren't the best, but they're a start.
2016-01-13 16:44:47 -05:00
Steve Klabnik
468a585cec turn on the link in the summary 2016-01-13 16:44:35 -05:00
Steve Klabnik
8b022d2881 fix dumb mistakes 2016-01-12 19:30:52 -05:00
Steve Klabnik
f1b9e52ccd add stuff about functions 2016-01-12 18:58:25 -05:00
Steve Klabnik
3164bf5e38 first draft of 'ownership' 2016-01-12 18:06:16 -05:00
Steve Klabnik
40c93504dd Update the TOC for ownership.
Here's a rough summary of notes from @aturon and I's discussion about
this:

Topics:
    - heap vs stack
    - pointers
    - slices
    - scope/drops

- Ownership
    - confusion around allocating strings vs literals
    - String::new and String.push
    - or do we use String::from?
    - scope/drops
     - Move vs copy

- Borrowing
    - Rust's take on pointers to entire objects

- Memory layout
    - heap vs stack -- what does it mean to own a String -- what even is
      a String??
    - talk in terms of box and arrow diagrams, rather than address
      spaces etc
    - keep a high level of conceptual abstraction
    - pointers

- Slices
    - Rust's take on *interior* pointers
    - Niko argues that slices and borrowing from fields of a struct are
      conceptually related
    - Sing the praises of slices wrt safety!
    - We get to address string literals very early!
    - Sidebar on literals and rodata

- Advanced: lifetimes
2016-01-12 14:35:10 -05:00
Steve Klabnik
fd2dc5e2e0 Add stuff about nostarch 2016-01-08 12:09:26 -05:00
Steve Klabnik
fc634adba1 remove my home directory from path names 2016-01-08 11:54:15 -05:00
Steve Klabnik
8383d67cd7 Primitive Rust -> 'up and running'
primitive feels bad for a number of reasons, let's try this
2016-01-08 11:41:07 -05:00
Steve Klabnik
b50e0a439b these chapters aren't ready yet 2016-01-08 11:37:51 -05:00
Steve Klabnik
3092afb040 Merge pull request #56 from azerupi/master
Fix typos
2016-01-03 19:04:35 -05:00
Mathieu David
6ae257b276 Fix typos 2016-01-04 00:34:27 +01:00
Steve Klabnik
c784b1cda2 Grey out a lot of the TOC
Take advantage of an mdBook feature to grey these out. This will also
help with the "what is draft ready and what isn't" bit
2015-12-30 11:24:16 -05:00
Steve Klabnik
98bd2931dc @aturon feedback on if
https://github.com/rust-lang/book/issues/9#issuecomment-167879371
2015-12-29 17:36:30 -05:00
Steve Klabnik
db59879a46 just don't talk about inner doc comments 2015-12-29 17:36:30 -05:00
Steve Klabnik
f6534b1754 Update types chapters as per @aturon's feedback 2015-12-29 17:36:30 -05:00
Steve Klabnik
ff1b2b8a13 name section headings more consistently 2015-12-29 17:36:30 -05:00
Steve Klabnik
1a6899070f Split up primitive types into scalar and compound types
In the process, drop &str and fn.
2015-12-29 17:36:30 -05:00
Steve Klabnik
78d0bcdf28 Merge pull request #54 from azerupi/master
Add disclaimer about the book being in progress on all rendered pages
2015-12-29 17:01:48 -05:00
Mathieu David
62129f393d Add disclaimer about the book being in progress on handlebars template so that it shows on all pages of the rendered book 2015-12-29 22:48:51 +01:00
Steve Klabnik
8898dcf0ea Merge pull request #51 from clemensw/structs_typo
Fix trivial typo
2015-12-29 10:59:19 -05:00
Steve Klabnik
5cd39dadb6 Merge pull request #52 from clemensw/structs_compare_to_tuples
Example Point changes coordinates.
2015-12-29 10:58:54 -05:00
Clemens Wehrmann
799b5034cc Example Point changes coordinates.
When the implementation a point moves from tuple to struct, the point coordinates should remain the same to avoid confusion.
2015-12-29 09:53:08 +01:00
Clemens Wehrmann
3ce0088384 Fix trivial typo 2015-12-29 09:43:45 +01:00
Steve Klabnik
aad634e61d mdbook doesn't default to rust
In rustdoc, I don't need the Rust, but here I do.
2015-12-28 14:47:49 -05:00
Steve Klabnik
00bb4e1a8f whoops, forgot an ignore 2015-12-28 13:01:43 -05:00
Steve Klabnik
fbe9c79b59 first draft of structs 2015-12-28 12:38:29 -05:00