Skip to content

Commit 5558ccb

Browse files
committed
---
yaml --- r: 125945 b: refs/heads/try c: 28d543a h: refs/heads/master i: 125943: af607ec v: v3
1 parent 7512c63 commit 5558ccb

File tree

4 files changed

+11
-47
lines changed

4 files changed

+11
-47
lines changed

[refs]

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
refs/heads/master: f2fa55903e378368ed9173560f03a0ef16e371c2
33
refs/heads/snap-stage1: e33de59e47c5076a89eadeb38f4934f58a3618a6
44
refs/heads/snap-stage3: 9fc8394d3bce22ab483f98842434c84c396212ae
5-
refs/heads/try: e0d10bb69ab04ab041b39c71f7537d8c63ef9669
5+
refs/heads/try: 28d543a40ffa872622025bcb4f112c890ca59760
66
refs/tags/release-0.1: 1f5c5126e96c79d22cb7862f75304136e204f105
77
refs/heads/ndm: f3868061cd7988080c30d6d5bf352a5a5fe2460b
88
refs/heads/try2: 147ecfdd8221e4a4d4e090486829a06da1e0ca3c
Lines changed: 6 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,7 @@
11
Rust's lexical grammar is not context-free. Raw string literals are the source
22
of the problem. Informally, a raw string literal is an `r`, followed by `N`
33
hashes (where N can be zero), a quote, any characters, then a quote followed
4-
by `N` hashes. Critically, once inside the first pair of quotes,
5-
another quote cannot be followed by `N` consecutive hashes. e.g.
6-
`r###""###"###` is invalid.
7-
8-
This grammar describes this as best possible:
4+
by `N` hashes. This grammar describes this as best possible:
95

106
R -> 'r' S
117
S -> '"' B '"'
@@ -26,39 +22,8 @@ accepted as one by the above grammar, using the derivation:
2622
(Where `T : U` means the rule `T` is applied, and `U` is the remainder of the
2723
string.) The difficulty arises from the fact that it is fundamentally
2824
context-sensitive. In particular, the context needed is the number of hashes.
29-
30-
To prove that Rust's string literals are not context-free, we will use
31-
the fact that context-free languages are closed under intersection with
32-
regular languages, and the
33-
[pumping lemma for context-free languages](https://en.wikipedia.org/wiki/Pumping_lemma_for_context-free_languages).
34-
35-
Consider the regular language `R = r#+""#*"#+`. If Rust's raw string literals are
36-
context-free, then their intersection with `R`, `R'`, should also be context-free.
37-
Therefore, to prove that raw string literals are not context-free,
38-
it is sufficient to prove that `R'` is not context-free.
39-
40-
The language `R'` is `{r#^n""#^m"#^n | m < n}`.
41-
42-
Assume `R'` *is* context-free. Then `R'` has some pumping length `p > 0` for which
43-
the pumping lemma applies. Consider the following string `s` in `R'`:
44-
45-
`r#^p""#^{p-1}"#^p`
46-
47-
e.g. for `p = 2`: `s = r##""#"##`
48-
49-
Then `s = uvwxy` for some choice of `uvwxy` such that `vx` is non-empty,
50-
`|vwx| < p+1`, and `uv^iwx^iy` is in `R'` for all `i >= 0`.
51-
52-
Neither `v` nor `x` can contain a `"` or `r`, as the number of these characters
53-
in any string in `R'` is fixed. So `v` and `x` contain only hashes.
54-
Consequently, of the three sequences of hashes, `v` and `x` combined
55-
can only pump two of them.
56-
If we ever choose the central sequence of hashes, then one of the outer sequences
57-
will not grow when we pump, leading to an imbalance between the outer sequences.
58-
Therefore, we must pump both outer sequences of hashes. However,
59-
there are `p+2` characters between these two sequences of hashes, and `|vwx|` must
60-
be less than `p+1`. Therefore we have a contradiction, and `R'` must not be
61-
context-free.
62-
63-
Since `R'` is not context-free, it follows that the Rust's raw string literals
64-
must not be context-free.
25+
I know of no way to resolve this, but also have not come up with a proof that
26+
it is not context sensitive. Such a proof would probably use the pumping lemma
27+
for context-free languages, but I (cmr) could not come up with a proof after
28+
spending a few hours on it, and decided my time best spent elsewhere. Pull
29+
request welcome!

branches/try/src/librustdoc/html/render.rs

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -845,12 +845,8 @@ impl DocFolder for Cache {
845845
}
846846
_ => (None, Some(self.stack.as_slice()))
847847
};
848-
let hidden_field = match item.inner {
849-
clean::StructFieldItem(clean::HiddenStructField) => true,
850-
_ => false
851-
};
852848
match parent {
853-
(parent, Some(path)) if !self.privmod && !hidden_field => {
849+
(parent, Some(path)) if !self.privmod => {
854850
self.search_index.push(IndexItem {
855851
ty: shortty(&item),
856852
name: s.to_string(),

branches/try/src/libstd/collections/hashmap.rs

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1850,6 +1850,7 @@ impl<T: Hash + Eq> HashSet<T, RandomSipHasher> {
18501850
///
18511851
/// # Example
18521852
///
1853+
/// ```
18531854
/// use std::collections::HashSet;
18541855
/// let mut set: HashSet<int> = HashSet::new();
18551856
/// ```
@@ -1863,6 +1864,7 @@ impl<T: Hash + Eq> HashSet<T, RandomSipHasher> {
18631864
///
18641865
/// # Example
18651866
///
1867+
/// ```
18661868
/// use std::collections::HashSet;
18671869
/// let mut set: HashSet<int> = HashSet::with_capacity(10);
18681870
/// ```
@@ -1920,6 +1922,7 @@ impl<T: Eq + Hash<S>, S, H: Hasher<S>> HashSet<T, H> {
19201922
///
19211923
/// # Example
19221924
///
1925+
/// ```
19231926
/// use std::collections::HashSet;
19241927
/// let mut set: HashSet<int> = HashSet::new();
19251928
/// set.reserve(10);

0 commit comments

Comments
 (0)