From fb4c0c66a27656fdb2764c22208a0568ce21f14e Mon Sep 17 00:00:00 2001 From: j8takagi Date: Mon, 1 Jun 2026 21:05:05 +0900 Subject: [PATCH] =?utf8?q?install=E3=83=89=E3=82=AD=E3=83=A5=E3=83=A1?= =?utf8?q?=E3=83=B3=E3=83=88=E3=81=AE=E7=92=B0=E5=A2=83=E5=A4=89=E6=95=B0?= =?utf8?q?=E3=81=AE=E8=A8=98=E8=BF=B0=E3=82=92=E4=BF=AE=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit --- VERSION | 2 +- doc/install-info.mk | 2 +- doc/install.texi | 81 +++++++++++++++++--------------- doc/install.txt | 112 +++++++++++++++++++++++--------------------- 4 files changed, 104 insertions(+), 93 deletions(-) diff --git a/VERSION b/VERSION index cb095d0..40ce3e9 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -v0.5p37 +v0.5p38 diff --git a/doc/install-info.mk b/doc/install-info.mk index e74db9c..06f48f1 100644 --- a/doc/install-info.mk +++ b/doc/install-info.mk @@ -1,5 +1,5 @@ prefix ?= ~ -infodir ?= $(prefix)/share/info +infodir ?= $(prefix)/.local/share/info GZIP := gzip INSTALL := install diff --git a/doc/install.texi b/doc/install.texi index 56e48f9..0021f84 100644 --- a/doc/install.texi +++ b/doc/install.texi @@ -72,23 +72,23 @@ GnuPGの@command{gpg}で圧縮ファイルを検証します。この検証を @example $ @kbd{gpg --verify yacasl2.tar.xz.asc} -gpg: Signature made Sat Oct 27 02:17:16 2012 JST using RSA key ID 25B62DD1 +gpg: Signature made Sat Oct 27 02:17:16 2012 JST using RSA key ID 7F593ED86D88E1D5 gpg: Can't check signature: public key not found -$ @kbd{gpg --recv-keys 25B62DD1} -gpg: requesting key 25B62DD1 from hkp server keys.gnupg.net -gpg: key 25B62DD1: public key "j8takagi " imported +$ @kbd{gpg --recv-keys 7F593ED86D88E1D5} +gpg: requesting key 7F593ED86D88E1D5 from hkp server keys.gnupg.net +gpg: key 7F593ED86D88E1D5: public key "j8takagi " imported gpg: Total number processed: 1 gpg: imported: 1 (RSA: 1) -$ @kbd{gpg --lsign-key 25B62DD1} +$ @kbd{gpg --lsign-key 7F593ED86D88E1D5} -pub 2048R/25B62DD1 created: 2012-09-29 expires: never usage: SC +pub 2048R/7F593ED86D88E1D5 created: 2012-09-29 expires: never usage: SC trust: unknown validity: full sub 2048R/92E25C29 created: 2012-09-29 expires: never usage: E [ full ] (1). j8takagi -pub 2048R/25B62DD1 created: 2012-09-29 expires: never usage: SC +pub 2048R/7F593ED86D88E1D5 created: 2012-09-29 expires: never usage: SC trust: unknown validity: full Primary key fingerprint: ... @@ -107,12 +107,10 @@ user: ".* <.*@@.*>" @kbd{password} -$ @kbd{gpg --verify yacasl2.tar.xz.asc} -gpg: Signature made Sat Oct 27 02:17:16 2012 JST using RSA key ID 25B62DD1 -gpg: checking the trustdb -gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model -gpg: depth: 0 valid: 1 signed: 4 trust: 0-, 0q, 0n, 0m, 0f, 1u -gpg: depth: 1 valid: 4 signed: 0 trust: 4-, 0q, 0n, 0m, 0f, 0u +$ @kbd{gpg --verify yacasl2.tar.gz.asc} +gpg: assuming signed data in 'yacasl2.tar.gz' +gpg: Signature made Sun May 31 00:06:26 2026 JST +gpg: using EDDSA key 77EC282A2F7317EBFF7BFD067F593ED86D88E1D5 gpg: Good signature from "j8takagi " @end example @@ -135,9 +133,10 @@ $ @kbd{tar xvzf yacasl2.tar.gz} @end example @node Build, Simple Test, Expand, install -@section @file{casl2} @file{comet2} @file{dumpword}のビルド +@section ビルド -展開したら、@command{make}コマンドで@file{casl2} @file{comet2} @file{dumpword}をビルドします。 +展開したら、@command{make}コマンドを実行してビルドします。 +YACASL2のコマンド実行ファイルである@command{casl2} @command{comet2} @command{dumpword} @command{casl2rev} @command{commet2monitor}が生成されます。 @example $ @kbd{cd yacasl2} @@ -199,16 +198,14 @@ All tests are succeded. @node Install, Environment, Detail Test, install @section インストール -ビルドが成功したら、@command{make install}コマンドで必要なファイルをインストールできます。 -初期設定では、ホームディレクトリー以下にYACASL2のファイルがインストールされます。 +YACASL2のコマンド実行ファイルはビルド後、@command{make install}コマンドでインストールできます。インストール先は初期設定では、@file{~/bin}ディレクトリーです。 @example $ @kbd{make install} @end example -コマンド実行時にオプションを指定することで、インストール先のディレクトリーを変更できます。 -例えば、@file{/usr/local}以下にファイルをインストールするには、 -次のようにコマンドを実行します。 +インストール先を変更するには、@file{prefix}などのオプションを指定します。 +例えば@file{/usr/local}ディレクトリーにインストールするには、次のようにコマンドを実行します。 @example $ @kbd{sudo make install prefix=/usr/local} @@ -226,45 +223,55 @@ $ @kbd{sudo make install prefix=/usr/local} @node Environment, , Install, install @section 環境変数の設定 -環境変数@code{PATH}や@code{CASL2LIB}を設定することで、YACASL2が使いやすくなります。環境変数は、使っているシェルを確認してから設定します。 +環境変数@code{PATH}や@code{INFOPATH}を設定することで、YACASL2が使いやすくなります。 -@unnumberedsubsec シェルの確認 +@subsection @code{PATH}の設定 -環境変数の設定方法は使っているシェルによって異なります。シェルは、次のコマンドで確認できます。 +@code{PATH}にYACASL2の実行ファイルのインストール先が含まれている場合は、ディレクトリーの指定を省略して@command{casl2}などの実行ファイル名を指定できます。@code{PATH}は、次のコマンドで確認できます。 @example -$ @kbd{echo $SHELL} -/bin/bash +$ @kbd{echo $PATH} @end example -現在もっとも多く使われているシェルは、Bashでしょう。以下、Bashでの設定方法を説明します。 - -@subsection @code{PATH}の設定 - -@code{PATH}にYACASL2の実行ファイルのインストール先を追加すると、ディレクトリーの指定を省略して@command{casl2} @command{comet2} @command{dumpword}を実行できます。例えば、初期設定のまま実行ファイルを@file{~/bin}にインストールしたときは、次のコマンドで設定できます。 +YACASL2のインストール先の初期設定である@file{~/bin}ディレクトリーは、OSインストール時に@code{PATH}に含まれている場合もあります。含まれていない場合は、次のコマンドで@code{PATH}に追加できます。 @example -$ @kbd{PATH=$PATH:~/bin && export PATH} +$ @kbd{PATH=$HOME/bin:$PATH; export PATH} @end example -環境変数の設定は、シェルの初期設定ファイルに追加することでログインしたあと自動的に反映されるようになります。Bashでは@file{~/.bashrc}が初期設定ファイルです。次のコマンドで追加できます。 +@file{~/.profile}や@file{~/.bashrc}などの初期化ファイルに@code{PATH}への追加を設定しておけば、YACASL2のコマンド実行時に常にディレクトリーの指定を省略できます。 +次は、@code{$PATH}に@code{~/bin}が二重に追加されることを防ぐ書き方です。 @example -$ @kbd{echo ’PATH=$PATH:~/bin && export PATH’ >>~/.bashrc} +case ":$@{PATH@}:" in + *":$@{HOME@}/bin:"*) ;; + *) export PATH="$@{HOME@}/bin:$@{PATH@}" ;; +esac @end example + @subsection @code{INFOPATH}の設定 -@code{INFOPATH}にYACASL2のInfoファイルをインストールしたディレクトリーを追加すると、ディレクトリーの指定を省略して@command{casl2} @command{comet2} @command{dumpword}を実行できます。例えば、初期設定のままInfoファイルを@file{~/share/info}にインストールしたときは、次のコマンドで設定できます。 +環境変数@code{INFOPATH}とInfoが適切に設定されていれば、次のコマンドでYACASL2のInfoを表示できます。 + +@example +$ @kbd{info yacasl2} +@end example + +@code{INFOPATH}にYACASL2のInfoファイルをインストールしたディレクトリーの追加は、次のコマンドでできます。なお、YACASL2のInfoファイルインストール先の初期設定は、@file{~/.local/share/info}です。 @example -$ @kbd{INFOPATH=$INFOPATH:~/share/info && export INFOPATH} +$ @kbd{INFOPATH=$HOME/.local/share/info:$INFOPATH; export INFOPATH} @end example -@file{~/.bashrc}には次のコマンドで追加できます。 +@file{~/.profile}や@file{~/.bashrc}などの初期化ファイルに@code{INFOPATH}への追加を設定しておけば、常にYACASL2のInfoを表示できます。 +次は、@code{$INFOPATH}に@code{~/.local/share/info}が二重に追加されることを防ぐ書き方です。 @example -$ @kbd{echo 'INFOPATH=$INFOPATH:~/share/info && export INFOPATH' >>~/.bashrc} +case ":$@{INFOPATH@}:" in + *":$@{HOME@}/.local/share/info:"*) ;; + *) export INFOPATH="$@{HOME@}/.local/share/info:$@{INFOPATH@}" ;; +esac @end example @bye diff --git a/doc/install.txt b/doc/install.txt index c826003..a604e04 100644 --- a/doc/install.txt +++ b/doc/install.txt @@ -5,12 +5,11 @@ 2.2.1 GnuPG分離署名での検証 2.2.2 MD5ハッシュ値での検証 2.3 YACASL2ファイルの展開 -2.4 'casl2' 'comet2' 'dumpword'のビルド +2.4 ビルド 2.5 'casl2'の実行テスト 2.6 詳細なテスト 2.7 インストール 2.8 環境変数の設定 - シェルの確認 2.8.1 'PATH'の設定 2.8.2 'INFOPATH'の設定 @@ -48,23 +47,23 @@ Tools」に含まれます。 ストールされ、自分の秘密鍵と公開鍵のペアが作成されている必要があります。 $ gpg --verify yacasl2.tar.xz.asc - gpg: Signature made Sat Oct 27 02:17:16 2012 JST using RSA key ID 25B62DD1 + gpg: Signature made Sat Oct 27 02:17:16 2012 JST using RSA key ID 7F593ED86D88E1D5 gpg: Can't check signature: public key not found - $ gpg --recv-keys 25B62DD1 - gpg: requesting key 25B62DD1 from hkp server keys.gnupg.net - gpg: key 25B62DD1: public key "j8takagi " imported + $ gpg --recv-keys 7F593ED86D88E1D5 + gpg: requesting key 7F593ED86D88E1D5 from hkp server keys.gnupg.net + gpg: key 7F593ED86D88E1D5: public key "j8takagi " imported gpg: Total number processed: 1 gpg: imported: 1 (RSA: 1) - $ gpg --lsign-key 25B62DD1 + $ gpg --lsign-key 7F593ED86D88E1D5 - pub 2048R/25B62DD1 created: 2012-09-29 expires: never usage: SC + pub 2048R/7F593ED86D88E1D5 created: 2012-09-29 expires: never usage: SC trust: unknown validity: full sub 2048R/92E25C29 created: 2012-09-29 expires: never usage: E [ full ] (1). j8takagi - pub 2048R/25B62DD1 created: 2012-09-29 expires: never usage: SC + pub 2048R/7F593ED86D88E1D5 created: 2012-09-29 expires: never usage: SC trust: unknown validity: full Primary key fingerprint: ... @@ -83,12 +82,10 @@ Tools」に含まれます。 password - $ gpg --verify yacasl2.tar.xz.asc - gpg: Signature made Sat Oct 27 02:17:16 2012 JST using RSA key ID 25B62DD1 - gpg: checking the trustdb - gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model - gpg: depth: 0 valid: 1 signed: 4 trust: 0-, 0q, 0n, 0m, 0f, 1u - gpg: depth: 1 valid: 4 signed: 0 trust: 4-, 0q, 0n, 0m, 0f, 0u + $ gpg --verify yacasl2.tar.gz.asc + gpg: assuming signed data in 'yacasl2.tar.gz' + gpg: Signature made Sun May 31 00:06:26 2026 JST + gpg: using EDDSA key 77EC282A2F7317EBFF7BFD067F593ED86D88E1D5 gpg: Good signature from "j8takagi " 2.2.2 MD5ハッシュ値での検証 @@ -106,10 +103,12 @@ Tools」に含まれます。 $ tar xvzf yacasl2.tar.gz -2.4 'casl2' 'comet2' 'dumpword'のビルド -======================================= +2.4 ビルド +========== - 展開したら、'make'コマンドで'casl2' 'comet2' 'dumpword'をビルドします。 + 展開したら、'make'コマンドを実行してビルドします。 YACASL2のコマンド実 +行ファイルである'casl2' 'comet2' 'dumpword' 'casl2rev' 'commet2monitor'が +生成されます。 $ cd yacasl2 $ make @@ -165,15 +164,15 @@ Tools」に含まれます。 2.7 インストール ================ - ビルドが成功したら、'make install'コマンドで必要なファイルをインストー -ルできます。 初期設定では、ホームディレクトリー以下にYACASL2のファイルが -インストールされます。 + YACASL2のコマンド実行ファイルはビルド後、'make install'コマンドでインス +トールできます。インストール先は初期設定では、'~/bin'ディレクトリーです +。 $ make install - コマンド実行時にオプションを指定することで、インストール先のディレクト -リーを変更できます。 例えば、'/usr/local'以下にファイルをインストールす -るには、 次のようにコマンドを実行します。 + インストール先を変更するには、'prefix'などのオプションを指定します。 例 +えば'/usr/local'ディレクトリーにインストールするには、次のようにコマンド +を実行します。 $ sudo make install prefix=/usr/local @@ -188,48 +187,53 @@ INFODIR infoファイルのインストール先 '$prefix/share/i 2.8 環境変数の設定 ================== - 環境変数'PATH'や'CASL2LIB'を設定することで、YACASL2が使いやすくなります -。環境変数は、使っているシェルを確認してから設定します。 - -シェルの確認 ------------- - - 環境変数の設定方法は使っているシェルによって異なります。シェルは、次の -コマンドで確認できます。 - - $ echo $SHELL - /bin/bash - - 現在もっとも多く使われているシェルは、Bashでしょう。以下、Bashでの設定 -方法を説明します。 + 環境変数'PATH'や'INFOPATH'を設定することで、YACASL2が使いやすくなります +。 2.8.1 'PATH'の設定 ------------------ - 'PATH'にYACASL2の実行ファイルのインストール先を追加すると、ディレクトリ -ーの指定を省略して'casl2' 'comet2' 'dumpword'を実行できます。例えば、初 -期設定のまま実行ファイルを'~/bin'にインストールしたときは、次のコマンド -で設定できます。 + 'PATH'にYACASL2の実行ファイルのインストール先が含まれている場合は、ディ +レクトリーの指定を省略して'casl2'などの実行ファイル名を指定できます。 +'PATH'は、次のコマンドで確認できます。 - $ PATH=$PATH:~/bin && export PATH + $ echo $PATH - 環境変数の設定は、シェルの初期設定ファイルに追加することでログインした -あと自動的に反映されるようになります。Bashでは'~/.bashrc'が初期設定ファ -イルです。次のコマンドで追加できます。 + YACASL2のインストール先の初期設定である'~/bin'ディレクトリーは、OSイン +ストール時に'PATH'に含まれている場合もあります。含まれていない場合は、次 +のコマンドで'PATH'に追加できます。 - $ echo ’PATH=$PATH:~/bin && export PATH’ >>~/.bashrc + $ PATH=$HOME/bin:$PATH; export PATH + + '~/.profile'や'~/.bashrc'などの初期化ファイルに'PATH'への追加を設定して +おけば、YACASL2のコマンド実行時に常にディレクトリーの指定を省略できます +。 次は、'$PATH'に'~/bin'が二重に追加されることを防ぐ書き方です。 + + case ":${PATH}:" in + *":${HOME}/bin:"*) ;; + *) export PATH="${HOME}/bin:${PATH}" ;; + esac 2.8.2 'INFOPATH'の設定 ---------------------- - 'INFOPATH'にYACASL2のInfoファイルをインストールしたディレクトリーを追加 -すると、ディレクトリーの指定を省略して'casl2' 'comet2' 'dumpword'を実行 -できます。例えば、初期設定のままInfoファイルを'~/share/info'にインストー -ルしたときは、次のコマンドで設定できます。 + 環境変数'INFOPATH'とInfoが適切に設定されていれば、次のコマンドで +YACASL2のInfoを表示できます。 + + $ info yacasl2 + + 'INFOPATH'にYACASL2のInfoファイルをインストールしたディレクトリーの追加 +は、次のコマンドでできます。なお、YACASL2のInfoファイルインストール先の +初期設定は、'~/.local/share/info'です。 - $ INFOPATH=$INFOPATH:~/share/info && export INFOPATH + $ INFOPATH=$HOME/.local/share/info:$INFOPATH; export INFOPATH - '~/.bashrc'には次のコマンドで追加できます。 + '~/.profile'や'~/.bashrc'などの初期化ファイルに'INFOPATH'への追加を設定 +しておけば、常にYACASL2のInfoを表示できます。 次は、'$INFOPATH'に +'~/.local/share/info'が二重に追加されることを防ぐ書き方です。 - $ echo 'INFOPATH=$INFOPATH:~/share/info && export INFOPATH' >>~/.bashrc + case ":${INFOPATH}:" in + *":${HOME}/.local/share/info:"*) ;; + *) export INFOPATH="${HOME}/.local/share/info:${INFOPATH}" ;; + esac -- 2.47.3