Skip to content

Commit 742191a

Browse files
committed
---
yaml --- r: 95262 b: refs/heads/dist-snap c: bed669c h: refs/heads/master v: v3
1 parent 68faa44 commit 742191a

File tree

103 files changed

+2096
-2364
lines changed

Some content is hidden

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

103 files changed

+2096
-2364
lines changed

[refs]

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ refs/heads/try: c274a6888410ce3e357e014568b43310ed787d36
66
refs/tags/release-0.1: 1f5c5126e96c79d22cb7862f75304136e204f105
77
refs/heads/ndm: f3868061cd7988080c30d6d5bf352a5a5fe2460b
88
refs/heads/try2: 147ecfdd8221e4a4d4e090486829a06da1e0ca3c
9-
refs/heads/dist-snap: e293026e9c41a5322d95098c30e193fdb815c1bb
9+
refs/heads/dist-snap: bed669cba6c20e3bdbe01e87ce4566b60d7bc232
1010
refs/tags/release-0.2: c870d2dffb391e14efb05aa27898f1f6333a9596
1111
refs/tags/release-0.3: b5f0d0f648d9a6153664837026ba1be43d3e2503
1212
refs/heads/try3: 9387340aab40a73e8424c48fd42f0c521a4875c0

branches/dist-snap/doc/rust.md

Lines changed: 4 additions & 197 deletions
Original file line numberDiff line numberDiff line change
@@ -239,14 +239,13 @@ literal : string_lit | char_lit | num_lit ;
239239

240240
~~~~~~~~ {.ebnf .gram}
241241
char_lit : '\x27' char_body '\x27' ;
242-
string_lit : '"' string_body * '"' | 'r' raw_string ;
242+
string_lit : '"' string_body * '"' ;
243243
244244
char_body : non_single_quote
245245
| '\x5c' [ '\x27' | common_escape ] ;
246246
247247
string_body : non_double_quote
248248
| '\x5c' [ '\x22' | common_escape ] ;
249-
raw_string : '"' raw_string_body '"' | '#' raw_string '#' ;
250249
251250
common_escape : '\x5c'
252251
| 'n' | 'r' | 't' | '0'
@@ -268,10 +267,9 @@ which must be _escaped_ by a preceding U+005C character (`\`).
268267

269268
A _string literal_ is a sequence of any Unicode characters enclosed within
270269
two `U+0022` (double-quote) characters, with the exception of `U+0022`
271-
itself, which must be _escaped_ by a preceding `U+005C` character (`\`),
272-
or a _raw string literal_.
270+
itself, which must be _escaped_ by a preceding `U+005C` character (`\`).
273271

274-
Some additional _escapes_ are available in either character or non-raw string
272+
Some additional _escapes_ are available in either character or string
275273
literals. An escape starts with a `U+005C` (`\`) and continues with one of
276274
the following forms:
277275

@@ -287,35 +285,9 @@ the following forms:
287285
* A _whitespace escape_ is one of the characters `U+006E` (`n`), `U+0072`
288286
(`r`), or `U+0074` (`t`), denoting the unicode values `U+000A` (LF),
289287
`U+000D` (CR) or `U+0009` (HT) respectively.
290-
* The _backslash escape_ is the character `U+005C` (`\`) which must be
288+
* The _backslash escape_ is the character U+005C (`\`) which must be
291289
escaped in order to denote *itself*.
292290

293-
Raw string literals do not process any escapes. They start with the character
294-
`U+0072` (`r`), followed zero or more of the character `U+0023` (`#`) and a
295-
`U+0022` (double-quote) character. The _raw string body_ is not defined in the
296-
EBNF grammar above: it can contain any sequence of Unicode characters and is
297-
terminated only by another `U+0022` (double-quote) character, followed by the
298-
same number of `U+0023` (`#`) characters that preceeded the opening `U+0022`
299-
(double-quote) character.
300-
301-
All Unicode characters contained in the raw string body represent themselves,
302-
the characters `U+0022` (double-quote) (except when followed by at least as
303-
many `U+0023` (`#`) characters as were used to start the raw string literal) or
304-
`U+005C` (`\`) do not have any special meaning.
305-
306-
Examples for string literals:
307-
308-
~~~
309-
"foo"; r"foo"; // foo
310-
"\"foo\""; r#""foo""#; // "foo"
311-
312-
"foo #\"# bar";
313-
r##"foo #"# bar"##; // foo #"# bar
314-
315-
"\x52"; "R"; r"R"; // R
316-
"\\x52"; r"\x52"; // \x52
317-
~~~
318-
319291
#### Number literals
320292

321293
~~~~~~~~ {.ebnf .gram}
@@ -1529,171 +1501,6 @@ is `extern "abi" fn(A1, ..., An) -> R`,
15291501
where `A1...An` are the declared types of its arguments
15301502
and `R` is the decalred return type.
15311503

1532-
## Visibility and Privacy
1533-
1534-
These two terms are often used interchangeably, and what they are attempting to
1535-
convey is the answer to the question "Can this item be used at this location?"
1536-
1537-
Rust's name resolution operates on a global hierarchy of namespaces. Each level
1538-
in the hierarchy can be thought of as some item. The items are one of those
1539-
mentioned above, but also include external crates. Declaring or defining a new
1540-
module can be thought of as inserting a new tree into the hierarchy at the
1541-
location of the definition.
1542-
1543-
To control whether interfaces can be used across modules, Rust checks each use
1544-
of an item to see whether it should be allowed or not. This is where privacy
1545-
warnings are generated, or otherwise "you used a private item of another module
1546-
and weren't allowed to."
1547-
1548-
By default, everything in rust is *private*, with two exceptions. The first
1549-
exception is that struct fields are public by default (but the struct itself is
1550-
still private by default), and the remaining exception is that enum variants in
1551-
a `pub` enum are the default visibility of the enum container itself.. You are
1552-
allowed to alter this default visibility with the `pub` keyword (or `priv`
1553-
keyword for struct fields and enum variants). When an item is declared as `pub`,
1554-
it can be thought of as being accessible to the outside world. For example:
1555-
1556-
~~~
1557-
// Declare a private struct
1558-
struct Foo;
1559-
1560-
// Declare a public struct with a private field
1561-
pub struct Bar {
1562-
priv field: int
1563-
}
1564-
1565-
// Declare a public enum with public and private variants
1566-
pub enum State {
1567-
PubliclyAccessibleState,
1568-
priv PrivatelyAccessibleState
1569-
}
1570-
~~~
1571-
1572-
With the notion of an item being either public or private, Rust allows item
1573-
accesses in two cases:
1574-
1575-
1. If an item is public, then it can be used externally through any of its
1576-
public ancestors.
1577-
2. If an item is private, it may be accessed by the current module and its
1578-
descendants.
1579-
1580-
These two cases are surprisingly powerful for creating module hierarchies
1581-
exposing public APIs while hiding internal implementation details. To help
1582-
explain, here's a few use cases and what they would entail.
1583-
1584-
* A library developer needs to expose functionality to crates which link against
1585-
their library. As a consequence of the first case, this means that anything
1586-
which is usable externally must be `pub` from the root down to the destination
1587-
item. Any private item in the chain will disallow external accesses.
1588-
1589-
* A crate needs a global available "helper module" to itself, but it doesn't
1590-
want to expose the helper module as a public API. To accomplish this, the root
1591-
of the crate's hierarchy would have a private module which then internally has
1592-
a "public api". Because the entire crate is an ancestor of the root, then the
1593-
entire local crate can access this private module through the second case.
1594-
1595-
* When writing unit tests for a module, it's often a common idiom to have an
1596-
immediate child of the module to-be-tested named `mod test`. This module could
1597-
access any items of the parent module through the second case, meaning that
1598-
internal implementation details could also be seamlessly tested from the child
1599-
module.
1600-
1601-
In the second case, it mentions that a private item "can be accessed" by the
1602-
current module and its descendants, but the exact meaning of accessing an item
1603-
depends on what the item is. Accessing a module, for example, would mean looking
1604-
inside of it (to import more items). On the other hand, accessing a function
1605-
would mean that it is invoked.
1606-
1607-
Here's an example of a program which exemplifies the three cases outlined above.
1608-
1609-
~~~
1610-
// This module is private, meaning that no external crate can access this
1611-
// module. Because it is private at the root of this current crate, however, any
1612-
// module in the crate may access any publicly visible item in this module.
1613-
mod crate_helper_module {
1614-
1615-
// This function can be used by anything in the current crate
1616-
pub fn crate_helper() {}
1617-
1618-
// This function *cannot* be used by anything else in the crate. It is not
1619-
// publicly visible outside of the `crate_helper_module`, so only this
1620-
// current module and its descendants may access it.
1621-
fn implementation_detail() {}
1622-
}
1623-
1624-
// This function is "public to the root" meaning that it's available to external
1625-
// crates linking against this one.
1626-
pub fn public_api() {}
1627-
1628-
// Similarly to 'public_api', this module is public so external crates may look
1629-
// inside of it.
1630-
pub mod submodule {
1631-
use crate_helper_module;
1632-
1633-
pub fn my_method() {
1634-
// Any item in the local crate may invoke the helper module's public
1635-
// interface through a combination of the two rules above.
1636-
crate_helper_module::crate_helper();
1637-
}
1638-
1639-
// This function is hidden to any module which is not a descendant of
1640-
// `submodule`
1641-
fn my_implementation() {}
1642-
1643-
#[cfg(test)]
1644-
mod test {
1645-
1646-
#[test]
1647-
fn test_my_implementation() {
1648-
// Because this module is a descendant of `submodule`, it's allowed
1649-
// to access private items inside of `submodule` without a privacy
1650-
// violation.
1651-
super::my_implementation();
1652-
}
1653-
}
1654-
}
1655-
1656-
# fn main() {}
1657-
~~~
1658-
1659-
For a rust program to pass the privacy checking pass, all paths must be valid
1660-
accesses given the two rules above. This includes all use statements,
1661-
expressions, types, etc.
1662-
1663-
### Re-exporting and Visibility
1664-
1665-
Rust allows publicly re-exporting items through a `pub use` directive. Because
1666-
this is a public directive, this allows the item to be used in the current
1667-
module through the rules above. It essentially allows public access into the
1668-
re-exported item. For example, this program is valid:
1669-
1670-
~~~
1671-
pub use api = self::implementation;
1672-
1673-
mod implementation {
1674-
pub fn f() {}
1675-
}
1676-
1677-
# fn main() {}
1678-
~~~
1679-
1680-
This means that any external crate referencing `implementation::f` would receive
1681-
a privacy violation, while the path `api::f` would be allowed.
1682-
1683-
When re-exporting a private item, it can be thought of as allowing the "privacy
1684-
chain" being short-circuited through the reexport instead of passing through the
1685-
namespace hierarchy as it normally would.
1686-
1687-
### Glob imports and Visibility
1688-
1689-
Currently glob imports are considered an "experimental" language feature. For
1690-
sanity purpose along with helping the implementation, glob imports will only
1691-
import public items from their destination, not private items.
1692-
1693-
> **Note:** This is subject to change, glob exports may be removed entirely or
1694-
> they could possibly import private items for a privacy error to later be
1695-
> issued if the item is used.
1696-
16971504
## Attributes
16981505

16991506
~~~~~~~~{.ebnf .gram}

branches/dist-snap/doc/tutorial.md

Lines changed: 13 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -353,12 +353,7 @@ whose literals are written between single quotes, as in `'x'`.
353353
Just like C, Rust understands a number of character escapes, using the backslash
354354
character, such as `\n`, `\r`, and `\t`. String literals,
355355
written between double quotes, allow the same escape sequences.
356-
357-
On the other hand, raw string literals do not process any escape sequences.
358-
They are written as `r##"blah"##`, with a matching number of zero or more `#`
359-
before the opening and after the closing quote, and can contain any sequence of
360-
characters except their closing delimiter. More on strings
361-
[later](#vectors-and-strings).
356+
More on strings [later](#vectors-and-strings).
362357

363358
The nil type, written `()`, has a single value, also written `()`.
364359

@@ -2327,18 +2322,19 @@ fn main() {
23272322

23282323
The `::farm::chicken` construct is what we call a 'path'.
23292324

2330-
Because it's starting with a `::`, it's also a 'global path', which qualifies
2331-
an item by its full path in the module hierarchy relative to the crate root.
2325+
Because it's starting with a `::`, it's also a 'global path',
2326+
which qualifies an item by its full path in the module hierarchy
2327+
relative to the crate root.
23322328

2333-
If the path were to start with a regular identifier, like `farm::chicken`, it
2334-
would be a 'local path' instead. We'll get to them later.
2329+
If the path were to start with a regular identifier, like `farm::chicken`, it would be
2330+
a 'local path' instead. We'll get to them later.
23352331

2336-
Now, if you actually tried to compile this code example, you'll notice that you
2337-
get a `function 'chicken' is private` error. That's because by default, items
2338-
(`fn`, `struct`, `static`, `mod`, ...) are private.
2332+
Now, if you actually tried to compile this code example, you'll notice
2333+
that you get a `unresolved name: 'farm::chicken'` error. That's because per default,
2334+
items (`fn`, `struct`, `static`, `mod`, ...) are only visible inside the module
2335+
they are defined in.
23392336

2340-
To make them visible outside their containing modules, you need to mark them
2341-
_public_ with `pub`:
2337+
To make them visible outside their containing modules, you need to mark them _public_ with `pub`:
23422338

23432339
~~~~
23442340
mod farm {
@@ -2360,8 +2356,7 @@ Rust doesn't support encapsulation: both struct fields and methods can
23602356
be private. But this encapsulation is at the module level, not the
23612357
struct level.
23622358

2363-
For convenience, fields are _public_ by default, and can be made _private_ with
2364-
the `priv` keyword:
2359+
For convenience, fields are _public_ by default, and can be made _private_ with the `priv` keyword:
23652360

23662361
~~~
23672362
mod farm {
@@ -2398,8 +2393,7 @@ fn main() {
23982393
# fn make_me_a_chicken() -> farm::Chicken { 0 }
23992394
~~~
24002395

2401-
Exact details and specifications about visibility rules can be found in the Rust
2402-
manual.
2396+
> ***Note:*** Visibility rules are currently buggy and not fully defined, you might have to add or remove `pub` along a path until it works.
24032397
24042398
## Files and modules
24052399

branches/dist-snap/src/etc/vim/syntax/rust.vim

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -148,7 +148,6 @@ syn match rustFormat display "%%" contained
148148
syn match rustSpecial display contained /\\\([nrt\\'"]\|x\x\{2}\|u\x\{4}\|U\x\{8}\)/
149149
syn match rustStringContinuation display contained /\\\n\s*/
150150
syn region rustString start=+"+ skip=+\\\\\|\\"+ end=+"+ contains=rustTodo,rustFormat,rustSpecial,rustStringContinuation
151-
syn region rustString start='r\z(#*\)"' end='"\z1'
152151

153152
syn region rustAttribute start="#\[" end="\]" contains=rustString,rustDeriving
154153
syn region rustDeriving start="deriving(" end=")" contained contains=rustTrait

branches/dist-snap/src/libextra/container.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ pub trait Deque<T> : Mutable {
4040
}
4141

4242
#[cfg(test)]
43-
pub mod bench {
43+
mod bench {
4444
use std::container::MutableMap;
4545
use std::{vec, rand};
4646
use std::rand::Rng;

branches/dist-snap/src/libextra/crypto/cryptoutil.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -346,7 +346,7 @@ impl <T: FixedBuffer> StandardPadding for T {
346346

347347

348348
#[cfg(test)]
349-
pub mod test {
349+
mod test {
350350
use std::rand::{IsaacRng, Rng};
351351
use std::vec;
352352

branches/dist-snap/src/libextra/stats.rs

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -101,8 +101,7 @@ pub trait Stats {
101101

102102
/// Extracted collection of all the summary statistics of a sample set.
103103
#[deriving(Clone, Eq)]
104-
#[allow(missing_doc)]
105-
pub struct Summary {
104+
struct Summary {
106105
sum: f64,
107106
min: f64,
108107
max: f64,

branches/dist-snap/src/librustc/driver/driver.rs

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -199,6 +199,7 @@ pub fn phase_2_configure_and_expand(sess: Session,
199199

200200
pub struct CrateAnalysis {
201201
exp_map2: middle::resolve::ExportMap2,
202+
exported_items: @middle::privacy::ExportedItems,
202203
ty_cx: ty::ctxt,
203204
maps: astencode::Maps,
204205
reachable: @mut HashSet<ast::NodeId>
@@ -228,9 +229,7 @@ pub fn phase_3_run_analysis_passes(sess: Session,
228229
let middle::resolve::CrateMap {
229230
def_map: def_map,
230231
exp_map2: exp_map2,
231-
trait_map: trait_map,
232-
external_exports: external_exports,
233-
last_private_map: last_private_map
232+
trait_map: trait_map
234233
} =
235234
time(time_passes, "resolution", (), |_|
236235
middle::resolve::resolve_crate(sess, lang_items, crate));
@@ -262,10 +261,9 @@ pub fn phase_3_run_analysis_passes(sess: Session,
262261
middle::check_const::check_crate(sess, crate, ast_map, def_map,
263262
method_map, ty_cx));
264263

265-
let maps = (external_exports, last_private_map);
266-
time(time_passes, "privacy checking", maps, |(a, b)|
267-
middle::privacy::check_crate(ty_cx, &method_map, &exp_map2,
268-
a, b, crate));
264+
let exported_items =
265+
time(time_passes, "privacy checking", (), |_|
266+
middle::privacy::check_crate(ty_cx, &method_map, &exp_map2, crate));
269267

270268
time(time_passes, "effect checking", (), |_|
271269
middle::effect::check_crate(ty_cx, method_map, crate));
@@ -307,6 +305,7 @@ pub fn phase_3_run_analysis_passes(sess: Session,
307305

308306
CrateAnalysis {
309307
exp_map2: exp_map2,
308+
exported_items: @exported_items,
310309
ty_cx: ty_cx,
311310
maps: astencode::Maps {
312311
root_map: root_map,

branches/dist-snap/src/librustc/front/test.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -407,7 +407,7 @@ fn mk_test_desc_and_fn_rec(cx: &TestCtxt, test: &Test) -> @ast::Expr {
407407
debug2!("encoding {}", ast_util::path_name_i(path));
408408

409409
let name_lit: ast::lit =
410-
nospan(ast::lit_str(ast_util::path_name_i(path).to_managed(), ast::CookedStr));
410+
nospan(ast::lit_str(ast_util::path_name_i(path).to_managed()));
411411

412412
let name_expr = @ast::Expr {
413413
id: ast::DUMMY_NODE_ID,

0 commit comments

Comments
 (0)