]> granicus.if.org Git - fcron/commitdiff
added a manpage-foot
authorthib <thib>
Fri, 19 Jul 2002 19:42:22 +0000 (19:42 +0000)
committerthib <thib>
Fri, 19 Jul 2002 19:42:22 +0000 (19:42 +0000)
doc/en/fcron.conf.5.sgml

index f7ba9b22a7a6c7885da42922b6dbf8fda15bca6a..4cc00f53a199a93eaaec2ecf88d756ca318e02d4 100644 (file)
@@ -8,13 +8,14 @@ Foundation.
 A copy of the license is included in gfdl.sgml.
 -->
 
-<!-- $Id: fcron.conf.5.sgml,v 1.3 2002-03-02 17:31:16 thib Exp $ -->
+<!-- $Id: fcron.conf.5.sgml,v 1.4 2002-07-19 19:42:22 thib Exp $ -->
 
 <refentry id="fcron.conf.5">
     <refmeta>
        <refentrytitle>fcron.conf</refentrytitle>
        <manvolnum>5</manvolnum>
-       <refmiscinfo>Fcron &version; <![%devrelease; [ (<emphasis>development</emphasis> release)]]></refmiscinfo>
+       <refmiscinfo>Fcron &version; <![%devrelease; [
+(<emphasis>development</emphasis> release)]]></refmiscinfo>
        <refmiscinfo>&date;</refmiscinfo>
     </refmeta>
     <refnamediv>
@@ -25,68 +26,92 @@ A copy of the license is included in gfdl.sgml.
     <refsect1>
        <title>Description</title>
        <abstract>
-           <para>This page describes the syntax used for the configuration file of <link linkend="fcrontab.1">&fcrontab;</link>(1), <link linkend="fcrondyn.1">&fcrondyn;</link>(1) and <link linkend="fcron.8">&fcron;</link>(8).</para>
+           <para>This page describes the syntax used for the configuration file
+of <link linkend="fcrontab.1">&fcrontab;</link>(1), <link
+linkend="fcrondyn.1">&fcrondyn;</link>(1) and <link
+linkend="fcron.8">&fcron;</link>(8).</para>
        </abstract>
-       <para>Blank lines, line beginning by a pound-sign (#) (which are considered comments), leading blanks and tabs are ignored. Each line in a &fcron.conf file is of the form
+       <para>Blank lines, line beginning by a pound-sign (#) (which are
+considered comments), leading blanks and tabs are ignored. Each line in a
+&fcron.conf file is of the form
  <blockquote>
                <para>name = value</para>
-           </blockquote>
-where the blanks around equal-sign (=) are ignored and optional. Trailing blanks are also ignored.
+           </blockquote> where the blanks around equal-sign (=) are ignored and
+optional. Trailing blanks are also ignored.
 </para>
        <para>The following names are recognized (default value in brackets) :
 <variablelist>
                <title>Valid variables in a fcron.conf file</title>
                <varlistentry>
-                   <term><varname>fcrontabs</varname>=<replaceable>directory</replaceable> (<filename>&fcrontabsdir;</filename>)</term>
+                   <term><varname>fcrontabs</varname>=<replaceable>directory</replaceable> 
+(<filename>&fcrontabsdir;</filename>)</term>
                    <listitem>
                        <para>&Fcron; spool directory</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
-                   <term><varname>pidfile</varname>=<replaceable>file-path</replaceable> (<filename>&fcron.pid;</filename>)</term>
+                   <term><varname>pidfile</varname>=<replaceable>file-path</replaceable> 
+(<filename>&fcron.pid;</filename>)</term>
                    <listitem>
-                       <para>Location of &fcron; pid file (needed by &fcrontab; to work properly).</para>
+                       <para>Location of &fcron; pid file (needed by &fcrontab;
+to work properly).</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
-                   <term><varname>fifofile</varname>=<replaceable>file-path</replaceable> (<filename>&fcron.pid;</filename>)</term>
+                   <term><varname>fifofile</varname>=<replaceable>file-path</replaceable> 
+(<filename>&fcron.pid;</filename>)</term>
                    <listitem>
-                       <para>Location of &fcron; fifo file (needed by &fcrondyn; to communicate with fcron).</para>
+                       <para>Location of &fcron; fifo file (needed by
+&fcrondyn; to communicate with fcron).</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
-                   <term><varname>fcronallow</varname>=<replaceable>file-path</replaceable> (<filename>&etc;/&fcron.allow;</filename>)</term>
+                   <term><varname>fcronallow</varname>=<replaceable>file-path</replaceable> 
+(<filename>&etc;/&fcron.allow;</filename>)</term>
                    <listitem>
                        <para>Location of fcron.allow file.</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
-                   <term><varname>fcrondeny</varname>=<replaceable>file-path</replaceable> (<filename>&etc;/&fcron.deny;</filename>)</term>
+                   <term><varname>fcrondeny</varname>=<replaceable>file-path</replaceable> 
+(<filename>&etc;/&fcron.deny;</filename>)</term>
                    <listitem>
                        <para>Location of fcron.deny file.</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
-                   <term><varname>shell</varname>=<replaceable>file-path</replaceable> (<filename>&shell;</filename>)</term>
+                   <term><varname>shell</varname>=<replaceable>file-path</replaceable> 
+(<filename>&shell;</filename>)</term>
                    <listitem>
-                       <para>Location of default shell called by &fcron; when running a job.</para>
+                       <para>Location of default shell called by &fcron; when
+running a job.</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
-                   <term><varname>sendmail</varname>=<replaceable>file-path</replaceable> (<filename>&sendmail;</filename>)</term>
+                   <term><varname>sendmail</varname>=<replaceable>file-path</replaceable> 
+(<filename>&sendmail;</filename>)</term>
                    <listitem>
-                       <para>Location of mailer program called by &fcron; to send job output.</para>
+                       <para>Location of mailer program called by &fcron; to
+send job output.</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
-                   <term><varname>editor</varname>=<replaceable>file-path</replaceable> (<filename>&editor;</filename>)</term>
+                   <term><varname>editor</varname>=<replaceable>file-path</replaceable> 
+(<filename>&editor;</filename>)</term>
                    <listitem>
-                       <para>Location of default editor used when invoking "fcrontab -e".</para>
+                       <para>Location of default editor used when invoking
+"fcrontab -e".</para>
                    </listitem>
                </varlistentry>
-           </variablelist>
-File-paths and directories are complete and absolute (i.e. beginning by a "/").</para>
-       <para>To run several instances of &fcron; simultaneously on the same system, you must use a different configuration file for each instance. Each instance must have a different <varname>fcrontabs</varname>, <varname>pidfile</varname> and <varname>fifofile</varname>. Then, use <link linkend="fcron.8">fcron</link>(8)'s command line option <parameter>-c</parameter> to select which config file (so which instance) you refer to.</para>
+           </variablelist> File-paths and directories are complete and absolute
+(i.e. beginning by a "/").</para>
+       <para>To run several instances of &fcron; simultaneously on the same
+system, you must use a different configuration file for each instance. Each
+instance must have a different <varname>fcrontabs</varname>,
+<varname>pidfile</varname> and <varname>fifofile</varname>. Then, use <link
+linkend="fcron.8">fcron</link>(8)'s command line option
+<parameter>-c</parameter> to select which config file (so which instance) you
+refer to.</para>
     </refsect1>
 
     <refsect1>
@@ -95,45 +120,38 @@ File-paths and directories are complete and absolute (i.e. beginning by a "/").<
            <varlistentry>
                <term><filename>&etc;/&fcron.conf.location;</filename></term>
                <listitem>
-                   <para>Configuration file for &fcron;, &fcrontab and &fcrondyn; : contains paths (spool dir, pid file) and default programs to use (editor, shell, etc). See <link linkend="fcron.conf.5">&fcron.conf(5)</link> for more details.</para>
+                   <para>Configuration file for &fcron;, &fcrontab and
+&fcrondyn; : contains paths (spool dir, pid file) and default programs to use
+(editor, shell, etc). See <link linkend="fcron.conf.5">&fcron.conf(5)</link> for
+more details.</para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term><filename>&etc;/&fcron.allow;</filename></term>
                <listitem>
-                   <para>Users allowed to use &fcrontab; and &fcrondyn; (one name per line, special name "all" acts for everyone)</para>
+                   <para>Users allowed to use &fcrontab; and &fcrondyn; (one
+name per line, special name "all" acts for everyone)</para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term><filename>&etc;/&fcron.deny;</filename></term>
                <listitem>
-                   <para>Users who are not allowed to use &fcrontab; and &fcrondyn; (same format as allow file)</para>
+                   <para>Users who are not allowed to use &fcrontab; and
+&fcrondyn; (same format as allow file)</para>
                </listitem>
            </varlistentry>
            <varlistentry>
-               <term><filename>&etc;/pam.d/fcron</filename> (or <filename>&etc;/pam.conf</filename>)</term>
+               <term><filename>&etc;/pam.d/fcron</filename> (or
+<filename>&etc;/pam.conf</filename>)</term>
                <listitem>
-                   <para><productname>PAM</productname> configuration file for &fcron;. Take a look at pam(8) for more details.</para>
+                   <para><productname>PAM</productname> configuration file for
+&fcron;. Take a look at pam(8) for more details.</para>
                </listitem>
            </varlistentry>
        </variablelist>
     </refsect1>
 
-    <refsect1>
-       <title>See also</title>
-       <simplelist>
-           <member><link linkend="fcron.8">&fcron;(8)</link></member>
-           <member><link linkend="fcrontab.1">&fcrontab;(1)</link></member>
-           <member><link linkend="fcrontab.5">&fcrontab;(5)</link></member>
-           <member><link linkend="fcrondyn.1">&fcrondyn;(1)</link></member>
-           <member>The HTML version of the documentation, if you are not reading it right now, which is far better than these man pages :)).</member>
-       </simplelist>
-    </refsect1>
-
-    <refsect1>
-       <title>Author</title>
-       <para>Thibault Godouet &email;</para>
-    </refsect1>
+    &manpage-foot;
 
 </refentry>