dcmodel に関する諸々の打ち合わせ 2005/06/02

cvsroot から export でタグを指定し, 展開する.
展開したディレクトリ内部で (ドキュメントをなんらかの手段で自動生成する必要があるのであれば) ドキュメント群を生成する. 原則的に, それらをそのまま Web 上で公開するものとして利用.
生成されたドキュメントごと, tar で TGZ ファイルにする.
最終的にはソースが格納されたディレクトリと TGZ ファイルを公開する.

打ち合わせの際のメモ書きや, 個人の (他に適当な置き場の無い) モデルに関するメモ書きは, プロジェクト直下の memo ディレクトリに置く. 書式は固定しない. ファイル名のルールのみは固定する. 以下の URL の「memo/作業履歴ディレクトリ」参照のこと.

以下で公開される, dcmodel-thum.rb を用いる.

各プロジェクトページで, 各項目の並べ方をそろえる.

日本語と英語の両方を作成する.

スタイルシートは

を用いる.

外向けに公開する部分に関しては, RD で書くにせよ HTML で書くにせよ上記のスタイルシートを利用すること.

dcmodel 関連のメモ書きなど, RD で記述する場合の書法の手引きが必要. dcmodel/doc 以下に作成する.

ドキュメントの作成を, どこまでは RD を強制し, どこから HTML などのほかの書式を許容すると良いのかはまだ分かっていない.

dcmodel 関連のドキュメント整備

RD のインストール方法
最低限 RD
- それを読むだけで最低限の dcmodel 関連 RD と Web ページが作成出来るような手引き
  - RD の書き方
  - HTML の作成方法
    - Makefile サンプル

rpm を dennou で作るのは困難であると予想されるので, rpm の自動生成はとりあえずあきらめる. (開発グループに rpm を用いるユーザが居ないというのも原因のひとつ).

deb パッケージも現在のメンテナである小高さんにとって自動化するためのツールを作成する方が手間であるとの話から, 自動化はあきらめる. deb パッケージをメンテナンスするよりは Mkinclude や Config.mk などの生成 or 編集のすべを鍛える方にエネルギーを傾ける.

Mkinclude や Config.mk を自動生成するために良く用いられるスクリプトとして「 configure 」があり, その configure を自動生成するツールとして autoconf がある.

しかし autoconf はその習熟に時間がかかる (敷居が高い) ため, dcmodel でみんなで利用するには少々困難である.

現状では最低限, Mkinclude や Config.mk を編集するための手引きを整える ということのみ義務とする.

自動化に用いる Makefile が複雑になっているため, 役割に応じて Makefile を分割すべきかもしれない.

議論に十分な時間を割けなかったので, 次回に持ち越し.

今回の議論では, 以下のようになっていると良さそうという意見にとどまった.

gtool4/Makefile
       Makefile.rd2html
       Makefile.export

       html/Makefile
       gt4f90io/Makefile
       gt4ncconf/Makefile

詳しいことは記述せず, 各 Makefile へのリンクに近いもののみ記述

# 具体例

all: html

html:
        make -f Makefile.rd2html

export:
        make -f Makefile.export

(議論不十分) gtool4 直下の rd を html 化

(議論不十分) gtool4/gt4f90io/Makefile や gtool4/gt4ncconv/Makefile に関するヘルプメッセージの出力, もしくはそれらの Makefile を直接読み込んでしまう.