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