rust 1.7対応

[KeenS]

3/3に1.7が出るらしいですね。アップデートのこと考えないと。

Downloads · The Rust Programming Language
https://www.rust-lang.org/downloads.html

[tatsuya6502]

Rust のリリースは６週間周期と決まっているので、こちらのアップデートも６週間ごとに発生しますね。

とり急ぎ、翻訳進行状況管理表 は、ページ名にバージョン番号「Rust 1.6」を付けておきました。もし、Rust 1.7 版が必要になったら、同じようなページを作ります。

diff を見ると、1.6.0 からの変更はそれほど多くないようです。

• 修正が多めなページ：
  • 4.12. enums
  • 5.7. error-handling.md（diff で見ると多いが、大半はサンプルコードの修正なので、本文の修正量は他と同じくらい）
  • 2. getting-started.md
  • 3.1. guessing-game.md
  • 4.7. ownership.md
  • 4.14. patterns.md
  • 4.11. structs.md
  • 5.1. the-stack-and-the-heap.md
  • 4.16. vectors.md
• 削除されたページ：
  • 3.2. dining-philosophers.md
  • 3.3. rust-inside-other-languages.md

% git remote -v
origin  https://github.com/rust-lang/rust.git (fetch)
origin  https://github.com/rust-lang/rust.git (push)

% git diff --stat 1.6.0..origin/beta -- src/doc/book/       
 src/doc/book/README.md                                  |  14 +-
 src/doc/book/SUMMARY.md                                 |   5 +-
 src/doc/book/associated-types.md                        |   6 +-
 src/doc/book/bibliography.md                            |   3 +-
 src/doc/book/casting-between-types.md                   |   2 +-
 src/doc/book/choosing-your-guarantees.md                |   8 +-
 src/doc/book/closures.md                                |   8 +-
 src/doc/book/concurrency.md                             |   8 +-
 src/doc/book/const-and-static.md                        |   8 +-
 src/doc/book/crates-and-modules.md                      |  17 +--
 src/doc/book/custom-allocators.md                       |   4 +-
 src/doc/book/dining-philosophers.md                     | 723 -----------------------------------------------------------------------------------------------------
 src/doc/book/documentation.md                           |  20 +--
 src/doc/book/effective-rust.md                          |   2 +-
 src/doc/book/enums.md                                   |  17 ++-
 src/doc/book/error-handling.md                          | 209 +++++++++++++++++------------
 src/doc/book/ffi.md                                     |   6 +-
 src/doc/book/functions.md                               |   6 +-
 src/doc/book/generics.md                                |   4 +-
 src/doc/book/getting-started.md                         | 106 ++++++++-------
 src/doc/book/guessing-game.md                           |  57 ++++----
 src/doc/book/iterators.md                               |  18 +--
 src/doc/book/lang-items.md                              |   6 +
 src/doc/book/learn-rust.md                              |   9 --
 src/doc/book/lifetimes.md                               |  12 +-
 src/doc/book/loops.md                                   |  11 +-
 src/doc/book/macros.md                                  |  23 ++--
 src/doc/book/match.md                                   |  26 ++--
 src/doc/book/method-syntax.md                           |   8 +-
 src/doc/book/nightly-rust.md                            |   4 +-
 src/doc/book/no-stdlib.md                               |  15 ++-
 src/doc/book/operators-and-overloading.md               |   2 +-
 src/doc/book/ownership.md                               |  87 ++++++++++---
 src/doc/book/patterns.md                                |  52 ++++++--
 src/doc/book/primitive-types.md                         |  26 ++--
 src/doc/book/references-and-borrowing.md                |   8 +-
 src/doc/book/rust-inside-other-languages.md             | 344 ------------------------------------------------
 src/doc/book/strings.md                                 |   4 +-
 src/doc/book/structs.md                                 |  79 +++++++----
 src/doc/book/syntax-and-semantics.md                    |   2 +-
 src/doc/book/syntax-index.md                            |  25 ++--
 src/doc/book/testing.md                                 |  15 ++-
 src/doc/book/the-stack-and-the-heap.md                  |  57 ++++----
 src/doc/book/trait-objects.md                           |   2 +-
 src/doc/book/traits.md                                  |  20 ++-
 src/doc/book/unsafe.md                                  |   6 +-
 src/doc/book/unsized-types.md                           |   2 +-
 src/doc/book/using-rust-without-the-standard-library.md |   4 +-
 src/doc/book/variable-bindings.md                       |  10 +-
 src/doc/book/vectors.md                                 |  41 +++++-
 50 files changed, 662 insertions(+), 1489 deletions(-)

[KeenS]

はい、作業自体は大きくななそうですが更新に対応/未対応の部分をちゃんと管理しないと思っています。
かなりアナログですが

1. 現行の1.6ディレクトリをコピーして1.7ディレクトリを作る
2. 1.7と1.6のdiffを1.7に突っ込む
3. 1 pull requestにつき1diffの消化のスタイルで翻訳してく。1作業の内容は
   • 原文にパッチの適用
   • 翻訳中にコメントアウトされている英文も更新
   • 変更部分の翻訳
   • diffの削除
4. diffを全部消化し切ったらpublicに出す

1.7という名前なのに1.6のドキュメントのまま公開するのは害悪かな、と思うので更新作業が終わるまでは公開しない(HTMLを生成しない)方針にしたいのですがどうでしょうか。

[tatsuya6502]

@KeenS 👍 進め方と公開時期（更新作業が終わってから）の両方について、賛成します。

[yohhoy]

本ticketの趣旨からは少しずれるかもしれませんが、新バージョン(1.7)翻訳が完了したタイミングで旧バージョン(1.6)は削除または非公開とする運用でしょうか？

[KeenS]

URLにバージョンを含めているので双方残すつもりでいます。もしかしたらlatestとかを作って常に翻訳済みの最新版を指すようにしておいた方がいいかもしれないですね。

[tatsuya6502]

一応、お知らせですが、Rust 1.8 が日本時間の今週金曜（4/15）未明にリリースされる予定です。1.7 のドキュメントの翻訳はスキップして、1.8に直接進むのも１つの方法ですね。

[KeenS]

1.7 のドキュメントの翻訳はスキップして、1.8に直接進むのも１つの方法ですね。

そうしましょうか。

[tatsuya6502]

@KeenS 1.7 の準備を途中まで進めていただいてたので、それは無駄になってしまうかもしれませんが。個人的には、今の最新（1.8）にアップデートする方が、いいかなと思います。

[KeenS]

done