[update] : Updated AlterISO 3.1

Author: Hayao0819

docs/jp/AUR.md

@@ -1,9 +1,14 @@
 ## AURについて
 AlterISO 3ではAURのパッケージをビルドに含めることができます。公式パッケージのインストールが終わった後、chrootでビルド用の一般ユーザーが作成されてビルドされます。初期のAlter ISO3では`makepkg`を使用してインストールを行っていましたが、現在は`yay`を使用してインストールされます。
 
+## yayについて
+yayは最も使用されているAURヘルパーです。AlterISOはまず一時的な一般ユーザーを作成した後、yayをmakepkgでビルドしてインストールします。  
+
 ## AURビルドを無効化する
 チャンネルの`config.<arch>`かビルド時に`--noaur`を指定することでAURのビルドをスキップできます。  
-`config.<arch>`に以下を追記して下さい。
+`config.<arch>`に以下を追記して下さい。  
+AURビルドを無効化すると一部のパッケージがインストールされなくなり、その後のプロセスで予期せぬエラーが発生する可能性があります。  
+(例えば`gnome`チャンネルではGnome拡張機能の大半をAURからインストールします。)
 
 ```bash
 # Do not install the AUR package.

docs/jp/BUILD.md

@@ -7,6 +7,12 @@ Dockerでビルドする方法は[この手順](DOCKER.md)を参照してくだ
 
 ArchやAlter上で直接ビルドする場合、ビルドはいくつかの方法で行うことができます。
 
+## アーキテクチャについて
+現在Alter Linuxは主に`i686`と`x86_64`をサポートしています。限定的に`i486`のサポートも行っています。  
+また、現在`aarch64`のサポートもテストされています。  
+ビルドを行うホスト環境と互換性のあるアーキテクチャでしかビルドできませんので十分注意してください。  
+(x86_64上でi686のビルドはできますがaarh64上でi486のビルドを行うといったことはできません。)  
+
 ### 準備
 
 ソースコードを取得します。  
@@ -41,10 +47,10 @@ make menuconfig
 ```
 
 ### GUIを使用する
-GUIで設定を行ってビルドできます。
+GUIで設定を行ってビルドできます。GUIには`python-gobject`が必須です。  
 
 ```bash
-python ./build-wizard.py
+python ./tools/build-helper.py
 ```
 
 ### ビルドウィザードを使用する
@@ -55,7 +61,7 @@ bashで書かれていますのでターミナルから実行してください
 ウィザードの使い方の詳細は[公式ブログ](https://blog.fascode.net/2020/04/17/build-alterlinux/)で紹介しています。  
 
 ```bash
-./wizard.sh
+sudo make wizard
 ```
 
 ### 手動でオプションを指定してビルドする
@@ -69,6 +75,7 @@ sudo ./build.sh [options] [channel]
 ### build.shの使い方
 
 主なオプションは以下のとおりです。完全なオプションと使い方は`./build -h`を実行して下さい。  
+（以下のオプション以外にもデバッグ用の様々なオプションが用意されています。）  
 
 用途 | 使い方
 --- | ---
@@ -82,6 +89,8 @@ sudo ./build.sh [options] [channel]
 出力先ディレクトリを指定する| -o [dir]
 作業ディレクトリを指定する | -w [dir]
 
+また引数では設定できない細かい挙動を変更する方法もあります。詳しくは[CONFIG.md](CONFIG.md)を参照してください。  
+
 #### 例
 以下の条件でビルドするにはこのようにします。
 
@@ -117,13 +126,14 @@ xfce-pro | xfceチャンネルのウィンドウマネージャを変更し、
 
 #### カーネルについて
 `i686`アーキテクチャと`x86_64`アーキテクチャでは共にArchLinuxの公式カーネルである`linux`や`linux-lts`、`linux-zen`をサポートしています。  
-また`x86_64`では公式カーネルに加えて以下のカーネルをサポートしています。
-カーネルの説明は[ArchWiki](https://wiki.archlinux.jp/index.php/%E3%82%AB%E3%83%BC%E3%83%8D%E3%83%AB)を引用しています。
+また`x86_64`では公式カーネルに加えて以下ようなカーネルをサポートしています。  
+カーネルの説明は[ArchWiki](https://wiki.archlinux.jp/index.php/%E3%82%AB%E3%83%BC%E3%83%8D%E3%83%AB)を引用しています。  
+AlterISO3からは非公式なカーネルはyayによりコンパイル、インストールされます。カーネルのコンパイルに時間がかかる場合が有るので注意してください。  
+この一覧に無いカーネルもサポートしています。完全な一覧は[x86_64のカーネル設定ファイル](/system/kernel-x86_64)を参照してください。  
 
 名前 | 特徴
 --- | ---
 ck | linux-ck にはシステムのレスポンスを良くするためのパッチが含まれています。
-lts | coreリポジトリにある長期サポート版 (Long term support, LTS) の Linux カーネルとモジュール。
 lqx | デスクトップ・マルチメディア・ゲーム用途に Debian 用の設定と ZEN カーネルソースを使ってビルドされたディストロカーネル代替
 rt | このパッチを使うことでカーネルのほとんど全てをリアルタイム実行できるようになります。
 zen-letsnote | Let's Noteでサスペンドの問題が発生しないようにパッチを当てた`linux-zen`カーネル（Alter Linux独自）

docs/jp/CHANNEL.md

@@ -228,4 +228,11 @@ rt
 ## over_isofs
 `over_isofs`ディレクトリ内でビルドされるISOファイルの`/`にファイルを上書きします。  
 `airootfs`と似ていますが`over_isofs`ではビルドされるイメージファイル内のファイルを直接操作することができます。  
-既存のファイルを上書きしてしまうとブートできなくなる可能性があるので注意して下さい。
+既存のファイルを上書きしてしまうとブートできなくなる可能性があるので注意して下さい。  
+
+## pkgbuild.any pkgbuild.<arch>
+チャンネルディレクトリ内に`pkgbuild.any(arch)/パッケージ名/PKGBUILD`を配置するとmakepkgによってビルドし、インストールされます。  
+依存関係もpacmanによって自動的にインストールされますが、注意が必要です。  
+自動的にインストールされる依存関係はあくまでArch Linuxの公式リポジトリに存在しているものだけです。  
+依存しているパッケージが一つでもAUR上に存在している場合は、その依存パッケージをAURのパッケージリストに書かなければなりません。  
+また、PKGBUILDを格納するパッケージ名も他のモジュールなどと重複してはいけません。重複してしまうとディレクトリが上書きされてしまいます。

docs/jp/CONFIG.md

@@ -11,14 +11,25 @@ alterisoではビルドに様々な設定が存在しています。
 変更できる値の完全な一覧は`default.conf`にかかれています。  
 設定を別ファイルにコピーして変更する際はそのコメントも一緒にコピーすることを推奨します。  
 
+# custom.confについて
+`custom.conf`は`defaulf.conf`を上書きするために使用されます。  
+デフォルト値を書き換えたい場合やよく使用するビルド設定はこのファイルに記述しておくと楽です。  
+また、`build.sh`の引数で変更できない細かい設定を変更することもできるようになります。  
+
+# モジュールについて
+モジュールの設定ファイルは、モジュールが設定された順番で読み込まれます。つまり`config`で配列の後ろのほうに記述したモジュールほど優先順位が高くなります。  
+
 # 読み込まれるファイル一覧
 上から順番に読み込まれます。`<arch>`と`<ch_name>`はそれぞれアーキテクチャとチャンネル名に置き換えてください。 
-同じ変数が設定されていた場合、設定ファイルが読み込まれるごとに上書きされます。
+同じ変数が設定されていた場合、設定ファイルが読み込まれるごとに上書きされます。  
 
 ファイルパス | 備考
 --- | ---
 default.conf | 全ての値がここで設定されます（必須）
+custom.conf
 channels/share/config.any | 
 channels/share/config.<arch> | 
 channels/<ch_name>/config.any | 
 channels/<ch_name>/config.<arch> | 
+modules/<md_name>/config.any | 
+modules/<md_name>/config.<arch> | 

docs/jp/KERNEL.md

@@ -1,12 +1,11 @@
 ## カーネルの設定ファイルについて
-
 AlterISOは様々なカーネルをサポートしています。カーネルは各アーキテクチャごとの設定ファイルで定義されます。
+ここではAlterISOに新しいカーネルのサポートを追加する方法を説明します。  
+AlterISO全体ではなくチャンネル内部でのみ追加する方法は[チャンネルで独自に新しいカーネルをサポートする](ORIGINAL_KERNEL.md)を参照してください。  
 
 
 ### 1.リポジトリを作成する
-リポジトリには2種類のパッケージを追加する必要があります。カーネル本体とheadersパッケージです。  
-`build.sh`はカーネルをpacmanを利用してインストールしようとします。もしあなたが公式リポジトリに無いカーネルを追加したい場合はまずはpacmanのリポジトリを作成してください。  
-カーネルのパッケージをAURからビルドすることはできません。（`pacstrap`で初期の段階でインストールされるため。）
+AlterISO3ではカーネルをAURからインストールすることはできなかったため、リポジトリを構築する必要がありました。3.1からはAURによるカーネルパッケージリストがサポートされたため、その必要はなくなっています。  
 
 
 ### 2.カーネル設定ファイルを構成する

docs/jp/LANG.md

@@ -44,4 +44,4 @@ ArchLinux32とArchLinuxでは文字列が異なるので注意してください
 ライブ環境のタイムゾーンの設定です。`/usr/share/zoneinfo`以下のパスを記述して下さい。
 
 ## fullname
-その言語のフルネームです。ビルド時のメッセージ等に使用されます。
+その言語のフルネームです。ビルド時のメッセージ等に使用されます。

docs/jp/ORIGINAL_KERNEL.md

@@ -4,7 +4,7 @@ AlterISO3ではカーネルに関する処理が大幅に変更され、チャ
 
 ## 追加したいカーネルの情報を把握する
 カーネルを追加するにはいくつかの設定ファイルを編集する必要があります。  
-それぞれの設定ファイルの詳細については[CHANNEL.md](./CHANNEL.md)を参考にして下さい。  
+それぞれの設定ファイルの詳細については[KERNEL.md](./KERNEL.md)を参考にして下さい。  
 
 カーネルを設定するには以下の情報が必要です。
 - カーネルのパッケージ名
@@ -17,6 +17,7 @@ AlterISO3ではカーネルに関する処理が大幅に変更され、チャ
 - カーネルの略称（他のカーネルと重複しない名前ならなんでもOK）
 
 ## カーネル設定ファイルを作成する
+もしチャンネルディレクトリに`kernel-<arch>`というファイルがある場合は`/system/kernel-<arch>`の代わりにそのファイルが参照されます。  
 カーネルの情報を`/system/kernel-<arch>`を参考に作成して下さい。その後作成した設定ファイルをチャンネル内に配置して下さい。  
 ビルドスクリプトは、`/system/kernel-<arch>`の代わりにチャンネル内の設定ファイルを使用します。  
 その設定ファイル内の記述されているカーネルしか使用できなくなるので、`/system/kernel-<arch>`で既に設定されているカーネルも記述して下さい。