[ English | Japanese ] [ 地球流体電脳倶楽部 / SPMODEL プロジェクト / SIGEN ]

spmodel 公開ディレクトリとライブラリ保守の手引

この文書について

この文書は ftp/arch/spmodel ディレクトリのメンテナンスの手引きである.

公開ディレクトリ編集時の注意

必ず group を変更してから作業にあたること. ファイル/ディレクトリは group writable にする.

$ sg spmodel
$ umask 002

ディレクトリ構成とファイルの置き方

ディレクトリ構成

TEBIKI.index.rd      TEBIKI の目次
TEBIKI.index.htm     上記 RD より生成
TEBIKI.debian.rd     debian パッケージ置き場管理の手引き
TEBIKI.debian.htm    上記 RD より生成
TEBIKI.spmodel.rd    ディレクトリ・ライブラリメンテナンスの手引き
TEBIKI.spmodel.htm   上記 RD より 生成

Makefile             公開版生成, Log 作成用の Makefile
Makefile.rd2html     *.htm, *.htm.en 生成用. 
                     Makefile より include される.

index.rd             目次ファイル作成用 rd ファイル
index.htm            目次ファイル (index.rd から作成)
index.htm.en         目次ファイル (index.rd から作成)
html                 ホームページ関連資料置場
                     needed, goal, licence, acknowledge,
                     member, paper, sample, usage が置かれている.
gallery              ギャラリー置き場


cvsroot              cvsroot
spml                 spml ライブラリ(CVS 作業領域)
spml-X.Y.Z.tar.gz    spml ライブラリ現行安定版の tar.gz
spml.tar.gz          spml ライブラリ現行安定版の tar.gz への symlink

debian               spml debian パッケージ置場
                     管理のについては TEBKI.debian.rd を参照

1d-cyclic-e          サンプル(1D,周期境界,フーリエ)
2d-channel-esc       サンプル(2D,水路,sin/cos)
2d-channel-et        サンプル(2D,水路,フーリエ&チェビシェフ)
2d-channel-ee        サンプル(2D,水路,フーリエ)
2d-sphere-w          サンプル(2D,球面,球面調和関数)
3d-shell-wt          サンプル(3D,球殻,球面調和関数&チェビシェフ)
3d-sphere-wa         サンプル(3D,球面,球面調和関数&任意)

old                  過去の古いソース等
ispack-f90           ispack の f90 インターフェース(開発終了)
                     old/ispack-f90-20011206/ へのリンク

公開版作成の手順

spml ライブラリのタグの付け

作業ディレクトリにおいてタグ付けを行なう. タグ名は "spml-(version名)" とする. また, ChangeLog は cvs の log より生成しているので, タグ付けの 前に ChangeLog を生成し, commit しておくこと.

例えばバージョン 0.1 の場合, 作業領域のトップディレクトリで

$ cvs tag spml-0_1

とする.

cvs の仕様上, タグ名に "." (ピリオド) を含むことができないことに注意.

展開の準備

展開のため, グループユーザと umask を設定する

$ sg spmodel
$ umask 002

展開するタグを確認する. cvs の作業コピー内で, 以下のように確認されるの がタグである. 例えば configure について表示させた場合には

$ cvs log configure
      :
   symbolic names:
     spml-0_4_2: 1.11
     spml-0_4_1_2: 1.8
     spml-0_4_0_1: 1.8
     spml-0_3_0_10: 1.6
      :

となる symbolic names: で表示されるのがタグである.

展開作業

先ずタグ付けした版を export する. たとえばタグとして spml-X_Y_Z を export する際には

$ export CVSROOT=/GFD_Dennou_Club/ftp/arch/spmodel/cvsroot
$ cvs export -r "spml-X_Y_Z" -d spml-X.Y.Z spml

となる. ちなみに cvs のコマンドオプションは,

$ cvs export -r "タグ" -d [出力先ディレクトリ] [モジュール名]

としている. この順でなければ動作しないので注意されたい.

次に tar.gz を作成する.

$ tar cvzf spml-X.Y.Z.tar.gz spml-X.Y.Z

最後に symlink を張り直し, 古い版とタグのディレクトリを削除する.

$ rm spml.tar.gz
$ ln -s spml-X.Y.Z.tar.gz spml.tar.gz
$ rm spml-X.Y.Y.tar.gz(古い版の削除)
$ rm -rf spml-X.Y.Z

サンプルプログラムの更新

サンプルプログラムを更新する場合は, 各サンプルプログラムのトップディレ クトリで cvs update を行う.

例えば 2d-channel-esc/shallow-equator/ 以下のプログラムを更新した場合には

$ sg spmodel
$ umask 002
$ cd 2d-channel-esc/
$ cvs update -dP

としておく.


SPMODEL Development Group / GFD Dennou Staff dcstaff@gfd-dennou.org
Last Updated: 2007/12/05, Since: 2004/01/26