ci: generate pages at 62bd0b3 [ci skip]

Author: bn-e

docs/ch15-00-smart-pointers.html

@@ -183,9 +183,8 @@ <h1><a class="header" href="#スマートポインタ" id="スマートポイン
 most often.
 -->
 <p><em>ポインタ</em>は、メモリのアドレスを含む変数の一般的な概念です。このアドレスは、何らかの他のデータを参照、または「指します」。
-Rustにおいて、最もありふれた種類のポインタは、参照であり、第4章で習いましたね。参照は、
-<code>&amp;</code>記号で示唆され、指している値を借用します。データを参照すること以外に特別な能力は何もありません。
-また、オーバーヘッドもなく、最も頻繁に使われる種類のポインタです。</p>
+Rustにおいて最もありふれた種類のポインタは参照です。参照については第4章で習いましたね。参照は<code>&amp;</code>記号で示唆され、指している値を借用します。データを参照すること以外に特別な能力は何もありません。
+また、オーバーヘッドもなく、ポインタの中では最も頻繁に使われます。</p>
 <!--
 *Smart pointers*, on the other hand, are data structures that not only act like
 a pointer but also have additional metadata and capabilities. The concept of
@@ -198,18 +197,18 @@ <h1><a class="header" href="#スマートポインタ" id="スマートポイン
 the data.
 -->
 <p>一方、<em>スマートポインタ</em>は、ポインタのように振る舞うだけでなく、追加のメタデータと能力があるデータ構造です。
-スマートポインタという概念は、Rustに特有のものではありません: スマートポインタは、C++に端を発し、
+スマートポインタという概念は、Rustに特有のものではありません。スマートポインタは、C++に端を発し、
 他の言語にも存在しています。Rustでは、標準ライブラリに定義された色々なスマートポインタが、
 参照以上の機能を提供します。この章で探究する一つの例が、<em>参照カウント</em>方式のスマートポインタ型です。
-このポインタにより、所有者の数を追いかけることでデータに複数の所有者を持たせることができ、
-所有者がいなくなったら、データの片付けをしてくれます。</p>
+このポインタのおかげでデータに複数の所有者を持たせることができます。
+所有者の数を追いかけ、所有者がいなくなったらデータの片付けをしてくれるからです。</p>
 <!--
 In Rust, which uses the concept of ownership and borrowing, an additional
 difference between references and smart pointers is that references are
 pointers that only borrow data; in contrast, in many cases, smart pointers
 *own* the data they point to.
 -->
-<p>所有権と借用の概念を使うRustで、参照とスマートポインタの別の差異は、参照はデータを借用するだけのポインタであることです;
+<p>所有権と借用の概念を使うRustにおいて、参照とスマートポインタにはもう1つ違いがあります。参照はデータを借用するだけのポインタなのです。
 対照的に多くの場合、スマートポインタは指しているデータを<em>所有</em>します。</p>
 <!--
 We’ve already encountered a few smart pointers in this book, such as `String`
@@ -219,10 +218,9 @@ <h1><a class="header" href="#スマートポインタ" id="スマートポイン
 and extra capabilities or guarantees (such as with `String` ensuring its data
 will always be valid UTF-8).
 -->
-<p>その時は、スマートポインタとは呼ばなかったものの、第8章の<code>String</code>や<code>Vec&lt;T&gt;</code>のように、
-この本の中でいくつかのスマートポインタに遭遇してきました。これらの型はどちらも、
-あるメモリを所有し、それを弄ることができるので、スマートポインタに数えられます。また、
-メタデータ(キャパシティなど)や追加の能力、あるいは保証(<code>String</code>ならデータが常に有効なUTF-8であると保証することなど)もあります。</p>
+<p>私達はすでに、この本の中でいくつかのスマートポインタに遭遇してきました。例えば第8章の<code>String</code>や<code>Vec&lt;T&gt;</code>です。ただし、私達はそれらをスマートポインタとは呼んでいませんでした。
+これらの型がどちらもスマートポインタに数えられるのは、あるメモリを所有しそれを弄ることができるからです。
+また、メタデータ（キャパシティなど）や追加の能力、あるいは保証（<code>String</code>ならデータが常に有効なUTF-8であると保証することなど）もあります。</p>
 <!--
 Smart pointers are usually implemented using structs. The characteristic that
 distinguishes a smart pointer from an ordinary struct is that smart pointers
@@ -234,7 +232,7 @@ <h1><a class="header" href="#スマートポインタ" id="スマートポイン
 why they’re important to smart pointers.
 -->
 <p>スマートポインタは普通、構造体を使用して実装されています。スマートポインタを通常の構造体と区別する特徴は、
-スマートポインタは、<code>Deref</code>と<code>Drop</code>トレイトを実装していることです。<code>Deref</code>トレイトにより、スマートポインタ構造体のインスタンスは、
+スマートポインタが<code>Deref</code>と<code>Drop</code>トレイトを実装していることです。<code>Deref</code>トレイトにより、スマートポインタ構造体のインスタンスは、
 参照のように振る舞うことができるので、参照あるいはスマートポインタのどちらとも動作するコードを書くことができます。
 <code>Drop</code>トレイトにより、スマートポインタのインスタンスがスコープを外れた時に走るコードをカスタマイズすることができます。
 この章では、どちらのトレイトについても議論し、これらのトレイトがスマートポインタにとって重要な理由を説明します。</p>
@@ -244,9 +242,9 @@ <h1><a class="header" href="#スマートポインタ" id="スマートポイン
 libraries have their own smart pointers, and you can even write your own. We’ll
 cover the most common smart pointers in the standard library:
 -->
-<p>スマートポインタパターンがRustにおいてよく使われる一般的なデザインパターンだとして、この章では、全ての既存のスマートポインタを講義しません。
-多くのライブラリに独自のスマートポインタがあり、自分だけのスマートポインタを書くことさえできます。
-標準ライブラリの最もありふれたスマートポインタを講義します:</p>
+<p>スマートポインタパターンがRustにおいてよく使われる一般的なデザインパターンであることを考えれば、この章で既存のスマートポインタを全て取り扱うことなどできません。
+多くのライブラリに独自のスマートポインタがあり、自分だけのスマートポインタを書くことさえできるのです。
+ここでは標準ライブラリの最もありふれたスマートポインタを取り扱っていきます。</p>
 <!--
 * `Box<T>` for allocating values on the heap
 * `Rc<T>`, a reference counting type that enables multiple ownership
@@ -263,8 +261,8 @@ <h1><a class="header" href="#スマートポインタ" id="スマートポイン
 type exposes an API for mutating an interior value. We’ll also discuss
 *reference cycles*: how they can leak memory and how to prevent them.
 -->
-<p>さらに、不変な型が、内部の値を可変化するAPIを晒す<em>内部可変性</em>パターンについても講義します。
-また、<em>循環参照</em>についても議論します: 循環参照により、メモリがリークする方法とそれを回避する方法です。</p>
+<p>さらに、<em>内部可変性</em>パターンも扱います。そこでは不変な型が、内部の値を変更するためのAPIを公開するのです。
+また、<em>循環参照</em>についても議論します。つまり、循環参照によっていかにしてメモリがリークするのか、そしてどうやってそれを回避するのかを議論します。</p>
 <!--
 Let’s dive in!
 -->

docs/print.html

@@ -26546,9 +26546,8 @@ <h1><a class="header" href="#スマートポインタ" id="スマートポイン
 most often.
 -->
 <p><em>ポインタ</em>は、メモリのアドレスを含む変数の一般的な概念です。このアドレスは、何らかの他のデータを参照、または「指します」。
-Rustにおいて、最もありふれた種類のポインタは、参照であり、第4章で習いましたね。参照は、
-<code>&amp;</code>記号で示唆され、指している値を借用します。データを参照すること以外に特別な能力は何もありません。
-また、オーバーヘッドもなく、最も頻繁に使われる種類のポインタです。</p>
+Rustにおいて最もありふれた種類のポインタは参照です。参照については第4章で習いましたね。参照は<code>&amp;</code>記号で示唆され、指している値を借用します。データを参照すること以外に特別な能力は何もありません。
+また、オーバーヘッドもなく、ポインタの中では最も頻繁に使われます。</p>
 <!--
 *Smart pointers*, on the other hand, are data structures that not only act like
 a pointer but also have additional metadata and capabilities. The concept of
@@ -26561,18 +26560,18 @@ <h1><a class="header" href="#スマートポインタ" id="スマートポイン
 the data.
 -->
 <p>一方、<em>スマートポインタ</em>は、ポインタのように振る舞うだけでなく、追加のメタデータと能力があるデータ構造です。
-スマートポインタという概念は、Rustに特有のものではありません: スマートポインタは、C++に端を発し、
+スマートポインタという概念は、Rustに特有のものではありません。スマートポインタは、C++に端を発し、
 他の言語にも存在しています。Rustでは、標準ライブラリに定義された色々なスマートポインタが、
 参照以上の機能を提供します。この章で探究する一つの例が、<em>参照カウント</em>方式のスマートポインタ型です。
-このポインタにより、所有者の数を追いかけることでデータに複数の所有者を持たせることができ、
-所有者がいなくなったら、データの片付けをしてくれます。</p>
+このポインタのおかげでデータに複数の所有者を持たせることができます。
+所有者の数を追いかけ、所有者がいなくなったらデータの片付けをしてくれるからです。</p>
 <!--
 In Rust, which uses the concept of ownership and borrowing, an additional
 difference between references and smart pointers is that references are
 pointers that only borrow data; in contrast, in many cases, smart pointers
 *own* the data they point to.
 -->
-<p>所有権と借用の概念を使うRustで、参照とスマートポインタの別の差異は、参照はデータを借用するだけのポインタであることです;
+<p>所有権と借用の概念を使うRustにおいて、参照とスマートポインタにはもう1つ違いがあります。参照はデータを借用するだけのポインタなのです。
 対照的に多くの場合、スマートポインタは指しているデータを<em>所有</em>します。</p>
 <!--
 We’ve already encountered a few smart pointers in this book, such as `String`
@@ -26582,10 +26581,9 @@ <h1><a class="header" href="#スマートポインタ" id="スマートポイン
 and extra capabilities or guarantees (such as with `String` ensuring its data
 will always be valid UTF-8).
 -->
-<p>その時は、スマートポインタとは呼ばなかったものの、第8章の<code>String</code>や<code>Vec&lt;T&gt;</code>のように、
-この本の中でいくつかのスマートポインタに遭遇してきました。これらの型はどちらも、
-あるメモリを所有し、それを弄ることができるので、スマートポインタに数えられます。また、
-メタデータ(キャパシティなど)や追加の能力、あるいは保証(<code>String</code>ならデータが常に有効なUTF-8であると保証することなど)もあります。</p>
+<p>私達はすでに、この本の中でいくつかのスマートポインタに遭遇してきました。例えば第8章の<code>String</code>や<code>Vec&lt;T&gt;</code>です。ただし、私達はそれらをスマートポインタとは呼んでいませんでした。
+これらの型がどちらもスマートポインタに数えられるのは、あるメモリを所有しそれを弄ることができるからです。
+また、メタデータ（キャパシティなど）や追加の能力、あるいは保証（<code>String</code>ならデータが常に有効なUTF-8であると保証することなど）もあります。</p>
 <!--
 Smart pointers are usually implemented using structs. The characteristic that
 distinguishes a smart pointer from an ordinary struct is that smart pointers
@@ -26597,7 +26595,7 @@ <h1><a class="header" href="#スマートポインタ" id="スマートポイン
 why they’re important to smart pointers.
 -->
 <p>スマートポインタは普通、構造体を使用して実装されています。スマートポインタを通常の構造体と区別する特徴は、
-スマートポインタは、<code>Deref</code>と<code>Drop</code>トレイトを実装していることです。<code>Deref</code>トレイトにより、スマートポインタ構造体のインスタンスは、
+スマートポインタが<code>Deref</code>と<code>Drop</code>トレイトを実装していることです。<code>Deref</code>トレイトにより、スマートポインタ構造体のインスタンスは、
 参照のように振る舞うことができるので、参照あるいはスマートポインタのどちらとも動作するコードを書くことができます。
 <code>Drop</code>トレイトにより、スマートポインタのインスタンスがスコープを外れた時に走るコードをカスタマイズすることができます。
 この章では、どちらのトレイトについても議論し、これらのトレイトがスマートポインタにとって重要な理由を説明します。</p>
@@ -26607,9 +26605,9 @@ <h1><a class="header" href="#スマートポインタ" id="スマートポイン
 libraries have their own smart pointers, and you can even write your own. We’ll
 cover the most common smart pointers in the standard library:
 -->
-<p>スマートポインタパターンがRustにおいてよく使われる一般的なデザインパターンだとして、この章では、全ての既存のスマートポインタを講義しません。
-多くのライブラリに独自のスマートポインタがあり、自分だけのスマートポインタを書くことさえできます。
-標準ライブラリの最もありふれたスマートポインタを講義します:</p>
+<p>スマートポインタパターンがRustにおいてよく使われる一般的なデザインパターンであることを考えれば、この章で既存のスマートポインタを全て取り扱うことなどできません。
+多くのライブラリに独自のスマートポインタがあり、自分だけのスマートポインタを書くことさえできるのです。
+ここでは標準ライブラリの最もありふれたスマートポインタを取り扱っていきます。</p>
 <!--
 * `Box<T>` for allocating values on the heap
 * `Rc<T>`, a reference counting type that enables multiple ownership
@@ -26626,8 +26624,8 @@ <h1><a class="header" href="#スマートポインタ" id="スマートポイン
 type exposes an API for mutating an interior value. We’ll also discuss
 *reference cycles*: how they can leak memory and how to prevent them.
 -->
-<p>さらに、不変な型が、内部の値を可変化するAPIを晒す<em>内部可変性</em>パターンについても講義します。
-また、<em>循環参照</em>についても議論します: 循環参照により、メモリがリークする方法とそれを回避する方法です。</p>
+<p>さらに、<em>内部可変性</em>パターンも扱います。そこでは不変な型が、内部の値を変更するためのAPIを公開するのです。
+また、<em>循環参照</em>についても議論します。つまり、循環参照によっていかにしてメモリがリークするのか、そしてどうやってそれを回避するのかを議論します。</p>
 <!--
 Let’s dive in!
 -->