Skip to content

Commit 162304c

Browse files
committed
---
yaml --- r: 235259 b: refs/heads/stable c: bd1033d h: refs/heads/master i: 235257: 276f26a 235255: fe59a62 v: v3
1 parent 2d5a06d commit 162304c

File tree

5 files changed

+53
-15
lines changed

5 files changed

+53
-15
lines changed

[refs]

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ refs/heads/tmp: afae2ff723393b3ab4ccffef6ac7c6d1809e2da0
2929
refs/tags/1.0.0-alpha.2: 4c705f6bc559886632d3871b04f58aab093bfa2f
3030
refs/tags/homu-tmp: f859507de8c410b648d934d8f5ec1c52daac971d
3131
refs/tags/1.0.0-beta: 8cbb92b53468ee2b0c2d3eeb8567005953d40828
32-
refs/heads/stable: 80f269259c734d25bb4e9586d1cbde8638dcda26
32+
refs/heads/stable: bd1033d738430af0a2c59f226770bdead711d85e
3333
refs/tags/1.0.0: 55bd4f8ff2b323f317ae89e254ce87162d52a375
3434
refs/tags/1.1.0: bc3c16f09287e5545c1d3f76b7abd54f2eca868b
3535
refs/tags/1.2.0: f557861f822c34f07270347b94b5280de20a597e

branches/stable/src/doc/complement-design-faq.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ Second, it makes cost explicit. In general, the only safe way to have a
9999
non-exhaustive match would be to panic the thread if nothing is matched, though
100100
it could fall through if the type of the `match` expression is `()`. This sort
101101
of hidden cost and special casing is against the language's philosophy. It's
102-
easy to ignore certain cases by using the `_` wildcard:
102+
easy to ignore all unspecified cases by using the `_` wildcard:
103103

104104
```rust,ignore
105105
match val.do_something() {

branches/stable/src/libcore/fmt/mod.rs

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -273,6 +273,8 @@ impl<'a> Display for Arguments<'a> {
273273
///
274274
/// Generally speaking, you should just `derive` a `Debug` implementation.
275275
///
276+
/// When used with the alternate format specifier `#?`, the output is pretty-printed.
277+
///
276278
/// For more information on formatters, see [the module-level documentation][module].
277279
///
278280
/// [module]: ../index.html
@@ -314,13 +316,42 @@ impl<'a> Display for Arguments<'a> {
314316
/// println!("The origin is: {:?}", origin);
315317
/// ```
316318
///
319+
/// This outputs:
320+
///
321+
/// ```text
322+
/// The origin is: Point { x: 0, y: 0 }
323+
/// ```
324+
///
317325
/// There are a number of `debug_*` methods on `Formatter` to help you with manual
318326
/// implementations, such as [`debug_struct`][debug_struct].
319327
///
320328
/// `Debug` implementations using either `derive` or the debug builder API
321329
/// on `Formatter` support pretty printing using the alternate flag: `{:#?}`.
322330
///
323331
/// [debug_struct]: ../std/fmt/struct.Formatter.html#method.debug_struct
332+
///
333+
/// Pretty printing with `#?`:
334+
///
335+
/// ```
336+
/// #[derive(Debug)]
337+
/// struct Point {
338+
/// x: i32,
339+
/// y: i32,
340+
/// }
341+
///
342+
/// let origin = Point { x: 0, y: 0 };
343+
///
344+
/// println!("The origin is: {:#?}", origin);
345+
/// ```
346+
///
347+
/// This outputs:
348+
///
349+
/// ```text
350+
/// The origin is: Point {
351+
/// x: 0,
352+
/// y: 0
353+
/// }
354+
/// ```
324355
#[stable(feature = "rust1", since = "1.0.0")]
325356
#[rustc_on_unimplemented = "`{Self}` cannot be formatted using `:?`; if it is \
326357
defined in your crate, add `#[derive(Debug)]` or \
@@ -379,6 +410,8 @@ pub trait Display {
379410
///
380411
/// The `Octal` trait should format its output as a number in base-8.
381412
///
413+
/// The alternate flag, `#`, adds a `0o` in front of the output.
414+
///
382415
/// For more information on formatters, see [the module-level documentation][module].
383416
///
384417
/// [module]: ../index.html
@@ -391,6 +424,7 @@ pub trait Display {
391424
/// let x = 42; // 42 is '52' in octal
392425
///
393426
/// assert_eq!(format!("{:o}", x), "52");
427+
/// assert_eq!(format!("{:#o}", x), "0o52");
394428
/// ```
395429
///
396430
/// Implementing `Octal` on a type:
@@ -423,6 +457,8 @@ pub trait Octal {
423457
///
424458
/// The `Binary` trait should format its output as a number in binary.
425459
///
460+
/// The alternate flag, `#`, adds a `0b` in front of the output.
461+
///
426462
/// For more information on formatters, see [the module-level documentation][module].
427463
///
428464
/// [module]: ../index.html
@@ -435,6 +471,7 @@ pub trait Octal {
435471
/// let x = 42; // 42 is '101010' in binary
436472
///
437473
/// assert_eq!(format!("{:b}", x), "101010");
474+
/// assert_eq!(format!("{:#b}", x), "0b101010");
438475
/// ```
439476
///
440477
/// Implementing `Binary` on a type:
@@ -468,6 +505,8 @@ pub trait Binary {
468505
/// The `LowerHex` trait should format its output as a number in hexidecimal, with `a` through `f`
469506
/// in lower case.
470507
///
508+
/// The alternate flag, `#`, adds a `0x` in front of the output.
509+
///
471510
/// For more information on formatters, see [the module-level documentation][module].
472511
///
473512
/// [module]: ../index.html
@@ -480,6 +519,7 @@ pub trait Binary {
480519
/// let x = 42; // 42 is '2a' in hex
481520
///
482521
/// assert_eq!(format!("{:x}", x), "2a");
522+
/// assert_eq!(format!("{:#x}", x), "0x2a");
483523
/// ```
484524
///
485525
/// Implementing `LowerHex` on a type:
@@ -513,6 +553,8 @@ pub trait LowerHex {
513553
/// The `UpperHex` trait should format its output as a number in hexidecimal, with `A` through `F`
514554
/// in upper case.
515555
///
556+
/// The alternate flag, `#`, adds a `0x` in front of the output.
557+
///
516558
/// For more information on formatters, see [the module-level documentation][module].
517559
///
518560
/// [module]: ../index.html
@@ -525,6 +567,7 @@ pub trait LowerHex {
525567
/// let x = 42; // 42 is '2A' in hex
526568
///
527569
/// assert_eq!(format!("{:X}", x), "2A");
570+
/// assert_eq!(format!("{:#X}", x), "0x2A");
528571
/// ```
529572
///
530573
/// Implementing `UpperHex` on a type:

branches/stable/src/librustc_resolve/lib.rs

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1844,11 +1844,6 @@ impl<'a, 'tcx> Resolver<'a, 'tcx> {
18441844
visit::walk_ty_param_bounds_helper(this, bounds);
18451845

18461846
for trait_item in trait_items {
1847-
// Create a new rib for the trait_item-specific type
1848-
// parameters.
1849-
//
1850-
// FIXME #4951: Do we need a node ID here?
1851-
18521847
match trait_item.node {
18531848
ast::ConstTraitItem(_, ref default) => {
18541849
// Only impose the restrictions of

branches/stable/src/libstd/io/buffered.rs

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ use io::{self, DEFAULT_BUF_SIZE, Error, ErrorKind, SeekFrom};
2121
use ptr;
2222
use iter;
2323

24-
/// Wraps a `Read` and buffers input from it
24+
/// Wraps a `Read` and buffers input from it.
2525
///
2626
/// It can be excessively inefficient to work directly with a `Read` instance.
2727
/// For example, every call to `read` on `TcpStream` results in a system call.
@@ -54,13 +54,13 @@ pub struct BufReader<R> {
5454
}
5555

5656
impl<R: Read> BufReader<R> {
57-
/// Creates a new `BufReader` with a default buffer capacity
57+
/// Creates a new `BufReader` with a default buffer capacity.
5858
#[stable(feature = "rust1", since = "1.0.0")]
5959
pub fn new(inner: R) -> BufReader<R> {
6060
BufReader::with_capacity(DEFAULT_BUF_SIZE, inner)
6161
}
6262

63-
/// Creates a new `BufReader` with the specified buffer capacity
63+
/// Creates a new `BufReader` with the specified buffer capacity.
6464
#[stable(feature = "rust1", since = "1.0.0")]
6565
pub fn with_capacity(cap: usize, inner: R) -> BufReader<R> {
6666
let mut buf = Vec::with_capacity(cap);
@@ -183,7 +183,7 @@ impl<R: Seek> Seek for BufReader<R> {
183183
}
184184
}
185185

186-
/// Wraps a Writer and buffers output to it
186+
/// Wraps a Writer and buffers output to it.
187187
///
188188
/// It can be excessively inefficient to work directly with a `Write`. For
189189
/// example, every call to `write` on `TcpStream` results in a system call. A
@@ -205,13 +205,13 @@ pub struct BufWriter<W: Write> {
205205
pub struct IntoInnerError<W>(W, Error);
206206

207207
impl<W: Write> BufWriter<W> {
208-
/// Creates a new `BufWriter` with a default buffer capacity
208+
/// Creates a new `BufWriter` with a default buffer capacity.
209209
#[stable(feature = "rust1", since = "1.0.0")]
210210
pub fn new(inner: W) -> BufWriter<W> {
211211
BufWriter::with_capacity(DEFAULT_BUF_SIZE, inner)
212212
}
213213

214-
/// Creates a new `BufWriter` with the specified buffer capacity
214+
/// Creates a new `BufWriter` with the specified buffer capacity.
215215
#[stable(feature = "rust1", since = "1.0.0")]
216216
pub fn with_capacity(cap: usize, inner: W) -> BufWriter<W> {
217217
BufWriter {
@@ -253,11 +253,11 @@ impl<W: Write> BufWriter<W> {
253253
#[stable(feature = "rust1", since = "1.0.0")]
254254
pub fn get_ref(&self) -> &W { self.inner.as_ref().unwrap() }
255255

256-
/// Gets a mutable reference to the underlying write.
256+
/// Gets a mutable reference to the underlying writer.
257257
///
258258
/// # Warning
259259
///
260-
/// It is inadvisable to directly read from the underlying writer.
260+
/// It is inadvisable to directly write to the underlying writer.
261261
#[stable(feature = "rust1", since = "1.0.0")]
262262
pub fn get_mut(&mut self) -> &mut W { self.inner.as_mut().unwrap() }
263263

0 commit comments

Comments
 (0)