fix translation & change code block comment

Author: dalance

1.6/ja/book/custom-allocators.md

@@ -21,7 +21,7 @@
 <!-- allocate and deallocate memory. The standard library is not compiled assuming -->
 <!-- either one, and the compiler will decide which allocator is in use at -->
 <!-- compile-time depending on the type of output artifact being produced. -->
-現在コンパイラは `alloc_system` と `alloc_jemalloc` (いくつかのターゲットにはありません)という2つの既定のアロケータを提供しています。これらのアロケータは単に普通のRustのクレートで、メモリの割り当てと解放の手続きを実装しています。標準ライブラリはどちらか一方を前提としてコンパイルされているわけではありません。コンパイラは生成する成果物の種類に応じてどちらのアロケータを使用するかをコンパイル時に決定します。
+現在コンパイラは `alloc_system` と `alloc_jemalloc` (jemallocのないターゲットもあります)という2つの既定のアロケータを提供しています。これらのアロケータは単に普通のRustのクレートで、メモリの割り当てと解放の手続きを実装しています。標準ライブラリはどちらか一方を前提としてコンパイルされているわけではありません。コンパイラは生成する成果物の種類に応じてどちらのアロケータを使用するかをコンパイル時に決定します。
 
 <!-- Binaries generated by the compiler will use `alloc_jemalloc` by default (where -->
 <!-- available). In this situation the compiler "controls the world" in the sense of -->
@@ -45,13 +45,12 @@
 コンパイラによる既定の選択はほとんどの場合うまく動きますが、しばしば多少の調整が必要になることがあります。コンパイラのアロケータ選択を上書きするには、単に希望のアロケータとリンクするだけです。
 
 ```rust,no_run
-
 #![feature(alloc_system)]
 
 extern crate alloc_system;
 
 fn main() {
-    let a = Box::new(4); // allocates from the system allocator
+# //    let a = Box::new(4); // allocates from the system allocator
     let a = Box::new(4); // システムアロケータからのメモリ割り当て
     println!("{}", a);
 }
@@ -69,7 +68,7 @@ fn main() {
 extern crate alloc_jemalloc;
 
 pub fn foo() {
-    let a = Box::new(4); // allocates from jemalloc
+# //    let a = Box::new(4); // allocates from jemalloc
     let a = Box::new(4); // jemallocからのメモリ割り当て
     println!("{}", a);
 }
@@ -89,34 +88,52 @@ pub fn foo() {
 ```rust,no_run
 # // only needed for rustdoc --test down below
 # #![feature(lang_items)]
-// The compiler needs to be instructed that this crate is an allocator in order
-// to realize that when this is linked in another allocator like jemalloc should
-// not be linked in
+# //// The compiler needs to be instructed that this crate is an allocator in order
+# //// to realize that when this is linked in another allocator like jemalloc should
+# //// not be linked in
 // コンパイラがリンク時に他のアロケータ(例えばjemalloc)とリンクしてしまうことを防ぐため、
 // このクレートがアロケータであることを示す必要があります。
 #![feature(allocator)]
 #![allocator]
 
-// Allocators are not allowed to depend on the standard library which in turn
-// requires an allocator in order to avoid circular dependencies. This crate,
-// however, can use all of libcore.
+# //// Allocators are not allowed to depend on the standard library which in turn
+# //// requires an allocator in order to avoid circular dependencies. This crate,
+# //// however, can use all of libcore.
 // 循環依存を避けるため、アロケータはアロケータを使う標準ライブラリに依存してはいけません。
 // しかしlibcoreについては全ての機能を使用できます。
 #![no_std]
 
-// Let's give a unique name to our custom allocator
+# //// Let's give a unique name to our custom allocator
 // カスタムアロケータに固有の名前を付けてください。
 #![crate_name = "my_allocator"]
 #![crate_type = "rlib"]
 
-// Our system allocator will use the in-tree libc crate for FFI bindings. Note
-// that currently the external (crates.io) libc cannot be used because it links
-// to the standard library (e.g. `#![no_std]` isn't stable yet), so that's why
-// this specifically requires the in-tree version.
-// この独自アロケータはFFIバインディングのためにin-treeのlibcクレートを使います。
+# //// Our system allocator will use the in-tree libc crate for FFI bindings. Note
+# //// that currently the external (crates.io) libc cannot be used because it links
+# //// to the standard library (e.g. `#![no_std]` isn't stable yet), so that's why
+# //// this specifically requires the in-tree version.
+// この独自アロケータはFFIバインディングのためにRustコンパイラのソースコードに
+// 同梱されているlibcクレートを使います。
 // 注記: 現在の外部libc(crate.ioのもの)は標準ライブラリとリンクしているため使用できません
-// ( `#![no_std]` がまだstableではないためです)。そのため特別にin-treeのlibcが必要になります。
+// ( `#![no_std]` がまだstableではないためです)。そのため特別に同梱版のlibcが必要になります。
 #![feature(libc)]
+extern crate libc;
+
+# //// Listed below are the five allocation functions currently required by custom
+# //// allocators. Their signatures and symbol names are not currently typechecked
+# //// by the compiler, but this is a future extension and are required to match
+# //// what is found below.
+# ////
+# //// Note that the standard `malloc` and `realloc` functions do not provide a way
+# //// to communicate alignment so this implementation would need to be improved
+# //// with respect to alignment in that aspect.
+// 今のところ、カスタムアロケータには以下の5つのメモリ割り当て関数が必要です。
+// コンパイラは現時点では関数のシグネチャとシンボル名の型検査を行いません。
+// しかし、将来的には以下の型に一致する必要があります。
+//
+// 注記: 標準の `malloc` と `realloc` 関数へはアラインメントについての情報を
+// 渡すことができません。そのためアラインメントを考慮するためにはこの実装は
+// 改良の必要があります。
 
 #[no_mangle]
 pub extern fn __rust_allocate(size: usize, _align: usize) -> *mut u8 {
@@ -139,7 +156,7 @@ pub extern fn __rust_reallocate(ptr: *mut u8, _old_size: usize, size: usize,
 #[no_mangle]
 pub extern fn __rust_reallocate_inplace(_ptr: *mut u8, old_size: usize,
                                         _size: usize, _align: usize) -> usize {
-    old_size // this api is not supported by libc
+# //    old_size // this api is not supported by libc
     old_size // このAPIはlibcではサポートされていません。
 }
 
@@ -164,7 +181,7 @@ pub extern fn __rust_usable_size(size: usize, _align: usize) -> usize {
 extern crate my_allocator;
 
 fn main() {
-    let a = Box::new(8); // allocates memory via our custom allocator crate
+# //    let a = Box::new(8); // allocates memory via our custom allocator crate
     let a = Box::new(8); // カスタムアロケータによるメモリ割り当て
     println!("{}", a);
 }
@@ -188,4 +205,4 @@ fn main() {
 <!--   depend on a crate which needs an allocator (e.g. circular dependencies are not -->
 <!--   allowed). This basically means that allocators must restrict themselves to -->
 <!--   libcore currently. -->
-* アロケータを使うコードは `#![needs_allocator]` でタグ付けされます(例えば現時点での `liballoc` クレート)。また、 `#[allocator]` がついたクレートはアロケータを使うクレートに依存することが出来ません(循環依存は許されていません)。このためアロケータは原則としてlibcoreにしか依存しないようにする必要があります。
+* アロケータを使うコードは `#![needs_allocator]` でタグ付けされます(例えば現時点での `liballoc` クレート)。また、 `#[allocator]` がついたクレートはアロケータを使うクレートに直接的にも間接的にも依存することが出来ません(例えば、循環依存は許されていません)。このためアロケータは原則としてlibcoreにしか依存しないようにする必要があります。

TranslationTable.md

@@ -10,6 +10,7 @@
 
 | English               | 日本語
 |:----------------------|:------
+| alignment             | アラインメント
 | allocator             | アロケータ
 | application           | アプリケーション
 | associated -          | 関連-
@@ -41,8 +42,10 @@
 | owner                 | 所有者
 | ownership             | 所有権
 | return                | 返す
+| signature             | シグネチャ
 | struct                | 構造体
 | structure             | ストラクチャ
+| symbol                | シンボル
 | system                | システム
 | trait                 | トレイト
 | unsized type          | サイズ不定型