Skip to content

Commit 79a56eb

Browse files
committed
---
yaml --- r: 234239 b: refs/heads/beta c: 8320345 h: refs/heads/master i: 234237: 5500a66 234235: 162310c 234231: 18c99cf 234223: dab8f3d 234207: 0374f3b 234175: a6ab05e 234111: e093dbb 233983: cec7bc8 v: v3
1 parent 500c1fd commit 79a56eb

File tree

163 files changed

+9563
-8936
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

163 files changed

+9563
-8936
lines changed

[refs]

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ refs/tags/0.9: 36870b185fc5f5486636d4515f0e22677493f225
2323
refs/tags/0.10: ac33f2b15782272ae348dbd7b14b8257b2148b5a
2424
refs/tags/0.11.0: e1247cb1d0d681be034adb4b558b5a0c0d5720f9
2525
refs/tags/0.12.0: f0c419429ef30723ceaf6b42f9b5a2aeb5d2e2d1
26-
refs/heads/beta: bc7c4304ab2af12e782945f139eb73e4842b9d68
26+
refs/heads/beta: 8320345221362e0a504e1d5efba7495bc895cb58
2727
refs/tags/1.0.0-alpha: e42bd6d93a1d3433c486200587f8f9e12590a4d7
2828
refs/heads/tmp: 370fe2786109360f7c35b8ba552b83b773dd71d6
2929
refs/tags/1.0.0-alpha.2: 4c705f6bc559886632d3871b04f58aab093bfa2f

branches/beta/COMPILER_TESTS.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# Compiler Test Documentation
2+
3+
In the Rust project, we use a special set of comands imbedded in
4+
comments to test the Rust compiler. There are two groups of commands:
5+
6+
1. Header commands
7+
2. Error info commands
8+
9+
Both types of commands are inside comments, but header commands should
10+
be in a comment before any code.
11+
12+
## Summary of Error Info Commands
13+
14+
Error commands specify something about certain lines of the
15+
program. They tell the test what kind of error and what message you
16+
are expecting.
17+
18+
* `~`: Associates the following error level and message with the
19+
current line
20+
* `~|`: Associates the following error level and message with the same
21+
line as the previous comment
22+
* `~^`: Associates the following error level and message with the
23+
previous line. Each caret (`^`) that you add adds a line to this, so
24+
`~^^^^^^^` is seven lines up.
25+
26+
The error levels that you can have are:
27+
1. `ERROR`
28+
2. `WARNING`
29+
3. `NOTE`
30+
4. `HELP` and `SUGGESTION`*
31+
32+
\* **Note**: `SUGGESTION` must follow emediatly after `HELP`.
33+
34+
## Summary of Header Commands
35+
36+
Header commands specify something about the entire test file, as a
37+
whole, instead of just a few lines inside the test.
38+
39+
* `ignore-X` where `X` is an architecture, OS or stage will ignore the test accordingly
40+
* `ignore-pretty` will not compile the pretty-printed test (this is done to test the pretty-printer, but might not always work)
41+
* `ignore-test` always ignores the test
42+
* `ignore-lldb` and `ignore-gdb` will skip the debuginfo tests
43+
* `min-{gdb,lldb}-version`

branches/beta/CONTRIBUTING.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ links to the major sections:
1010
* [Writing Documentation](#writing-documentation)
1111
* [Issue Triage](#issue-triage)
1212
* [Out-of-tree Contributions](#out-of-tree-contributions)
13+
* [Helpful Links and Information](#helpful-links-and-information)
1314

1415
If you have questions, please make a post on [internals.rust-lang.org][internals] or
1516
hop on [#rust-internals][pound-rust-internals].
@@ -210,3 +211,28 @@ valuable!
210211
[users]: https://users.rust-lang.org/
211212
[so]: http://stackoverflow.com/questions/tagged/rust
212213
[community-library]: https://github.com/rust-lang/rfcs/labels/A-community-library
214+
215+
## Helpful Links and Information
216+
217+
For people new to Rust, and just starting to contribute, or even for
218+
more seasoned developers, some useful places to look for information
219+
are:
220+
221+
* The [Rust Internals forum][rif], a place to ask questions and
222+
discuss Rust's internals
223+
* The [generated documentation for rust's compiler][gdfrustc]
224+
* The [rust referance][rr], even though it doesn't specifically talk about Rust's internals, its a great reasource nontheless
225+
* Although out of date, [Tom Lee's great blog article][tlgba] is very helpful
226+
* [rustaceans.org][ro] is helpful, but mostly dedicated to IRC
227+
* The [Rust Compiler Testing Docs][rctd]
228+
* For @bors, [this cheetsheat][cheetsheat] is helpful (Remember to replace `@homu` with `@bors` in the commands that you use.)
229+
* **Google**!
230+
* Don't be afraid to ask! The Rust community is friendly and helpful.
231+
232+
[gdfrustc]: http://manishearth.github.io/rust-internals-docs/rustc/
233+
[rif]: http://internals.rust-lang.org
234+
[rr]: https://doc.rust-lang.org/book/README.html
235+
[tlgba]: http://tomlee.co/2014/04/03/a-more-detailed-tour-of-the-rust-compiler/
236+
[ro]: http://www.rustaceans.org/
237+
[rctd]: ./COMPILER_TESTS.md
238+
[cheetsheat]: http://buildbot.rust-lang.org/homu/

branches/beta/src/doc/nomicon/destructors.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ impl<T> Drop for Box<T> {
5252
```
5353

5454
and this works fine because when Rust goes to drop the `ptr` field it just sees
55-
a [Unique][] that has no actual `Drop` implementation. Similarly nothing can
55+
a [Unique] that has no actual `Drop` implementation. Similarly nothing can
5656
use-after-free the `ptr` because when drop exits, it becomes inacessible.
5757

5858
However this wouldn't work:

branches/beta/src/doc/nomicon/meet-safe-and-unsafe.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -60,8 +60,8 @@ Unlike C, Undefined Behaviour is pretty limited in scope in Rust. All the core
6060
language cares about is preventing the following things:
6161

6262
* Dereferencing null or dangling pointers
63-
* Reading [uninitialized memory][]
64-
* Breaking the [pointer aliasing rules][]
63+
* Reading [uninitialized memory]
64+
* Breaking the [pointer aliasing rules]
6565
* Producing invalid primitive values:
6666
* dangling/null references
6767
* a `bool` that isn't 0 or 1

branches/beta/src/doc/nomicon/other-reprs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ still consumes a byte of space.
2626
* DSTs, tuples, and tagged unions are not a concept in C and as such are never
2727
FFI safe.
2828

29-
* **If the type would have any [drop flags][], they will still be added**
29+
* **If the type would have any [drop flags], they will still be added**
3030

3131
* This is equivalent to one of `repr(u*)` (see the next section) for enums. The
3232
chosen size is the default enum size for the target platform's C ABI. Note that

branches/beta/src/doc/nomicon/safe-unsafe-meaning.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ unchecked contracts:
3535

3636
There is also `#[unsafe_no_drop_flag]`, which is a special case that exists for
3737
historical reasons and is in the process of being phased out. See the section on
38-
[drop flags][] for details.
38+
[drop flags] for details.
3939

4040
Some examples of unsafe functions:
4141

@@ -44,7 +44,7 @@ Some examples of unsafe functions:
4444
* `ptr::offset` is an intrinsic that invokes Undefined Behaviour if it is
4545
not "in bounds" as defined by LLVM.
4646
* `mem::transmute` reinterprets some value as having the given type,
47-
bypassing type safety in arbitrary ways. (see [conversions][] for details)
47+
bypassing type safety in arbitrary ways. (see [conversions] for details)
4848
* All FFI functions are `unsafe` because they can do arbitrary things.
4949
C being an obvious culprit, but generally any language can do something
5050
that Rust isn't happy about.

branches/beta/src/doc/nomicon/send-and-sync.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ captures this through the `Send` and `Sync` traits.
1010

1111
Send and Sync are fundamental to Rust's concurrency story. As such, a
1212
substantial amount of special tooling exists to make them work right. First and
13-
foremost, they're [unsafe traits][]. This means that they are unsafe to
13+
foremost, they're [unsafe traits]. This means that they are unsafe to
1414
implement, and other unsafe code can assume that they are correctly
1515
implemented. Since they're *marker traits* (they have no associated items like
1616
methods), correctly implemented simply means that they have the intrinsic

branches/beta/src/doc/nomicon/transmutes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ same size. The ways to cause Undefined Behaviour with this are mind boggling.
2121
* No you can't do it
2222
* No you're not special
2323
* Transmuting to a reference without an explicitly provided lifetime
24-
produces an [unbounded lifetime][]
24+
produces an [unbounded lifetime]
2525

2626
`mem::transmute_copy<T, U>` somehow manages to be *even more* wildly unsafe than
2727
this. It copies `size_of<U>` bytes out of an `&T` and interprets them as a `U`.

branches/beta/src/doc/trpl/advanced-linking.md

Lines changed: 14 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -80,33 +80,30 @@ $ mkdir musldist
8080
$ PREFIX=$(pwd)/musldist
8181
$
8282
$ # Build musl
83-
$ wget http://www.musl-libc.org/releases/musl-1.1.10.tar.gz
84-
[...]
83+
$ curl -O http://www.musl-libc.org/releases/musl-1.1.10.tar.gz
8584
$ tar xf musl-1.1.10.tar.gz
8685
$ cd musl-1.1.10/
8786
musl-1.1.10 $ ./configure --disable-shared --prefix=$PREFIX
88-
[...]
8987
musl-1.1.10 $ make
90-
[...]
9188
musl-1.1.10 $ make install
92-
[...]
9389
musl-1.1.10 $ cd ..
9490
$ du -h musldist/lib/libc.a
9591
2.2M musldist/lib/libc.a
9692
$
9793
$ # Build libunwind.a
98-
$ wget http://llvm.org/releases/3.6.1/llvm-3.6.1.src.tar.xz
99-
$ tar xf llvm-3.6.1.src.tar.xz
100-
$ cd llvm-3.6.1.src/projects/
101-
llvm-3.6.1.src/projects $ svn co http://llvm.org/svn/llvm-project/libcxxabi/trunk/ libcxxabi
102-
llvm-3.6.1.src/projects $ svn co http://llvm.org/svn/llvm-project/libunwind/trunk/ libunwind
103-
llvm-3.6.1.src/projects $ sed -i 's#^\(include_directories\).*$#\0\n\1(../libcxxabi/include)#' libunwind/CMakeLists.txt
104-
llvm-3.6.1.src/projects $ mkdir libunwind/build
105-
llvm-3.6.1.src/projects $ cd libunwind/build
106-
llvm-3.6.1.src/projects/libunwind/build $ cmake -DLLVM_PATH=../../.. -DLIBUNWIND_ENABLE_SHARED=0 ..
107-
llvm-3.6.1.src/projects/libunwind/build $ make
108-
llvm-3.6.1.src/projects/libunwind/build $ cp lib/libunwind.a $PREFIX/lib/
109-
llvm-3.6.1.src/projects/libunwind/build $ cd cd ../../../../
94+
$ curl -O http://llvm.org/releases/3.7.0/llvm-3.7.0.src.tar.xz
95+
$ tar xf llvm-3.7.0.src.tar.xz
96+
$ cd llvm-3.7.0.src/projects/
97+
llvm-3.7.0.src/projects $ curl http://llvm.org/releases/3.7.0/libcxxabi-3.7.0.src.tar.xz | tar xJf -
98+
llvm-3.7.0.src/projects $ mv libcxxabi-3.7.0.src libcxxabi
99+
llvm-3.7.0.src/projects $ curl http://llvm.org/releases/3.7.0/libunwind-3.7.0.src.tar.xz | tar xJf -
100+
llvm-3.7.0.src/projects $ mv libunwind-3.7.0.src libunwind
101+
llvm-3.7.0.src/projects $ mkdir libunwind/build
102+
llvm-3.7.0.src/projects $ cd libunwind/build
103+
llvm-3.7.0.src/projects/libunwind/build $ cmake -DLLVM_PATH=../../.. -DLIBUNWIND_ENABLE_SHARED=0 ..
104+
llvm-3.7.0.src/projects/libunwind/build $ make
105+
llvm-3.7.0.src/projects/libunwind/build $ cp lib/libunwind.a $PREFIX/lib/
106+
llvm-3.7.0.src/projects/libunwind/build $ cd ../../../../
110107
$ du -h musldist/lib/libunwind.a
111108
164K musldist/lib/libunwind.a
112109
$

0 commit comments

Comments
 (0)