X-Git-Url: http://j8takagi.net/cgi-bin/gitweb.cgi?p=YACASL2.git;a=blobdiff_plain;f=INSTALL;h=fa63cce380e7f8967d2ee314e8d3eb312f2d3391;hp=d166f78e433b6f55f515a5f9f9a4e2ab2141708c;hb=065d340f994652a9759c496b4c024e1f9a3a6783;hpb=ac006f13842236a2a2e197e4a1cc795b094a442f diff --git a/INSTALL b/INSTALL index d166f78..fa63cce 100644 --- a/INSTALL +++ b/INSTALL @@ -1,33 +1,32 @@ -1 YACASL2のインストール -*********************** - -1 YACASL2のインストール -要件 -1.1 YACASL2ファイルのダウンロード -1.2 YACASL2ファイルの検証 - 1.2.1 GnuPG分離署名での検証 - 1.2.2 MD5ハッシュ値での検証 -1.3 YACASL2ファイルの展開 -1.4 'casl2' 'comet2' 'dumpword'のビルド -1.5 'casl2'の実行テスト -1.6 詳細なテスト -1.7 インストール -1.8 環境変数の設定 +1 要件 +2 インストールの手順 +2.1 YACASL2ファイルのダウンロード +2.2 YACASL2ファイルの検証 + 2.2.1 GnuPG分離署名での検証 + 2.2.2 MD5ハッシュ値での検証 +2.3 YACASL2ファイルの展開 +2.4 'casl2' 'comet2' 'dumpword'のビルド +2.5 'casl2'の実行テスト +2.6 詳細なテスト +2.7 インストール +2.8 環境変数の設定 シェルの確認 - 1.8.1 'PATH'の設定 - 1.8.2 'INFOPATH'の設定 - 1.8.3 'CASL2LIB'の設定 -要件 -==== + 2.8.1 'PATH'の設定 + 2.8.2 'INFOPATH'の設定 +1 要件 +****** YACASL2は、LinuxやMac OS Xなど、UNIX系のOS上で動作します。現在動作を確 -認しているのは、Ubuntu LinuxとVine Linux、Mac OS Xです。 +認しているのは、Ubuntu LinuxとMac OS Xです。 インストール時に、'tar' 'gcc' 'make'が必要です。Linuxでは多くの場合、標 準でインストールされています。Mac OS Xの場合、Xcodeの「Command Line Tools」に含まれます。 -1.1 YACASL2ファイルのダウンロード +2 インストールの手順 +******************** + +2.1 YACASL2ファイルのダウンロード ================================= YACASL2のサイト (http://www.j8takagi.net/yacasl2/)から、'tar.gz'または @@ -35,13 +34,13 @@ Tools」に含まれます。 ダウンロードページ (http://github.com/j8takagi/YACASL2/downloads/)から 'tar.gz'などのファイルをダウンロードすることもできます。 -1.2 YACASL2ファイルの検証 +2.2 YACASL2ファイルの検証 ========================= ダウンロードが完了したら、圧縮ファイルが改竄されていないか検証します。 -検証にはGnuPG分離署名か、MD5ハッシュ値を使います。 +検証には、GnuPG分離署名か、MD5ハッシュ値を使います。 -1.2.1 GnuPG分離署名での検証 +2.2.1 GnuPG分離署名での検証 --------------------------- GnuPGの'gpg'で圧縮ファイルを検証します。この検証を行うには、GnuPGがイン @@ -91,7 +90,7 @@ Tools」に含まれます。 gpg: depth: 1 valid: 4 signed: 0 trust: 4-, 0q, 0n, 0m, 0f, 0u gpg: Good signature from "j8takagi " -1.2.2 MD5ハッシュ値での検証 +2.2.2 MD5ハッシュ値での検証 --------------------------- 'openssl'と'diff'で圧縮ファイルを検証します。 @@ -99,14 +98,14 @@ Tools」に含まれます。 $ openssl md5 yacasl2.tar.gz | diff -s yacasl2.tar.gz.md5sum - Files yacasl2.tar.gz.md5sum and - are identical -1.3 YACASL2ファイルの展開 +2.3 YACASL2ファイルの展開 ========================= YACASL2ファイルをダウンロードしたら、'tar'コマンドで展開します。 $ tar xvzf yacasl2.tar.gz -1.4 'casl2' 'comet2' 'dumpword'のビルド +2.4 'casl2' 'comet2' 'dumpword'のビルド ======================================= 展開したら、'make'コマンドで'casl2' 'comet2' 'dumpword'をビルドします。 @@ -136,7 +135,7 @@ Tools」に含まれます。 gcc -g -Wall -I ../include -o ../dumpword dumpword.o word.o cerr.o make[1]: Leaving directory ‘/home/kazubito/yacasl2/src’ -1.5 'casl2'の実行テスト +2.5 'casl2'の実行テスト ======================= ビルドしたら、次のコマンドが正常に実行できるかを確認します。 正常に実行 @@ -145,7 +144,7 @@ Tools」に含まれます。 $ ./casl2 as/hello.casl Hello, World! -1.6 詳細なテスト +2.6 詳細なテスト ================ 'make check'コマンドを実行すると、正常にビルドできているかどうかを詳細 @@ -162,7 +161,7 @@ Tools」に含まれます。 /dumpword/Test.log All tests are succeded. -1.7 インストール +2.7 インストール ================ ビルドが成功したら、'make install'コマンドで必要なファイルをインストー @@ -183,11 +182,9 @@ Tools」に含まれます。 --------------------------------------------------------------------------- PREFIX インストール時のルートファイル '~' BINDIR 実行ファイルのインストール先 '$prefix/bin' -INFODIR infoファイルのインストール先 '$prefix/info' -CASL2LIBDIR CASL II ライブラリファイルのインス '$prefix/lib/yacasl2' - トール先 +INFODIR infoファイルのインストール先 '$prefix/share/info' -1.8 環境変数の設定 +2.8 環境変数の設定 ================== 環境変数'PATH'や'CASL2LIB'を設定することで、YACASL2が使いやすくなります @@ -202,10 +199,10 @@ CASL2LIBDIR CASL II ライブラリファイルのインス '$prefix/lib/ya $ echo $SHELL /bin/bash - 現在もっとも多く使われているシェルは、BASHでしょう。以下、BASHでの設定 + 現在もっとも多く使われているシェルは、Bashでしょう。以下、Bashでの設定 方法を説明します。 -1.8.1 'PATH'の設定 +2.8.1 'PATH'の設定 ------------------ 'PATH'にYACASL2の実行ファイルのインストール先を追加すると、ディレクトリ @@ -216,12 +213,12 @@ CASL2LIBDIR CASL II ライブラリファイルのインス '$prefix/lib/ya $ PATH=$PATH:~/bin && export PATH 環境変数の設定は、シェルの初期設定ファイルに追加することでログインした -あと自動的に反映されるようになります。BASHでは'~/.bashrc'が初期設定ファ +あと自動的に反映されるようになります。Bashでは'~/.bashrc'が初期設定ファ イルです。次のコマンドで追加できます。 $ echo ’PATH=$PATH:~/bin && export PATH’ >>~/.bashrc -1.8.2 'INFOPATH'の設定 +2.8.2 'INFOPATH'の設定 ---------------------- 'INFOPATH'にYACASL2のInfoファイルをインストールしたディレクトリーを追加 @@ -229,23 +226,9 @@ CASL2LIBDIR CASL II ライブラリファイルのインス '$prefix/lib/ya できます。例えば、初期設定のままInfoファイルを'~/share/info'にインストー ルしたときは、次のコマンドで設定できます。 - $ INFOPATH=$INFOPATH:~/share && export INFOPATH + $ INFOPATH=$INFOPATH:~/share/info && export INFOPATH '~/.bashrc'には次のコマンドで追加できます。 $ echo 'INFOPATH=$INFOPATH:~/share/info && export INFOPATH' >>~/.bashrc -1.8.3 'CASL2LIB'の設定 ----------------------- - - 環境変数'CASL2LIB'を設定しておけば、CASL IIプログラム作成時に共通ライブ -ラリを呼び出す手間が小さくなります。例えば、CASL2LIBを -'~/yacasl2/casl2lib'にインストールしたときは、次のコマンドで設定できます -。 - - $ CASL2LIB=~/yacasl2/casl2lib && export CASL2LIB - - '~/.bashrc'には次のコマンドで追加できます。 - - $ echo 'CASL2LIB=~/yacasl2/casl2lib && export CASL2LIB' >>~/.bashrc -