Skip to content

Fix formatting of some code blocks in pdf docs #11350

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jan 7, 2014
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions doc/guide-macros.md
Original file line number Diff line number Diff line change
Expand Up @@ -278,6 +278,7 @@ return result + val;
This solves the indentation problem. But if we have a lot of chained matches
like this, we might prefer to write a single macro invocation. The input
pattern we want is clear:

~~~~
# macro_rules! b(
( $( ($e:expr) ~ ($p:pat) else $err:stmt ; )*
Expand All @@ -304,6 +305,7 @@ input patterns:
( binds $( $bind_res:ident ),* )
# => (0))
~~~~

...and:

~~~~
Expand Down
9 changes: 9 additions & 0 deletions doc/guide-tasks.md
Original file line number Diff line number Diff line change
Expand Up @@ -263,6 +263,7 @@ With `extra::future`, rust has a mechanism for requesting a computation and gett
later.

The basic example below illustrates this.

~~~
# fn make_a_sandwich() {};
fn fib(n: u64) -> u64 {
Expand All @@ -283,6 +284,7 @@ the future needs to be mutable so that it can save the result for next time `get

Here is another example showing how futures allow you to background computations. The workload will
be distributed on the available cores.

~~~
# use std::vec;
fn partial_sum(start: uint) -> f64 {
Expand Down Expand Up @@ -317,6 +319,7 @@ acts as a reference to the shared data and only this reference is shared and clo

Here is a small example showing how to use Arcs. We wish to run concurrently several computations on
a single large vector of floats. Each task needs the full vector to perform its duty.

~~~
# use std::vec;
# use std::rand;
Expand Down Expand Up @@ -348,14 +351,17 @@ fn main() {
The function `pnorm` performs a simple computation on the vector (it computes the sum of its items
at the power given as argument and takes the inverse power of this value). The Arc on the vector is
created by the line

~~~
# use extra::arc::Arc;
# use std::vec;
# use std::rand;
# let numbers = vec::from_fn(1000000, |_| rand::random::<f64>());
let numbers_arc=Arc::new(numbers);
~~~

and a clone of it is sent to each task

~~~
# use extra::arc::Arc;
# use std::vec;
Expand All @@ -365,9 +371,11 @@ and a clone of it is sent to each task
# let (port, chan) = Chan::new();
chan.send(numbers_arc.clone());
~~~

copying only the wrapper and not its contents.

Each task recovers the underlying data by

~~~
# use extra::arc::Arc;
# use std::vec;
Expand All @@ -379,6 +387,7 @@ Each task recovers the underlying data by
# let local_arc : Arc<~[f64]> = port.recv();
let task_numbers = local_arc.get();
~~~

and can use it as if it were local.

The `arc` module also implements Arcs around mutable data that are not covered here.
Expand Down
3 changes: 3 additions & 0 deletions doc/rust.md
Original file line number Diff line number Diff line change
Expand Up @@ -845,6 +845,7 @@ If a sequence of such redirections form a cycle or cannot be resolved unambiguou
they represent a compile-time error.

An example of re-exporting:

~~~~
# fn main() { }
mod quux {
Expand All @@ -868,6 +869,7 @@ All rules regarding accessing declared modules in `use` declarations applies to
and `extern mod` declarations.

An example of what will and will not work for `use` items:

~~~~
# #[allow(unused_imports)];
use foo::extra; // good: foo is at the root of the crate
Expand Down Expand Up @@ -1184,6 +1186,7 @@ a = Cat;
~~~~

Enumeration constructors can have either named or unnamed fields:

~~~~
enum Animal {
Dog (~str, f64),
Expand Down
4 changes: 4 additions & 0 deletions doc/tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -2790,13 +2790,15 @@ For example, if we move the `animals` module above into its own file...
mod plants;
mod animals;
~~~

~~~ {.ignore}
// src/animals.rs or src/animals/mod.rs
mod fish;
mod mammals {
mod humans;
}
~~~

...then the source files of `mod animals`'s submodules can
either be placed right next to that of its parents, or in a subdirectory if `animals` source file is:

Expand Down Expand Up @@ -2959,6 +2961,7 @@ pub fn bar() { println("Baz!"); }
There also exist two short forms for importing multiple names at once:

1. Explicit mention multiple names as the last element of an `use` path:

~~~
use farm::{chicken, cow};
# mod farm {
Expand All @@ -2969,6 +2972,7 @@ use farm::{chicken, cow};
~~~

2. Import everything in a module with a wildcard:

~~~
use farm::*;
# mod farm {
Expand Down