QDBM on xyzzy

Table of Contents

  1. QDBM on xyzzyとは
  2. このパッケージで出来ること
  3. インストール
  4. 配布物一覧
  5. 使い方
  6. ライセンスについて
  7. test.l について

1. QDBM on xyzzyとは

xyzzy 上から QDBM-Quick Database Manager http://qdbm.sourceforge.net/ を使うためのパッケージです。

page top

2. このパッケージで出来ること

今のところサポートしている API は以下の通りです。

Depot Basic API
Curia Extended API （一部動かない関数あり）

page top

3. インストール

xyzzy 上から QDBM を使うためには、QDBM 本体のインストールと、QDBM on xyzzy の2つのインストールが必要です。

QDBM 本体のインストールは、QDBM のサイト http://qdbm.sourceforge.net から Windows 用のバイナリパッケージ http://qdbm.sourceforge.net/win/ をダウンロードして、ダウンロードしたファイルを適当なディレクトリに解凍して、中に入っている4つのDLLファイルを $XYZZYHOME に置きます。

作者が動作を確認した QDBM 本体のバージョンは qdbm-1.8.21 です。なるべくなら QDBM 本体のインストールは、合わせた方が無難かと思います。

QDBM on xyzzy のインストール方法は NetInstaller からどうぞ。また、NetInstaller って何？と言う人は、下記のリンクを参考に NetInstaller を導入してください。ここでは NetInstaller の詳しいインストール方法は述べませんので、あらかじめご了承下さい・

NetInstaller を導入しよう http://xyzzy.s53.xrea.com/wiki/?QuickTour%2Fext%2FNetInstaller

page top

4. 配布物一覧

以下に配布物の一覧を示します。あるべきファイルがない場合など、インストールに失敗している可能性があります。その際はアンインストールを行い、再度インストールを行ってください。

配布ファイル一覧

        $XYZZYHOME/site-lisp/qdbm/ 以下にインストールされる配布ファイル

            COPYING.txt
            curia.l
            depot.l
            qdbm.l      
            readme.txt
            test.l

page top

5. 使い方

QDBM は他のアプリケーションから利用される形態のライブラリですので、QDBM on xyzzy もそれ自体をインストールしたからと言って何か特別なアプリケーションが使える、というものではありません。

パッケージとして公開するまでに何か QDBM on xyzzy を使ったアプリケーションを作れればよかったのですが、残念ながらできませんでした。

Cabin とか Villa、Odeum あたりが使えるともっといろいろ使えると思ったんだけど、力量不足で実装には至っていません。気長にお待ち下さい、あるいは他の誰かがやってくれるのを待ってください。

とまぁ、長々と言い訳を書いてしまいましたが、他のコードで使う際には、

(require "qdbm/qdbm")

をコードに含めるだけで済みます。また、修飾子なしで使いたい場合は、さらに

(use-package "qdbm")

も含めてください。

API の詳しい内容については、QDBM のサイトにある QDBM バージョン１基本仕様書 http://qdbm.sourceforge.net/spex.html をご覧下さい。また、実装している API については depot.l や curia.l、qdbm.l をご覧下さい。

page top

6. ライセンスについて

QDBM がGPL2.1を採用していることもあり、本パッケージもそれに倣うことにしました。添付されている COPYING.txt を参照してください。

本パッケージの再配布や改変については Free Software Foundation が公表している GNU General Public License のバージョン2.1あるいはそれ以降の各バージョンの中からいずれかを選択し、そのバージョンが定める条項に従ってください。

また、本パッケージについて、QDBM の作者へのメールや QDBM メーリングリストでの質問は行わないでください。

本パッケージについての質問は、ykaltenative@mue.biglobe.ne.jp までお寄せください。

page top

7. test.l について

test.l に定義されている各関数は、QDBM on xyzzy で実装している Depot API、Curia API の各動作をテストするための関数です。QDBM on xyzzy で何か動かないときがあった場合、この中のテスト関数を使ってどの関数が動かないのかを教えていただけると助かるかも。

現在、以下の関数が定義されています。

qdbm-test-all           ラッパー関数、実装しているDLL内関数全てについてテストする
qdbm-test               実装しているDLL内関数全てについてテストする
qdbm-test-wrapper       ラッパー関数全てについてテストする
qdbm-test-depot         DLL内関数のうち、Depot API についてテストする
qdbm-test-curia         DLL内関数のうち、Curia API についてテストする
qdbm-test-depot-wrapper ラッパー関数のうち、Depot API についてテストする
qdbm-test-curia-wrapper ラッパー関数のうち、Curia API についてテストする

page top

$Id: index.html 7 2005-03-22 14:15:21Z lkpteam $