Changeset 29244b7 for postlfs/filesystems/mdadm.xml

Timestamp:

03/25/2020 09:46:27 PM (4 years ago)

Author:

Pierre Labastie <pieere@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

f716ef4

Parents:

9bd10279

Message:

format filesystems chapter

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22895 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• postlfs/filesystems/mdadm.xml (modified) (7 diffs)

postlfs/filesystems/mdadm.xml

@@ -30 +30 @@
     <title>Introduction to mdadm</title>
 
-    <para>The <application>mdadm</application> package contains administration
-    tools for software RAID.</para>
+    <para>
+      The <application>mdadm</application> package contains administration
+      tools for software RAID.
+    </para>
 
     &lfs91_checked;
@@ -38 +40 @@
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Download (HTTP): <ulink url="&mdadm-download-http;"/></para>
-      </listitem>
-      <listitem>
-        <para>Download (FTP): <ulink url="&mdadm-download-ftp;"/></para>
-      </listitem>
-      <listitem>
-        <para>Download MD5 sum: &mdadm-md5sum;</para>
-      </listitem>
-      <listitem>
-        <para>Download size: &mdadm-size;</para>
-      </listitem>
-      <listitem>
-        <para>Estimated disk space required: &mdadm-buildsize;</para>
-      </listitem>
-      <listitem>
-        <para>Estimated build time: &mdadm-time;</para>
+        <para>
+          Download (HTTP): <ulink url="&mdadm-download-http;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download (FTP): <ulink url="&mdadm-download-ftp;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download MD5 sum: &mdadm-md5sum;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download size: &mdadm-size;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated disk space required: &mdadm-buildsize;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated build time: &mdadm-time;
+        </para>
       </listitem>
     </itemizedlist>
@@ -79 +93 @@
     <title>Kernel Configuration</title>
 
-    <para>Enable the following options in the kernel configuration
-    and recompile the kernel, if necessary.  Only the RAID types desired
-    are required.</para>
+    <para>
+      Enable the following options in the kernel configuration
+      and recompile the kernel, if necessary.  Only the RAID types desired
+      are required.
+    </para>
 
 <screen><literal>Device Drivers ---&gt;
@@ -102 +118 @@
     <title>Installation of mdadm</title>
 
-    <para>Fix a build error introduced by gcc-7.1:</para>
+    <para>
+      Fix a build error introduced by gcc-7.1:
+    </para>
 
 <screen><userinput>sed 's@-Werror@@' -i Makefile</userinput></screen>
 
-    <para>Build <application>mdadm</application> by running the following
-    command:</para>
+    <para>
+      Build <application>mdadm</application> by running the following
+      command:
+    </para>
 
 <screen><userinput>make</userinput></screen>
 
-    <para>If you wish to run the tests, ensure that your kernel supports
-    RAID and that a version of mdadm is not already running.  As many as 9 out
-    of 124 tests may fail.</para>
-
-    <caution><para>The tests edit values in /proc and run tests on software raid devices.
-     They shouldn't be run on systems with active software RAID devices.</para></caution>
-
-    <para>Run the tests as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      If you wish to run the tests, ensure that your kernel supports RAID
+      and that a version of mdadm is not already running.  As many as 9 out
+      of 124 tests may fail.
+    </para>
+
+    <caution>
+      <para>
+        The tests edit values in /proc and run tests on software raid devices.
+        They shouldn't be run on systems with active software RAID devices.
+      </para>
+    </caution>
+
+    <para>
+      Run the tests as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"
         remap="test"><userinput>./test --keep-going --logdir=test-logs --save-logs</userinput></screen>
 
-    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
 
 <screen role="root"><userinput>make install</userinput></screen>
@@ -186 +216 @@
         <term><command>mdadm</command></term>
         <listitem>
-          <para>manages MD devices aka Linux Software RAID.</para>
+          <para>
+            manages MD devices aka Linux Software RAID.
+          </para>
           <indexterm zone="mdadm mdadm-prog">
             <primary sortas="b-mdadm-prog">mdadm</primary>
@@ -196 +228 @@
         <term><command>mdmon</command></term>
         <listitem>
-          <para>monitors MD external metadata arrays.</para>
+          <para>
+            monitors MD external metadata arrays.
+          </para>
           <indexterm zone="mdadm mdmon">
             <primary sortas="b-mdmon">mdmon</primary>
@@ -206 +240 @@
         <term><command>mdassemble</command></term>
         <listitem>
-          <para>is a tiny program that can be used to assemble MD devices
-          inside an initial ramdisk (initrd) or initramfs.</para>
+          <para>
+            is a tiny program that can be used to assemble MD devices
+            inside an initial ramdisk (initrd) or initramfs.
+          </para>
           <indexterm zone="mdadm mdassemble">
             <primary sortas="b-mdassemble">mdassemble</primary>