							-*- Indented-text -*-
# CML Documents.
# Copyright 1993-1998 (C) SAITOH-Ely-Yasuhiro.
# All rights reserved.



メイリングリストの設定
**********************
　メイリングリストを設定するには、附属のコマンド addml を使います。
　Configure で設定したインストールディレクトリ($DRIVER)に移動し、MLの管理者
のアカウント(*1)で、

	  % addml MLの名前

と入力すると、cmld, cmdt および cmas を起動するためのエントリを自動的に作成
します。作成が終れば、下記のようなメッセージを出力しますので、メッセージに
従って /etc/aliases(*2) に必要なエントリを追加して下さい。

例えば、cmld が /usr/local/etc にインストールされている場合に、 hogehoge ML 
を作成する場合、次のようになります。 
============================================================================
% addml hogehoge *** Make mailing list entry tool (addml version XXX) ***
*** End of make mailing list entry ***

Add this entry to /etc/aliases, and exec 'newaliases' command.
==============================================================
hogehoge-request: 'E-mail address of hogehoge ML admin.'
hogehoge: :include:/usr/local/etc/exe/hogehoge
hogehoge-control: :include:/usr/local/etc/exe/hogehoge-control
hogehoge-dist: :include:/usr/local/etc/hogehoge/hogehoge-list
hogehoge-digest-dist: :include:/usr/local/etc/hogehoge/hogehoge-digest
%
============================================================================

*1 ML の管理者のアカウント
++++++++++++++++++++++++++
　addml コマンドでＭＬを追加する時は、root などのアカウントではなく、追加す
るＭＬを管理する人のアカウントで実行して下さい。理由については、管理のコツ
の項で後述します。

*2 /etc/aliases
+++++++++++++++
　システムによっては /usr/lib/aliases や、さらには他の名前かも知れませんが、
ここでは、/etc/aliases としておきます。


/etc/aliases の設定
===================
　addml のメッセージに従って /etc/aliases に必要なエントリを追加します。こ
の作業だけは root の権限が必要ですので、もし、あなたに root の権限が与えら
れていない場合は、以下の内容を root 権限を持つ人に設定してもらって下さい。

　設定する内容の詳細については、以下の通りです。

	hogehoge-request:	…　ＭＬの管理者の別名
	hogehoge:		…　ＭＬのあて名
	hogehoge-dist:		…　メンバーリストの別名
	hogehoge-digest-dist	…　定時配送モード用するメンバーファイルの
				    別名

さらに、cmas を使用する場合は

	hogehoge-control:	…　ＭＬ制御のあて名

が必要です。使用しない場合は必要ありません。

また、/etc/aliases の中に、

	nobody: /dev/null

というエントリがなければ必ず追加して下さい。cmas の自動で配送モードを変更す
る機能を用いる場合にこのエントリがないと、自動機能が正しく動かないばかりで
なく、沢山のエラーメールを発生させる可能性がありますので、充分注意して下さ
い。

　以下に、それぞれについての詳細を説明します。

hogehoge-request
----------------
　ＭＬを管理する人のアドレスを書いて下さい。hogehogeメイリングリストの管理
者が foo@dom.jp さんであれば、

   hogehoge-request: foo@dom.jp

となります。なお、実在のアドレスであれば、cmld 管理マシン上のアドレスである
必要はありません。

hogehoge
--------
　ＭＬ宛に届いたメールを実際に処理するためのエントリです。このエントリは 
addml の指定通りに作成して下さい。 /usr/local/etc/$ML/hogehoge は addml に
より、自動で作成されます。

hogehoge-dist
-------------
　ＭＬで処理された記事を配送するアドレスを記述したファイルのありかを示しま
す。cmas を使う場合は、addml の指定通りに設定して下さい。

　cmas を用いない場合は、addml の指定以外のファイルでも構いません。例えば、 
hogehoge ＭＬの参加者を /etc/ML/hogehoge-list に記述することにするならば、

	hogehoge-dist: :include:/etc/ML/hogehoge-list

となります。記述の方法については後述します。

hogehoge-digest-dist
--------------------
　定時配送モードで送信するメンバーのアドレスを記述するファイルのありかを示
します。必ず addml の指定通りに設定して下さい。

hogehoge-control
----------------
　制御メールを実際に処理するためのエントリです。このエントリは addml の指定
通りに作成して下さい。 /usr/local/etc/ML/hogehoge-control は addml により、
自動で作成されます。

　以上を設定したら、sendmail に対する再登録をお忘れなく（newaliases コマン
ドを実行すればＯＫです）。これで、 root での作業は終了です。


メンバーリストの記述（自動機能を使用しない場合）
-----------------------------------------------
　cmas を用いた会員の自動登録／削除機能を使用せずに、単純にメールを再配送す
る目的だけで CML を運用する場合、hogehoge-dist で指定されたファイルの中身は、

	foo@bar.jp
	hoge@mucha.jp
	   :

のように、送信するアドレスを並べて書くだけでＯＫです。

　ただし、登録は手動でもＭＬメンバーチェック機能だけは使いたいとあいう場合
は、以下の形式である必要があります。

	ダミーの数字 ダミーの配送モード <送信先アドレス>

つまり、

	0 A <foo@bar.jp>
	0 A <hoge@mucha.jp>

という形で記述して下さい。

　定時配送モードで送信したいメンバーがいる場合は、

	ダミーの数字 DGST (配送したい人のアドレス) <nobody>

の形式で記述してください。


CML-3.0 以降を使う場合
----------------------
　CML-3.0 から、メンバーリストの管理方法が変更になりました。内容はメンバー
リストと配送リストを独立して使用するようになったというものです。

　CML-2.5.1 までは、ML名-list という名前のファイルですべてを管理していまし
たが、CML-3.0 から、ML名-member というファイルに従来の形式のリストを作成し、
ML名-list という名前の配送リストは、CML が自動で作成するようになりました。

　上のような手動で管理ファイルを作成される場合は、この点にお気を付け下さい。


メンバーリストの記述（自動機能を使用する場合）
---------------------------------------------
　自動登録／削除機能を用いる場合は、cmas により自動で作成されますので、管理
者が直接編集する必要はありません。

　自動登録機能のみ管理者あてメールに設定している場合（AUTOADD=DONT）は、手
動で登録する必要があります。方法については管理のコツの項で説明します。


メンバーリストの記述（普通のアドレス管理リストからＣＭＬ形式に変換する場合）
----------------------------------------------------------------------------
　about.shift を参照してください。


Config File
***********
　config.default で設定した運用環境は、ＭＬごとに変更することができます。詳
細情報を設定する場合は、 $DRIVER/config.default を、

	$DRIVER/ＭＬの名前/config.ＭＬの名前

というファイルにコピーして設定します。内容については config.default の説明
を参照してください。 

　これでＭＬの設定は完了です。


Charter File
************
　新規登録者にマニュアルなどと一緒に、ＭＬの紹介を送ることができます。紹介
文を、

	$DRIVER/ＭＬの名前/info.ＭＬの名前

として書いておけばＯＫです。なお、漢字を含む場合は、ＪＩＳコードで記述して
下さい。


Batchtime File
**************
　定時配送のスケジュールを記述します。

	$DRIVER/ＭＬの名前/batchtime

というファイルに、HH:SS の形式で記述して下さい。例えば、00:12 と 14:30 に配
送したい場合は、

	00:12 14:30

などと記述してください（区切り記号は任意のものが使用可能です）。

　このファイルがない場合は、03:00 がデフォルトとして自動で設定されます。


Default Digest Mode File
************************
　登録依頼時に、ダイジェストモードで配送するドメインを記述します。

	$DRIVER/ＭＬの名前/defaultdigest

というファイルに、一行に１ドメインずつ、

	niftyserve.or.jp
	pcvan.or.jp

などと記述して下さい。このファイルに記述されたドメインからの登録依頼はダイ
ジェストモードで処理されます。
