X-Git-Url: http://j8takagi.net/cgi-bin/gitweb.cgi?p=YACASL2.git;a=blobdiff_plain;f=doc%2Finstall.texi;h=ee81dc42754f032e809328ef999693a701c844d8;hp=074c03c3dfbbd643376d310489274fceb64a4b26;hb=7fbde1700bbe9d8f779033ad3b842d3dceb3e1c6;hpb=33d5f89bc9adc2e46407182f6bfa8032b87ad245 diff --git a/doc/install.texi b/doc/install.texi index 074c03c..ee81dc4 100644 --- a/doc/install.texi +++ b/doc/install.texi @@ -14,7 +14,7 @@ @c %**end of header @copying -Copyright @copyright{} 2010-2012 j8takagi +Copyright @copyright{} 2010-2018 j8takagi @end copying @titlepage @@ -24,38 +24,44 @@ Copyright @copyright{} 2010-2012 j8takagi @end titlepage @node Top, Require, (dir), (dir) -@chapter YACASL2のインストール @menu * Require:: 要件 -* Download:: YACASL2ファイルのダウンロード -* Verify:: YACASL2ファイルの検証 -* Expand:: YACASL2ファイルの展開 -* Build:: @file{casl2} @file{comet2} @file{dumpword}のビルド -* Simple Test:: @file{casl2}の実行テスト -* Detail Test:: 詳細なテスト -* Install:: インストール -* Environment:: 環境変数の設定 +* install:: インストール @end menu @contents -@node Require, Download, Top, Top -@unnumberedsec 要件 +@node Require, install, Top, Top +@chapter 要件 -YACASL2は、LinuxやMac OS Xなど、UNIX系のOS上で動作します。現在動作を確認しているのは、Ubuntu LinuxとVine Linux、Mac OS Xです。 +YACASL2は、LinuxやMac OS Xなど、UNIX系のOS上で動作します。現在動作を確認しているのは、Ubuntu LinuxとMac OS Xです。 インストール時に、@command{tar} @command{gcc} @command{make}が必要です。Linuxでは多くの場合、標準でインストールされています。Mac OS Xの場合、Xcodeの「Command Line Tools」に含まれます。 -@node Download, Verify, Require, Top +@node install, , Require, Top +@chapter インストールの手順 + +@menu +* Download:: YACASL2ファイルのダウンロード +* Verify:: YACASL2ファイルの検証 +* Expand:: YACASL2ファイルの展開 +* Build:: @file{casl2} @file{comet2} @file{dumpword}のビルド +* Simple Test:: @file{casl2}の実行テスト +* Detail Test:: 詳細なテスト +* Install:: インストール +* Environment:: 環境変数の設定 +@end menu + +@node Download, Verify, install, install @section YACASL2ファイルのダウンロード @uref{http://www.j8takagi.net/yacasl2/, YACASL2のサイト}から、@file{tar.gz}または@file{tar.xz}ファイルと、対応する検証用ファイルをダウンロードします。@uref{http://github.com/j8takagi/YACASL2/downloads/, githubのダウンロードページ}から@file{tar.gz}などのファイルをダウンロードすることもできます。 -@node Verify, Expand, Download, Top +@node Verify, Expand, Download, install @section YACASL2ファイルの検証 -ダウンロードが完了したら、圧縮ファイルが改竄されていないか検証します。検証にはGnuPG分離署名か、MD5ハッシュ値を使います。 +ダウンロードが完了したら、圧縮ファイルが改竄されていないか検証します。検証には、GnuPG分離署名か、MD5ハッシュ値を使います。 @subsection GnuPG分離署名での検証 @@ -116,7 +122,7 @@ $ @kbd{openssl md5 yacasl2.tar.gz | diff -s yacasl2.tar.gz.md5sum -} Files yacasl2.tar.gz.md5sum and - are identical @end example -@node Expand, Build, Verify, Top +@node Expand, Build, Verify, install @section YACASL2ファイルの展開 YACASL2ファイルをダウンロードしたら、@command{tar}コマンドで展開します。 @@ -125,7 +131,7 @@ YACASL2ファイルをダウンロードしたら、@command{tar}コマンドで $ @kbd{tar xvzf yacasl2.tar.gz} @end example -@node Build, Simple Test, Expand, Top +@node Build, Simple Test, Expand, install @section @file{casl2} @file{comet2} @file{dumpword}のビルド 展開したら、@command{make}コマンドで@file{casl2} @file{comet2} @file{dumpword}をビルドします。 @@ -157,7 +163,7 @@ gcc -g -Wall -I ../include -o ../dumpword dumpword.o word.o cerr.o make[1]: Leaving directory ‘/home/kazubito/yacasl2/src’ @end example -@node Simple Test, Detail Test, Build, Top +@node Simple Test, Detail Test, Build, install @section @file{casl2}の実行テスト ビルドしたら、次のコマンドが正常に実行できるかを確認します。 @@ -168,7 +174,7 @@ $ @kbd{./casl2 as/hello.casl} Hello, World! @end example -@node Detail Test, Install, Simple Test, Top +@node Detail Test, Install, Simple Test, install @section 詳細なテスト @command{make check}コマンドを実行すると、正常にビルドできているかどうかを詳細にテストできます。 @@ -187,7 +193,7 @@ All tests are succeded. All tests are succeded. @end example -@node Install, Environment, Detail Test, Top +@node Install, Environment, Detail Test, install @section インストール ビルドが成功したら、@command{make install}コマンドで必要なファイルをインストールできます。 @@ -211,11 +217,10 @@ $ @kbd{sudo make install prefix=/usr/local} @headitem オプション @tab 説明 @tab 初期設定 @item @var{prefix} @tab インストール時のルートファイル @tab @file{~} @item @var{bindir} @tab 実行ファイルのインストール先 @tab @file{$prefix/bin} -@item @var{infodir} @tab infoファイルのインストール先 @tab @file{$prefix/info} -@item @var{casl2libdir} @tab CASL II ライブラリファイルのインストール先 @tab @file{$prefix/lib/yacasl2} +@item @var{infodir} @tab infoファイルのインストール先 @tab @file{$prefix/share/info} @end multitable -@node Environment, , Install, Top +@node Environment, , Install, install @section 環境変数の設定 環境変数@code{PATH}や@code{CASL2LIB}を設定することで、YACASL2が使いやすくなります。環境変数は、使っているシェルを確認してから設定します。 @@ -229,7 +234,7 @@ $ @kbd{echo $SHELL} /bin/bash @end example -現在もっとも多く使われているシェルは、BASHでしょう。以下、BASHでの設定方法を説明します。 +現在もっとも多く使われているシェルは、Bashでしょう。以下、Bashでの設定方法を説明します。 @subsection @code{PATH}の設定 @@ -239,7 +244,7 @@ $ @kbd{echo $SHELL} $ @kbd{PATH=$PATH:~/bin && export PATH} @end example -環境変数の設定は、シェルの初期設定ファイルに追加することでログインしたあと自動的に反映されるようになります。BASHでは@file{~/.bashrc}が初期設定ファイルです。次のコマンドで追加できます。 +環境変数の設定は、シェルの初期設定ファイルに追加することでログインしたあと自動的に反映されるようになります。Bashでは@file{~/.bashrc}が初期設定ファイルです。次のコマンドで追加できます。 @example $ @kbd{echo ’PATH=$PATH:~/bin && export PATH’ >>~/.bashrc} @@ -250,7 +255,7 @@ $ @kbd{echo ’PATH=$PATH:~/bin && export PATH’ >>~/.bashrc} @code{INFOPATH}にYACASL2のInfoファイルをインストールしたディレクトリーを追加すると、ディレクトリーの指定を省略して@command{casl2} @command{comet2} @command{dumpword}を実行できます。例えば、初期設定のままInfoファイルを@file{~/share/info}にインストールしたときは、次のコマンドで設定できます。 @example -$ @kbd{INFOPATH=$INFOPATH:~/share && export INFOPATH} +$ @kbd{INFOPATH=$INFOPATH:~/share/info && export INFOPATH} @end example @file{~/.bashrc}には次のコマンドで追加できます。 @@ -259,18 +264,4 @@ $ @kbd{INFOPATH=$INFOPATH:~/share && export INFOPATH} $ @kbd{echo 'INFOPATH=$INFOPATH:~/share/info && export INFOPATH' >>~/.bashrc} @end example -@subsection @code{CASL2LIB}の設定 - -環境変数@code{CASL2LIB}を設定しておけば、CASL IIプログラム作成時に共通ライブラリを呼び出す手間が小さくなります。例えば、CASL2LIBを@code{~/yacasl2/casl2lib}にインストールしたときは、次のコマンドで設定できます。 - -@example -$ @kbd{CASL2LIB=~/yacasl2/casl2lib && export CASL2LIB} -@end example - -@file{~/.bashrc}には次のコマンドで追加できます。 - -@example -$ @kbd{ echo 'CASL2LIB=~/yacasl2/casl2lib && export CASL2LIB' >>~/.bashrc} -@end example - @bye