Changeset 6397333 for general/sysutils/fcron.xml

Timestamp:

09/22/2018 11:32:07 PM (6 years ago)

Author:

Bruce Dubbs <bdubbs@…>

Branches:

basic

Children:

4de7ca7

Parents:

acf7e2c

Message:

Convert internal like to external links for BLFS packages not in
the Basic book.

Reorder some chapters.

Merge System V and systemd sections so both are always displayed
with proper attribution for system type.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/basic@20524 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• general/sysutils/fcron.xml (modified) (11 diffs)

general/sysutils/fcron.xml

@@ -14 +14 @@
 ]>
 
-<sect1 id="fcron" xreflabel="Fcron-&fcron-version;">
+<sect1 id="fcron" xreflabel="fcron-&fcron-version;">
   <?dbhtml filename="fcron.html"?>
 
@@ -58 +58 @@
       </listitem>
     </itemizedlist>
-<!--
-    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
-    <itemizedlist spacing="compact">
-      <listitem>
-        <para>
-          Required patch:
-          <ulink url="&patch-root;/fcron-&fcron-version;-sendmail_upstream-1.patch"/>
-        </para>
-      </listitem>
-    </itemizedlist>
--->
+
     <bridgehead renderas="sect3">Fcron Dependencies</bridgehead>
-<!--
+
     <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional">An <xref linkend="server-mail"/>,
-    <ulink url="../postlfs/editors.html">text editor</ulink> (default is
-    <command>vi</command> from the <xref linkend="vim"/> package),
-    <xref linkend="linux-pam"/>, and
-    <xref linkend="docbook-utils"/>
+    <para role="optional">
+      A mail server such as <xref linkend="postfix"/>,
+      A text editor
+        (default is <command>vi</command> from the vim package),
+      <ulink url="&blfs-book;/postlfs/linux-pam.html">linux-pam</ulink>, and
+      <ulink url="&blfs-book;/postlfs/pst/docbook-utils.html">docbook-utils</ulink>
     </para>
--->
+
     <para condition="html" role="usernotes">User Notes:
     <ulink url="&blfs-wiki;/fcron"/></para>
@@ -87 +78 @@
     <title>Installation of Fcron</title>
 
-    <para id="fcron-syslog" revision="sysv"><application>Fcron</application>
+    <para id="fcron-syslog"> For System V versions of LFS, 
+    <application>fcron</application>
     uses the cron facility of <command>syslog</command> to log all messages.
     Since LFS does not set up this facility in
     <filename>/etc/syslog.conf</filename>, it needs to be done prior to
-    installing <application>Fcron</application>. This command will append the
+    installing <application>fcron</application>. This command will append the
     necessary line to the current <filename>/etc/syslog.conf</filename>
     (perform as the <systemitem class='username'>root</systemitem> user):</para>
 
-    <indexterm zone="fcron fcron-syslog" revision="sysv">
+    <indexterm zone="fcron fcron-syslog">
       <primary sortas="e-etc-syslog.conf">/etc/syslog.conf</primary>
     </indexterm>
 
-<screen role="root" revision="sysv"><userinput>cat &gt;&gt; /etc/syslog.conf &lt;&lt; "EOF"
+<screen role="root"><userinput>cat &gt;&gt; /etc/syslog.conf &lt;&lt; "EOF"
 <literal># Begin fcron addition to /etc/syslog.conf
 
@@ -107 +99 @@
 EOF</userinput></screen>
 
-    <para revision="sysv">The configuration file has been modified, so reloading
+    <para>The configuration file has been modified, so reloading
     the <command>sysklogd</command> daemon will activate the changes (again as
     the <systemitem class='username'>root</systemitem> user).</para>
 
-<screen role="root" revision="sysv"><userinput>/etc/rc.d/init.d/sysklogd reload</userinput></screen>
+<screen role="root"><userinput>/etc/rc.d/init.d/sysklogd reload</userinput></screen>
 
     <para>For security reasons, an unprivileged user and group for
-    <application>Fcron</application> should be created (perform as the
+    <application>fcron</application> should be created (perform as the
     <systemitem class='username'>root</systemitem> user):</para>
 
@@ -123 +115 @@
     commands:</para>
 
-<screen revision="sysv"><userinput>./configure --prefix=/usr          \
+    <para>For System V based systems:</para>
+
+<screen><userinput>./configure --prefix=/usr          \
             --sysconfdir=/etc      \
             --localstatedir=/var   \
@@ -131 +125 @@
 make</userinput></screen>
 
-<screen revision="systemd"><userinput>./configure --prefix=/usr          \
+    <para>For systemd based systems:</para>
+
+<screen><userinput>./configure --prefix=/usr          \
             --sysconfdir=/etc      \
             --localstatedir=/var   \
@@ -150 +146 @@
   <sect2 role="commands">
     <title>Command Explanations</title>
-<!--
-    <para><command>autoconf</command>: This command is required to rebuild
-    <filename>configure</filename> using the fixed input file.</para>-->
 
     <para><parameter>--without-sendmail</parameter>: By default,
-    <application>Fcron</application> will attempt to use the
-    <command>sendmail</command> command from an <!--<xref linkend="server-mail"/>-->
+    <application>fcron</application> will attempt to use the
+    <command>sendmail</command> command from a mail server sucj as the 
+    <xref linkend="postfix"/>
     package to email you the results of the <command>fcron</command> script.
     This switch is used to disable default email notification. Omit the switch
@@ -166 +160 @@
     installation of the bootscript included with the package.</para>
 
-    <para revision="sysv"><parameter>--with-systemdsystemunitdir=no</parameter>:
+    <para><parameter>--with-systemdsystemunitdir=no</parameter>:
     This prevents building the <application>systemd</application> units, which
     are not needed for a <application>SYS V</application> system.</para>
@@ -173 +167 @@
     This switch allows you to set the default text editor.</para>
 
-    <para><option>--with-dsssl-dir=<replaceable>&lt;/path/to/dsssl-stylesheets&gt;</replaceable></option>:
-    May be used if you have <!--<xref linkend="docbook-utils"/>--> installed.
+    <para>
+      <option>--with-dsssl-dir=<replaceable>&lt;/path/to/dsssl-stylesheets&gt;</replaceable></option>:
+    May be used if you have 
+    <ulink url="&blfs-book;/postlfs/pst/docbook-utils.html">docbook-utils</ulink>
+    installed.
     Currently, the dsssl stylesheets are located at
-    <filename class="directory">/usr/share/sgml/docbook/dsssl-stylesheets-1.79</filename>.</para>
+    <filename class="directory">/usr/share/sgml/docbook/dsssl-stylesheets-1.79</filename>.
+    </para>
 
   </sect2>
@@ -234 +232 @@
 
     <sect3  id="fcron-init">
-      <title><phrase revision="sysv">Boot Script</phrase>
-             <phrase revision="systemd">Systemd Unit</phrase></title>
-
-      <para revision="sysv">Install the
+      <title>Boot Script or Systemd Unit</title>
+
+      <para>For System V bases systems, install the
       <filename>/etc/rc.d/init.d/fcron</filename> init script from the
       <xref linkend="bootscripts"/> package.</para>
 
-      <para revision="systemd">Enable <application>fcron</application> to start
+<screen role="root"><userinput>make install-fcron</userinput></screen>
+
+      <para>For systemd based systems, enable <application>fcron</application> to start
       at boot using the previously installed systemd unit.</para>
 
@@ -248 +247 @@
       </indexterm>
 
-<screen role="root" revision="sysv"><userinput>make install-fcron</userinput></screen>
-
-<screen role="root" revision="systemd"><userinput>systemctl enable fcron</userinput></screen>
+<screen role="root"><userinput>systemctl enable fcron</userinput></screen>
 
     </sect3>