Commit Graph

601 Commits

Author SHA1 Message Date
Bruce Adams
cc675f264a Enhance Windows examples
Most importantly, `#` does not introduce a comment in Windows CMD.
Also, switch the Windows code blocks to `cmd` instead of `bash`
and change the prompt to a more Windows typical `>`.
2016-08-31 19:54:50 -04:00
Carol (Nichols || Goulding)
ca20a04ceb Fixed formatting to be all Literal inline 2016-08-31 19:44:08 -04:00
Carol (Nichols || Goulding)
33943ea70c Don't leave the reader hanging wondering about use statements
And what they're relative to, if not the current module.

Fixes #239.
2016-08-30 12:49:43 -04:00
Carol (Nichols || Goulding)
cf3f9e13f1 Rename the project from "modules" to "communicator"
To make "modules" have fewer meanings.

Fixes #241.
2016-08-30 12:47:03 -04:00
Carol (Nichols || Goulding)
a09f376ca4 Clarify what the two problems modules solve are
Fixes #240.
2016-08-30 12:34:02 -04:00
Carol (Nichols || Goulding)
29c74cc4df Stay with "you" for the module intro
Fixes #238.
2016-08-30 12:30:10 -04:00
Carol (Nichols || Goulding)
bffe7c1ec7 Merge pull request #233 from spastorino/fix_guess_typo
Fix guses -> guess typo
2016-08-30 12:21:30 -04:00
Carol (Nichols || Goulding)
f108abe476 Save the odt chapter 2 in the state after Carol checked it
- Fixed some formatting
- Revised some changes Liz made further
- Incorporated some edits we made here since last we sent it to NSP
- Did the code snipping, ghosting, and annotating
2016-08-30 00:51:19 -04:00
Carol (Nichols || Goulding)
8fad786700 Save the odt file for ch 2 in its state when Liz sent it to us 2016-08-30 00:51:19 -04:00
Carol (Nichols || Goulding)
8dadac47f6 Small changes from nostarch before going to copyedit 2016-08-30 00:51:19 -04:00
Steve Klabnik
20a9fdf6f2 Merge pull request #142 from rust-lang/modules
Start modules _again_
2016-08-29 14:46:06 -04:00
Steve Klabnik
4fe5a2c2ae Merge pull request #237 from rust-lang/cache
Use cache: cargo
2016-08-29 12:34:24 -04:00
Steve Klabnik
5e32b2ed88 Use cache: cargo
Based on
https://github.com/rust-lang/book/pull/232#issuecomment-242874255
2016-08-29 12:20:23 -04:00
Steve Klabnik
c9e0652355 these arrows are off-by-one 2016-08-29 12:14:41 -04:00
Steve Klabnik
b005095847 these should be single quotes 2016-08-29 12:14:15 -04:00
Steve Klabnik
94088e170f re-write intro 2016-08-29 12:13:53 -04:00
Santiago Pastorino
a226f08460 Fix guses -> guess typo 2016-08-27 17:38:23 -03:00
Carol (Nichols || Goulding)
93f185a150 Remove naming conflict example since it should be rarer soon! 2016-08-26 17:43:01 -07:00
Carol (Nichols || Goulding)
9090d03050 Bump subchapter headings in a level 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
db52e35bf9 Zero-index the filenames 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
555023fc28 Give the modules chapter a bit of a summary conclusion 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
83637d68c8 Fix mistakes I made with modules... I've confused myself 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
c9e0a9aafe Add illustrative examples for the privacy rules 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
34dbf2e865 Word the privacy rules consistently 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
8c46ff3cd8 This comma looked funny just now 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
d63d88ddeb Actually, this bit about tests needs to go after intro of use 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
afc4bc2541 Move summary of file/module changes to end of part 2 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
7ad920f34a Elide some warnings when we want to concentrate on the errors 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
d532801172 Reword some things on another reading 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
0705ea8eff Work through adding pub because of warnings in a different way
I felt like the previous version was a bit vague and left the impression
that dead code warnings should be fixed by adding `pub` everywhere. What
I think it was *trying* to say was that because we WANT these functions
to be public for external folks to use, THAT'S why we're getting the
warnings and why pub is the fix for it.
2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
4835474c82 Oops, this comment needs to be a rust comment 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
b73f3d1794 Some small wording edits 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
31863c3549 Set up the example context a bit better 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
9627117464 Use parens with functions in prose 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
dce64eb42b Remove unfulfilled foreshadowing 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
56f69991cf Move pub use discussion to the library chapter
Maybe we should think about a separate book about creating a library ;)
2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
4bab40d45e Add an example of a naming conflict caused by glob import 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
f0400e75d6 Clarify that it's not "many", it's "all" that glob imports 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
40f08bba94 Encourage curly braces and lists for importing multiple things
This is more common than multiple lines or globs, so we should encourage
it.
2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
e427b5f3a9 Make the tree output text so it doesn't get tested as rust 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
14adf56e8a Oops, hard wrap 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
7dc4e78ba7 Clear up the module rules 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
84ba655cd9 Make compilation messages use the projects dir 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
68f465bbc3 Use network/client/server as mods and connect as functions
Instead of foo/bar/tests and it_works. This doesn't make the most sense
ever, but it's a little better than metasyntactic variables :)
2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
f94d402f2d Add an explicit definition of what a module is
Felt like this was missing just now, but not really the first time I
read this. Strange.
2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
a8bf2acd46 Take aturon's suggestion about the contents of the foo module 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
6aba5d834b Remove the mention of "anonymous module" that confused me 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
89541a1649 Clarify where we'd have to use the full namespaced fn 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
dd0fdcd2dc Explain libraries vs binaries a bit since this is our first lib 2016-08-26 17:41:35 -07:00
Carol (Nichols || Goulding)
926d5bf37f Take aturon's suggestions about what we're bringing into scope 2016-08-26 17:41:35 -07:00