Merge branch 'master' of https://github.com/rust-lang-ja/the-rust-programming-language-ja

Author: onobori

1.6/ja/book/SUMMARY.md

@@ -3,7 +3,7 @@
 * [はじめる](getting-started.md)
 * [Rustを学ぶ](learn-rust.md)
     * [数当てゲーム](guessing-game.md)
-    * [晩餐する哲学者](dining-philosophers.md)
+    * [食事する哲学者](dining-philosophers.md)
     * [他言語と共存する](rust-inside-other-languages.md)
 * [シンタックスとセマンティクス](syntax-and-semantics.md)
     * [変数束縛](variable-bindings.md)
@@ -15,7 +15,7 @@
     * [所有権](ownership.md)
     * [参照と借用](references-and-borrowing.md)
     * [ライフタイム](lifetimes.md)
-    * [可変性](mutability.md)
+    * [ミュータビリティ](mutability.md)
     * [構造体](structs.md)
     * [列挙型](enums.md)
     * [マッチ](match.md)

1.6/ja/book/advanced-linking.md

@@ -14,8 +14,8 @@ Rustにおけるリンクの一般的なケースについては本書の前の
 <!-- the `link_args` attribute. This attribute is applied to `extern` blocks and -->
 <!-- specifies raw flags which need to get passed to the linker when producing an -->
 <!-- artifact. An example usage would be: -->
-どのようにリンクをカスタマイズするかを`rustc`に指示するために、1つの方法があります。それは、`link_args`アトリビュートを使うことです。
-このアトリビュートは`extern`ブロックに適用され、生成物を作るときにリンカに渡したいフラグをそのまま指定します。
+どのようにリンクをカスタマイズするかを `rustc` に指示するために、1つの方法があります。それは、 `link_args` アトリビュートを使うことです。
+このアトリビュートは `extern` ブロックに適用され、生成物を作るときにリンカに渡したいフラグをそのまま指定します。
 使い方の例は次のようになります。
 
 ``` no_run
@@ -34,14 +34,14 @@ extern {}
 <!-- LLVM directly to link native libraries, in which case `link_args` will have no -->
 <!-- meaning. You can achieve the same effect as the `link_args` attribute with the -->
 <!-- `-C link-args` argument to `rustc`. -->
-これはリンクを実行するための認められた方法ではないため、この機能は現在`feature(link_args)`ゲートによって隠されているということに注意しましょう。
-今は`rustc`がシステムリンカ（多くのシステムでは`gcc`、MSVCでは`link.exe`）に渡すので、追加のコマンドライン引数を提供することには意味がありますが、それが今後もそうだとは限りません。
-将来、`rustc`がネイティブライブラリをリンクするためにLLVMを直接使うようになるかもしれませんし、そのような場合には`link_args`は意味がなくなるでしょう。
-`rustc`に`-C link-args`引数をつけることで、`link_args`アトリビュートと同じような効果を得ることができます。
+これはリンクを実行するための認められた方法ではないため、この機能は現在 `feature(link_args)` ゲートによって隠されているということに注意しましょう。
+今は `rustc` がシステムリンカ（多くのシステムでは `gcc` 、MSVCでは `link.exe` ）に渡すので、追加のコマンドライン引数を提供することには意味がありますが、それが今後もそうだとは限りません。
+将来、 `rustc` がネイティブライブラリをリンクするためにLLVMを直接使うようになるかもしれませんし、そのような場合には `link_args` は意味がなくなるでしょう。
+`rustc` に `-C link-args` 引数をつけることで、 `link_args` アトリビュートと同じような効果を得ることができます。
 
 <!-- It is highly recommended to *not* use this attribute, and rather use the more -->
 <!-- formal `#[link(...)]` attribute on `extern` blocks instead. -->
-このアトリビュートは使わ *ない* ことが強く推奨されているので、代わりにもっと正式な`#[link(...)]`アトリビュートを`extern`ブロックに使いましょう。
+このアトリビュートは使わ *ない* ことが強く推奨されているので、代わりにもっと正式な `#[link(...)]` アトリビュートを `extern` ブロックに使いましょう。
 
 <!-- # Static linking -->
 # スタティックリンク
@@ -55,7 +55,7 @@ extern {}
 <!-- change this and statically link them as well. -->
 スタティックリンクとは全ての必要なライブラリを含めた成果物を生成する手順のことで、そうすればコンパイルされたプロジェクトを使いたいシステム全てにライブラリをインストールする必要がなくなります。
 Rustのみで構築された依存関係はデフォルトでスタティックリンクされます。そのため、Rustをインストールしなくても、作成されたバイナリやライブラリを使うことができます。
-対照的に、ネイティブライブラリ（例えば`libc`や`libm`）はダイナミックリンクされるのが普通です。しかし、これを変更してそれらを同様にスタティックリンクすることも可能です。
+対照的に、ネイティブライブラリ（例えば `libc` や `libm` ）はダイナミックリンクされるのが普通です。しかし、これを変更してそれらを同様にスタティックリンクすることも可能です。
 
 <!-- Linking is a very platform-dependent topic, and static linking may not even be -->
 <!-- possible on some platforms! This section assumes some basic familiarity with -->
@@ -69,8 +69,8 @@ Rustのみで構築された依存関係はデフォルトでスタティック
 <!-- By default, all Rust programs on Linux will link to the system `libc` along with -->
 <!-- a number of other libraries. Let's look at an example on a 64-bit Linux machine -->
 <!-- with GCC and `glibc` (by far the most common `libc` on Linux): -->
-デフォルトでは、Linux上の全てのRustのプログラムはシステムの`libc`とその他のいくつものライブラリとリンクされます。
-GCCと`glibc`（Linuxにおける最も一般的な`libc`）を使った64ビットLinuxマシンでの例を見てみましょう。
+デフォルトでは、Linux上の全てのRustのプログラムはシステムの `libc` とその他のいくつものライブラリとリンクされます。
+GCCと `glibc` （Linuxにおける最も一般的な `libc` ）を使った64ビットLinuxマシンでの例を見てみましょう。
 
 ``` text
 $ cat example.rs
@@ -95,8 +95,8 @@ $ ldd example
 <!-- Static linking is supported via an alternative `libc`, [`musl`](http://www.musl-libc.org). You can compile -->
 <!-- your own version of Rust with `musl` enabled and install it into a custom -->
 <!-- directory with the instructions below: -->
-スタティックリンクは代わりの`libc`である[`musl`](http://www.musl-libc.org/)によってサポートされています。
-以下の手順に従い、`musl`を有効にした独自バージョンのRustをコンパイルして独自のディレクトリにインストールすることができます。
+スタティックリンクは代わりの `libc` である [`musl`](http://www.musl-libc.org/) によってサポートされています。
+以下の手順に従い、 `musl` を有効にした独自バージョンのRustをコンパイルして独自のディレクトリにインストールすることができます。
 
 ```text
 $ mkdir musldist
@@ -142,7 +142,7 @@ $ du -h musldist/bin/rustc
 <!-- You now have a build of a `musl`-enabled Rust! Because we've installed it to a -->
 <!-- custom prefix we need to make sure our system can find the binaries and appropriate -->
 <!-- libraries when we try and run it: -->
-これで`musl`が有効になったRustのビルドが手に入りました!
+これで `musl` が有効になったRustのビルドが手に入りました!
 独自のプレフィックスを付けてインストールしたので、試しに実行するときにはシステムがバイナリと適切なライブラリを見付けられることを確かめなければなりません。
 
 ```text
@@ -171,5 +171,5 @@ thread '<main>' panicked at 'failed', example.rs:1
 <!-- `cargo build` also permits the `--target` option so you should be able to build -->
 <!-- your crates as normal. However, you may need to recompile your native libraries -->
 <!-- against `musl` before they can be linked against. -->
-`cargo build`も`--target`オプションを受け付けるので、あなたのクレートも普通にビルドできるはずです。
-ただし、リンクする前にネイティブライブラリを`musl`向けにリコンパイルする必要はあるかもしれません。
+`cargo build` も `--target` オプションを受け付けるので、あなたのクレートも普通にビルドできるはずです。
+ただし、リンクする前にネイティブライブラリを `musl` 向けにリコンパイルする必要はあるかもしれません。

1.6/ja/book/associated-constants.md

@@ -1,6 +1,8 @@
-% Associated Constants
+% 関連定数
+<!-- % Associated Constants -->
 
-With the `associated_consts` feature, you can define constants like this:
+<!-- With the `associated_consts` feature, you can define constants like this: -->
+`associated_consts` フィーチャを使うと、以下のように定数を定義することができます。
 
 ```rust
 #![feature(associated_consts)]
@@ -18,7 +20,8 @@ fn main() {
 }
 ```
 
-Any implementor of `Foo` will have to define `ID`. Without the definition:
+<!-- Any implementor of `Foo` will have to define `ID`. Without the definition: -->
+`Foo` を実装する場合、必ず `ID` を定義しなければなりません。もし以下のように定義がなかった場合
 
 ```rust,ignore
 #![feature(associated_consts)]
@@ -31,15 +34,18 @@ impl Foo for i32 {
 }
 ```
 
-gives
+<!-- gives -->
+このようになります。
 
 ```text
 error: not all trait items implemented, missing: `ID` [E0046]
+(訳注: エラー。トレイトの全ての要素が実装されていません。 `ID` が未実装です。)
      impl Foo for i32 {
      }
 ```
 
-A default value can be implemented as well:
+<!-- A default value can be implemented as well: -->
+既定値についても以下のように実装できます。
 
 ```rust
 #![feature(associated_consts)]
@@ -61,12 +67,14 @@ fn main() {
 }
 ```
 
-As you can see, when implementing `Foo`, you can leave it unimplemented, as
-with `i32`. It will then use the default value. But, as in `i64`, we can also
-add our own definition.
+<!-- As you can see, when implementing `Foo`, you can leave it unimplemented, as -->
+<!-- with `i32`. It will then use the default value. But, as in `i64`, we can also -->
+<!-- add our own definition. -->
+上記の通り、 `Foo` トレイトを実装する際、 `i32` のように未実装のままにすることができます。この場合、既定値が使われます。一方 `i64` のように独自の定義を追加することもできます。
 
-Associated constants don’t have to be associated with a trait. An `impl` block
-for a `struct` or an `enum` works fine too:
+<!-- Associated constants don’t have to be associated with a trait. An `impl` block -->
+<!-- for a `struct` or an `enum` works fine too: -->
+関連定数は必ずしもトレイトに関連付けられる必要はありません。 `struct` や `enum` の `impl` ブロックにおいても使うことができます。
 
 ```rust
 #![feature(associated_consts)]