readme

### はじめに

このバージョンから、plumのドキュメントはHTML (Hyper Text Markup Language)で書くことにしました。 これは主に文字コードの問題を回避するためです。 OSを問わないplumでは様々な環境で実行することができますが、 ドキュメントはそれぞれの環境で異なった文字コードで書かないといけません。 readme.sj、readme.euc、readme.jisのように同じ内容の複数の ファイルを用意してもいいのですが、 管理するのも大変なのでやめました。
HTMLなので、当然ながらブラウザで見ることになると思いますが、 中には、いちいちブラウザなんて使ってられない、という人も多いと思います。 そのため、すべてのドキュメントはHTMLを直接見ても なるべく読むことができるように書いてあります。 ただし、漢字コードはJIS、改行コードはLFのみとなっています。 これが表示できない場合はsupportディレクトリの cnvcodeというプログラムを使って変換して下さい。
モジュールのドキュメントはそれぞれのモジュール自体に書かれています。 モジュールのドキュメントもHTMLで、モジュール自体をブラウザで表示すると モジュールに書かれたドキュメントだけが表示されるようになっています。 ただしモジュールの拡張子は「.plm」なので、そのままではブラウザから HTMLと認識されません。
Windowsを使っているなら、このディレクトリにあるplum.regというファイルか html.regというファイルをダブルクリックして下さい。 そうすると「.plm」という拡張子がHTMLとして認識されるようになります。 plum.regでは「.plm」をPLUMモジュールとして、 html.regでは「.plm」をHTMLドキュメントとして関連付けます。
また、UNIXではこのディレクトリにある.mime.typesというファイルを ホームディレクトリにコピー(すでに.mime.typesが存在する場合はそれに追加) して下さい。これで少なくともNetscape Navigatorでは「.plm」がHTML として認識されるようになります。

### ファイル

plumに付属しているファイルの一覧です。

plum
  plum本体です。
plum-default.conf
  plumのデフォルトの設定ファイルです。
plum-example.conf
  設定ファイルの書き方の例です。
plum-dump.conf
  システム情報表示用の設定ファイルです。
doc/
  readme.html
    このファイルです。
  plum.html
    plumについての解説です。
  conf.html
    設定ファイルの書き方などの解説です。
  module.html
    plumのモジュールの解説です。
  history.html
    plumの履歴です。
  program.html
    モジュールの作り方などの解説です。
  varsub.html
    モジュールで利用できる変数やサブルーチンの解説です。
  tutorial.html
    実際にモジュールを作りながら解説を行います。
  plum.reg
    Windowsで拡張子「.plm」をHTMLと認識させるレジストリの設定です。
  html.reg
    Windowsで拡張子「.plm」をHTMLと認識させるレジストリの設定です。
  .mime.types
    Netscape Navigatorで「.plm」をHTMLと認識させるMIMEの設定です。
module/
  plumのモジュールがあります。
support/
  plumのデバッグやドキュメント作成のために作ったツールなどがあります。

### 配布場所

plumの最新バージョンは以下のところから入手することができます。

- ftp://ftp.eds.ecip.nagoya-u.ac.jp/pub/net/irc/pirc/plum/
- ftp://ftp.madoka.org/pub/plum

perlは以下のところから入手することができます。

- ftp://ftp.lab.kdd.co.jp/pub/lang/CPAN/
- ftp://ftp.mei.co.jp/free/Languages/perl/CPAN/
- ftp://ftp.win.or.jp/pub/lang/CPAN/
- ftp://ftp.chiba-u.ac.jp/pub/lang/CPAN/
- ftp://ftp.jaist.ac.jp/pub/lang/perl/CPAN/
- ftp://ftp.eos.hokudai.ac.jp/pub/CPAN/
- ftp://ftp.hipecs.hokudai.ac.jp/pub/LANG/perl/CPAN/
- ftp://ftp.ccs.dendai.ac.jp/pub/lang/perl/CPAN/
- ftp://ftp.st.ryukoku.ac.jp/pub/lang/perl/CPAN/
- ftp://ftp.riken.go.jp/pub/lang/perl/CPAN/

IRCクライアントは以下のところから入手することができます。

#### Windows 95/98/NT

- CHOCOA
- IRCW
- Microsoft Chat
- MultiChat
- MuriChat
- mIRC
- TakIRC
- Torochat
- WoolChat

#### Windows CE

- irCE

#### Macintosh

- ircle
- IRcat
- Macoa

#### UNIX

- irc
- ircII

#### Emacs/Mule

- irchat-jp
- irchat-PJ

#### Tcl/Tk

- zircon

### 連絡先

plumの使い方や設定がよくわからない、動作がおかしい、 新しい機能やモジュールを追加してほしい、 などなどplumについての質問や要望はplumメーリングリストで受け付けます。 メーリングリストへ登録を希望される方は、本文に

    # subscribe

と書いたメールを以下のアドレスへ送って下さい。
メーリングリストへの投稿は以下のアドレスへ送って下さい。
plumメーリングリストについての質問などは以下までお願いします。