Merge branch 'master' into markdown-syntax-space

Author: KeenS

1.6/ja/book/attributes.md

@@ -1,22 +1,26 @@
-% Attributes
+% アトリビュート
+<!-- % Attributes -->
 
-Declarations can be annotated with ‘attributes’ in Rust. They look like this:
+<!-- Declarations can be annotated with ‘attributes’ in Rust. They look like this: -->
+Rustでは以下のように「アトリビュート」によって宣言を修飾することができます。
 
 ```rust
 #[test]
 # fn foo() {}
 ```
 
-or like this:
+<!-- or like this: -->
+または以下のように:
 
 ```rust
 # mod foo {
 #![test]
 # }
 ```
 
-The difference between the two is the `!`, which changes what the attribute
-applies to:
+<!-- The difference between the two is the `!`, which changes what the attribute  -->
+<!-- applies to: -->
+２つの違いは `!` に有ります、 `!` はアトリビュートが適用されるものを変更します:
 
 ```rust,ignore
 #[foo]
@@ -27,12 +31,18 @@ mod bar {
 }
 ```
 
-The `#[foo]` attribute applies to the next item, which is the `struct`
-declaration. The `#![bar]` attribute applies to the item enclosing it, which is
-the `mod` declaration. Otherwise, they’re the same. Both change the meaning of
-the item they’re attached to somehow.
+<!-- The `#[foo]` attribute applies to the next item, which is the `struct` -->
+<!-- declaration. The `#![bar]` attribute applies to the item enclosing it, which is -->
+<!-- the `mod` declaration. Otherwise, they’re the same. Both change the meaning of -->
+<!-- the item they’re attached to somehow. -->
+`#[foo]` アトリビュートは次のアイテムに適用され、この場合は `struct` 宣言に適用されます。
+`#![bar]` アトリビュートは `#![bar]` アトリビュートを囲んでいるアイテムに適用され、この場合は `mod` 宣言に適用されます。
+その他の点については同じであり、どちらも適用されたアイテムの意味を変化させます。
 
-For example, consider a function like this:
+
+
+<!-- For example, consider a function like this: -->
+例を挙げると、たとえば以下の様な関数では:
 
 ```rust
 #[test]
@@ -41,30 +51,37 @@ fn check() {
 }
 ```
 
-It is marked with `#[test]`. This means it’s special: when you run
-[tests][tests], this function will execute. When you compile as usual, it won’t
-even be included. This function is now a test function.
+<!-- It is marked with `#[test]`. This means it’s special: when you run -->
+<!-- [tests][tests], this function will execute. When you compile as usual, it won’t -->
+<!-- even be included. This function is now a test function. -->
+この関数は `#[test]` によってマークされており、これは [テスト][tests] を走らせた時に実行されるという特別な意味になります。
+通常通りにコンパイルをした場合は、コンパイル結果に含まれません。この関数は今やテスト関数なのです。
 
-[tests]: testing.html
+[テスト]: testing.html
 
-Attributes may also have additional data:
+<!-- Attributes may also have additional data: -->
+アトリビュートは以下のように、追加のデータを持つことができます:
 
 ```rust
 #[inline(always)]
 fn super_fast_fn() {
 # }
 ```
 
-Or even keys and values:
+<!-- Or even keys and values: -->
+また、キーと値についても持つことができます:
 
 ```rust
 #[cfg(target_os = "macos")]
 mod macos_only {
 # }
 ```
 
-Rust attributes are used for a number of different things. There is a full list
-of attributes [in the reference][reference]. Currently, you are not allowed to
-create your own attributes, the Rust compiler defines them.
+<!-- Rust attributes are used for a number of different things. There is a full list -->
+<!-- of attributes [in the reference][reference]. Currently, you are not allowed to -->
+<!-- create your own attributes, the Rust compiler defines them. -->
+Rustのアトリビュートは様々なことに利用されます。
+すべてのアトリビュートのリストは [リファレンス][reference] に載っています。
+現在は、Rustコンパイラーによって定義されている以外の独自のアトリビュートを作成することは許可されていません。
 
-[reference]: ../reference.html#attributes
+[リファレンス]: ../reference.html#attributes

1.6/ja/book/comments.md

@@ -1,27 +1,38 @@
-% Comments
+% コメント
+<!-- % Comments -->
 
-Now that we have some functions, it’s a good idea to learn about comments.
-Comments are notes that you leave to other programmers to help explain things
-about your code. The compiler mostly ignores them.
+<!-- Now that we have some functions, it’s a good idea to learn about comments. -->
+<!-- Comments are notes that you leave to other programmers to help explain things -->
+<!-- about your code. The compiler mostly ignores them. -->
+いくつかの関数ができたので、コメントについて学ぶことはよい考えです。
+コメントはコードについての何かを説明する助けになるように、他のプログラマに残すメモです。
+コンパイラはそれらをほとんど無視します。
 
-Rust has two kinds of comments that you should care about: *line comments*
-and *doc comments*.
+<!-- Rust has two kinds of comments that you should care about: *line comments* -->
+<!-- and *doc comments*. -->
+Rustには気にすべき2種類のコメント、 *行コメント* と *ドキュメンテーションコメント* があります。
 
 ```rust
-// Line comments are anything after ‘//’ and extend to the end of the line.
+# // Line comments are anything after ‘//’ and extend to the end of the line.
+// 行コメントは「//」以降の全ての文字であり、行末まで続く
 
 let x = 5; // this is also a line comment.
 
-// If you have a long explanation for something, you can put line comments next
-// to each other. Put a space between the // and your comment so that it’s
-// more readable.
+# // If you have a long explanation for something, you can put line comments next
+# // to each other. Put a space between the // and your comment so that it’s
+# // more readable.
+// もし何かのために長い説明を書くのであれば、行コメントを複数行に渡って書くこと
+// ができる。//とコメントとの間にスペースを置くことで、より読みやすくなる
 ```
 
-The other kind of comment is a doc comment. Doc comments use `///` instead of
-`//`, and support Markdown notation inside:
+<!-- The other kind of comment is a doc comment. Doc comments use `///` instead of -->
+<!-- `//`, and support Markdown notation inside: -->
+その他の種類のコメントはドキュメンテーションコメントです。
+ドキュメンテーションコメントは`//`の代わりに`///`を使い、その中でMarkdown記法をサポートします。
 
 ```rust
-/// Adds one to the number given.
+# /// Adds one to the number given.
+/// 与えられた数値に1を加える
 ///
 /// # Examples
 ///
@@ -38,22 +49,30 @@ fn add_one(x: i32) -> i32 {
 }
 ```
 
-There is another style of doc comment, `//!`, to comment containing items (e.g.
-crates, modules or functions), instead of the items following it. Commonly used
-inside crates root (lib.rs) or modules root (mod.rs):
+<!-- There is another style of doc comment, `//!`, to comment containing items (e.g. -->
+<!-- crates, modules or functions), instead of the items following it. Commonly used -->
+<!-- inside crates root (lib.rs) or modules root (mod.rs): -->
+もう1つのスタイルのドキュメンテーションコメントに`//!`があります。これは、その後に続く要素ではなく、それを含んでいる要素（例えばクレート、モジュール、関数）にコメントを付けます。
+一般的にはクレートルート（lib.rs）やモジュールルート（mod.rs）の中で使われます。
 
 ```
-//! # The Rust Standard Library
+//! # Rust標準ライブラリ
 //!
-//! The Rust Standard Library provides the essential runtime
-//! functionality for building portable Rust software.
+//! Rust標準ライブラリはポータブルなRustソフトウェアをビルドするために不可欠な
+//! ランタイム関数を提供する。
 ```
 
-When writing doc comments, providing some examples of usage is very, very
-helpful. You’ll notice we’ve used a new macro here: `assert_eq!`. This compares
-two values, and `panic!`s if they’re not equal to each other. It’s very helpful
-in documentation. There’s another macro, `assert!`, which `panic!`s if the
-value passed to it is `false`.
+<!-- When writing doc comments, providing some examples of usage is very, very -->
+<!-- helpful. You’ll notice we’ve used a new macro here: `assert_eq!`. This compares -->
+<!-- two values, and `panic!`s if they’re not equal to each other. It’s very helpful -->
+<!-- in documentation. There’s another macro, `assert!`, which `panic!`s if the -->
+<!-- value passed to it is `false`. -->
+ドキュメンテーションコメントを書いているとき、いくつかの使い方の例を提供することは非常に非常に有用です。
+ここでは新しいマクロ、`assert_eq!`を使っていることに気付くでしょう。
+これは2つの値を比較し、もしそれらが互いに等しくなければ`panic!`します。
+これはドキュメントの中で非常に便利です。
+もう1つのマクロ、`assert!`は、それに渡された値が`false`であれば`panic!`します。
 
-You can use the [`rustdoc`](documentation.html) tool to generate HTML documentation
-from these doc comments, and also to run the code examples as tests!
+<!-- You can use the [`rustdoc`](documentation.html) tool to generate HTML documentation -->
+<!-- from these doc comments, and also to run the code examples as tests! -->
+それらのドキュメンテーションコメントからHTMLドキュメントを生成するため、そしてコード例をテストとして実行するためにも[`rustdoc`](documentation.html)ツールを使うことができます!