<% Include("/hsphere/local/home/terraint/common.phps");%> Alexandria:CVS,Javadoc,ソースコード,ドキュメント管理システム - Alexandria Usage
Alexandria

Alexandria

リファレンス

日本語訳 (Translations)

オリジナル

Command Line

Alexandriaは、alexandriaというスクリプトファイルで起動されます(訳注:Windowsの場合は、alexandria.bat)。このスクリプトファイルは、Alexandriaのホームディレクトリから立ち上げるか、あるいはAlexandriaのホームディレクトリを指定する$ALEX_HOME環境変数を正しく設定した上で起動する必要があります。

ある特定の処理プロセスだけが異なる頻度で実行されるよう、処理を分離することが可能です。JavaDocやJXRといった処理は、buildやtestに比べて実行頻度が少ない事でしょう。Alexandriaには、以下の処理段階があります:

cvs CVSから最新版モジュールを得る
build モジュールのビルドファイルを起動する
javadoc JavaDocsを生成する
jxr クロスリファレンスのJavaコードを生成する
menus Alexandriaのメニューを作成する
test testビルドファイルを起動する
all Alexandriaの全てのステップを起動する
unlock Alexandriaをアンロックする--Alexandriaが処理を失敗した場合、処理の続行を防ぐためのロック用のファイルが作成されます。このオプションでは、このロック用ファイルを削除します


Cron

crontabにAlexandriaを設定し、動作を観察してみましょう(笑)

Cronを使って、JavaDocやJXRといった処理を1日づつ行うのは、とてもよい方法です。一方、buildやtest処理は、CVSから処理するのが良いでしょう。


CVS Intergration

loginfoファイルを使う事で、CVSにAlexandriaを引っ掛ける事が可能です。loginfoには、CVSログエントリが作成されるごとに起動されるべきスクリプトの情報が含まれています。(commitinfoよりloginfoの利用がお奨めです。というのも、commitinfoはコミットされた全てのファイルに対してコールされますが、loginfoの方は、単に各々のログエントリにのみコールされますから)Alexandriaにこのファイルを追加することで、CVSに変更が加えられる毎にモジュールをビルドしたりテストしたりすることが可能となります。Alexandriaは、単純なロックの機能を実装しています。つまり、同時にビルドは起こらなく、複数の変更点があった際に同時に複数のビルドし始めるのをやめます。

# The "loginfo" file controls where "cvs commit" log information
# is sent.  The first entry on a line is a regular expression which must match
# the directory that the change is being made to, relative to the
# $CVSROOT.  If a match is found, then the remainder of the line is a filter
# program that should expect log information on its standard input.
#
# If the repository name does not match any of the regular expressions in this
# file, the "DEFAULT" line is used, if it is specified.
#
# If the name ALL appears as a regular expression it is always used
# in addition to the first matching regex or DEFAULT.
#
# You may specify a format string as part of the
# filter.  The string is composed of a `%' followed
# by a single format character, or followed by a set of format
# characters surrounded by `{' and `}' as separators.  The format
# characters are:
#
#   s = file name
#   V = old version number (pre-checkin)
#   v = new version number (post-checkin)
#
# For example:
#DEFAULT (echo ""; id; echo %s; date; cat) >> $CVSROOT/CVSROOT/commitlog
# or
#DEFAULT (echo ""; id; echo %{sVv}; date; cat) >> $CVSROOT/CVSROOT/commitlog
alexandria build test &



Copyright © 1999-2005, Apache Software Foundation
Translated into Japanese by Tetsuya Kitahata , powered by Terra-International, Inc.
<% orig();%>