about summary refs log tree commit diff
path: root/src
diff options
context:
space:
mode:
authorSteve Klabnik <steve@steveklabnik.com>2015-03-27 14:48:13 -0400
committerSteve Klabnik <steve@steveklabnik.com>2015-03-27 18:31:44 -0400
commite604382ad230219f0f692188a6802fd046574444 (patch)
tree722efbb595399dd0851fe75a4772f26f56d1c05d /src
parent242ed0b7c0f6a21096f2cc3e1ad1bdb176d02545 (diff)
downloadrust-e604382ad230219f0f692188a6802fd046574444.tar.gz
rust-e604382ad230219f0f692188a6802fd046574444.zip
Explain why &self is common
Fixes #23748
Diffstat (limited to 'src')
-rw-r--r--src/doc/trpl/method-syntax.md3
1 files changed, 2 insertions, 1 deletions
diff --git a/src/doc/trpl/method-syntax.md b/src/doc/trpl/method-syntax.md
index 8cb16f7ab33..f7cda400526 100644
--- a/src/doc/trpl/method-syntax.md
+++ b/src/doc/trpl/method-syntax.md
@@ -51,7 +51,8 @@ You can think of this first parameter as being the `x` in `x.foo()`. The three
 variants correspond to the three kinds of thing `x` could be: `self` if it's
 just a value on the stack, `&self` if it's a reference, and `&mut self` if it's
 a mutable reference. We should default to using `&self`, as it's the most
-common. Here's an example of all three variants:
+common, as Rustaceans prefer borrowing over taking ownership, and references 
+over mutable references. Here's an example of all three variants:
 
 ```rust
 struct Circle {