MHC -- Message Harmonized Calendaring system.

                        Yoshinari Nomura

Created: 1999/09/01
Revised: 2000/09/25 02:19:32


** カレントバージョンを利用する際の注意

・ emacs 19.x には対応していません。

・ TODO の仕様は、今後変更される可能性がありますので、
     データの互換性がなくなるかもしれません。

・ X-SC-Next: で 1ファイルに複数のアーティクルが書ける機能も
   仕様変更される予定です。

・ C-cC-c 時のコンフリクトチェックがまだありません。

・ C-cC-c 時のチェックが甘いです。
    + X-SC-Subject がない
    + X-SC-Day: X-SC-Cond: の両方に何もない
    + X-SC-Duration: に間違った範囲を指定する
   等、一度もスケジュールに現れないような場合に、迷子になります。

** はじめに:

MHC は、ほとんどの予定を電子メールで受け取るような人のためにデザインさ
れました。MHC を使うと、簡単に電子メールから予定の情報を取り込むことが
できます。

最新版のパッケージは、以下から入手できます:
 http://www.quickhack.net/mhc/

MHC は以下のような特長をもっています:

+ 取り扱いやすいシンプルなデータ構造
+ UNIX と Windows のマルチプラットホームサポート
+ 予定の柔軟な記述
+ 分かりやすく、強力な予定の記述法。
  各予定は、以下のような情報を保持することができます:

    日付, サブジェクト, 開始/終了時間 (なくてもいい)
    アラーム,
    複数のカテゴリ,
    繰り返しのルール,
    繰り返しの期間,
    繰り返しから例外的に外したい日付
    繰り返しに、例外的に加えたい日付
    覚書き、予定発生の元になったメール。

+ コマンドライン, emacs, GUI, Web といった複数のユーザインターフェース
  MHC は現在、以下のようなインターフェースを提供しています:

    + Mew や Wanderlust と協調して動く Elisp パッケージ  (mhc.el)
    + Ruby/Gtk で記述された GUI カレンダー (gemcal)
    + CGI ベースの Web インターフェース    (web-mhc)
	(パッケージには含まれてません。http://mhc.hauN.org/web-mhc/ 参照)
    + コマンドラインでの予定一覧表示ツール (mscan)

MHC は、予定の情報を MH と同じ形式で保存します。そのため、上記以外のツー
ルからでも、メールと似た操作をすることができます。自分独自のスクリプトを
書くことも簡単です。

** 動作環境:

MHC は、以下のようなコマンドを利用しています。

gemcal        -- Ruby 1.4.x + ruby-gtk 0.2[23]
mhc-sync      -- Ruby 1.4.x + ssh
palm2mhc      -- Ruby 1.4.x + pilot-link のライブラリ
mhc2palm      -- Ruby 1.4.x + pilot-link のライブラリ
today         -- Ruby 1.4.x
mhc.el        -- Mew/Wanderlust/Gnus/cmail が動く環境

上記のいずれも UNIX と Windows9x で動くようにしているつもりです。

** ディレクトリの内容:

today             -- 今日の予定を 表示/メール するツール
gemcal            -- ruby/gtk による GUI デスクトップカレンダー
mhc-sync          -- 2つの PC 間でデータ同期を取るコマンド。
mhc2palm          -- mhc から Palm/WorkPad へのデータ転送
palm2mhc          -- Palm/WorkPad から mhc へのデータ転送
emacs/            -- Mew/Wanderlust/Gnus を予定入力・閲覧としても
                     使えるようにするパッケージ
samples/          -- 休日・記念日のサンプル
ruby-ext/         -- MHC 形式の予定を扱うライブラリ
		     (gemcal, palm2mhc, mhc2palm からも使用)
xpm/              -- gemcal で使っているボタンの絵。
experimental/     -- 実験コード
00readme.jis      -- このファイル
00readme.w32.jis  -- このファイル
00copyright       -- 著作権表示
00changes         -- 更新履歴

** インストール:

キュメント類がまだ整備されていません。

emacs 関係は、emacs/ の下で、Makefile を編集して、
make を叩くとコンパイルできます。

その他の ruby 関係は、トップディレクトリから、

  ruby configure.rb 
  ruby make.rb
  ruby make.rb install

と叩いて下さい。pilot-link ライブラリがシステムに入っていない場合は、

  ruby configure.rb --disable-palm

として下さい。この場合、mhc2palm palm2mhc は使えません。

** さらなる情報:

MHC に関するお話をするメイリングリストを上げました。
(議論は日本語で交されています。)

mhc-ctl@quickhack.net に

    subscribe Your Name (例: subscribe Yoshinari Nomura)

のように書いたメールを送って下さい。(入会の確認メールが来ます)
コメント・バグレポート等は、

    mhc@quickhack.net

宛てか nom@quickhack.net に下さい。また、iij の大原さんが、mhc の CGI 
インターフェースと、mhc のページを作成されています。合せて御覧下さい。

    web-mhc 置場   http://mhc.hauN.org/web-mhc/

MHC の最新版は、下記から入手できます:
  http://www.quickhack.net/mhc/

-- 00readme.jis ends here.