1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
|
<!--
$FML: chapter.onhost.sgml,v 1.3 2005/09/18 13:55:56 fukachan Exp $
$jaFML: chapter.onhost.sgml,v 1.8 2003/04/15 14:51:46 fukachan Exp $
-->
<chapter id="usage.onhost">
<title>
What Can You Do On The Mailing List Server
</title>
<para>
On the host which serves ML driver, you can use CUI (makefml and fml)
and edit all configuration files as you like. It implies you are the
greatest administrator :)
</para>
<para>
"makefml" command of &fml8; is same as &fml4; as could as possible to
preserve compatibility.
</para>
<para>
See
<link linkend="changes.cui">
<xref linkend="changes.cui">
</link>
on the detail of the difference.
</para>
<sect1 id="usage.onhost.priviledge">
<title>
On The Host
</title>
<para>
You need no confirmation in using makefml.
</para>
<para>
Person who can login the host of mailing list server has priviledge
for all ML's on the host. So, He/She can edit all configuration
files.
</para>
<para>
But He/She may do wrong operations.
</para>
<para>
To avoid careless wrong operations, in usual cases you should use CUI
(makefml or fml) to configure fml. Of course you can edit files
directly if you can understand fml structures. By default we recommend
you should use CUI always on the host.
</para>
<para>
"fml" command is same as "makefml" command except for the argument
order.
<screen>
makefml COMMAND ML OPTIONS
fml ML COMMAND OPTIONS
</screen>
Please either as you like.
</para>
</sect1>
<sect1 id="usage.commandpolicy">
<title>
Policy Of Command Creation
</title>
<para>
&fmldevel; provides a different command for each function. Its policy
makes the number of commands infinite. So, except for some special
cases, we should unify all functions into makefml/fml command since
such commands can be shared among CUI, GUI and commmnd mail.
</para>
<sect2>
<title>
Operation May Modify The Specific ML (Read + Write)
</title>
<para>
We should implement sub-command of makefml/fml when some operation may
modify the specific ML.
</para>
</sect2>
<sect2>
<title>
Operation For Read Only Data Of The Specific ML (Read Only)
</title>
<para>
We should implement it as a makefml/fml command since it is related to
the specific ML.
</para>
</sect2>
<sect2>
<title>
Show The General Data (Read Only)
</title>
<para>
If the data is not related to the specific ML, for example,
see the module manual, aliases on the host,
we implement specific commands other than makefml/fml.
This command name begins with "fml" prefix.
<screen>
fmladdr [-n]
fmlalias [-n]
fmldoc MODULE
fmlconf [-n] ML
</screen>
</para>
</sect2>
<sect2>
<title>
ML Specific But A Command Wrapper
</title>
<para>
PGP / GPG related command (e.g. fmlpgp) is very command speicific.
So, it looks difficult to incorporate them into "makefml" and "fml"
framework. So we implement it as another command such as fmlpgp,
fmlgpg, ...
</para>
</sect2>
<sect2>
<title>
Misc
</title>
<para>
We implement specific commands other than makefml/fml.
This command name begins with fml prefix.
</para>
<para>
For example, "fmlhtmlify" is a conveter from text to html form.
This command is used to convert both fml spool and MH folders.
<screen>
fmlhtmlify [-I DIR] $src_dir $dst_dir
</screen>
</para>
</sect2>
</sect1>
<sect1 id="usage.command.line.options">
<title>
Common Command Line Options
</title>
<para>
Programs under libexec/ and bin/ supports
the following common command line options.
<screen>
--debug
--help
-c file
-o key=value
</screen>
Use -c to specify non default main.cf path.
-o overwrites configuration variables.
Plural -o are acceptable.
<screen>
-o key1=value1 -o key2=value2
</screen>
</para>
</sect1>
§.usage.makefml;
§.usage.fml;
§.usage.fmladdr;
§.usage.fmlalias;
§.usage.fmlconf;
§.usage.fmldoc;
§.usage.fmlhtmlify;
<sect1 id="usage.recipes">
<title>
Recipes
</title>
§.usage.onhost.recipes;
</sect1>
</chapter>
|
