Ignore:
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:
1 edited

Legend:

Unmodified
Added
Removed

  • postlfs/filesystems/btrfs-progs.xml

    r9bd10279 r29244b7  
    3030    <title>Introduction to btrfs-progs</title>
    3131
    32     <para>The <application>btrfs-progs</application> package contains administration
    33     and debugging tools for the B-tree file system (btrfs).</para>
     32    <para>
     33      The <application>btrfs-progs</application> package contains
     34      administration and debugging tools for the B-tree file system (btrfs).
     35    </para>
    3436
    3537    &lfs91_checked;
    … …  
    3840    <itemizedlist spacing="compact">
    3941      <listitem>
    40         <para>Download (HTTP): <ulink url="&btrfs-progs-download-http;"/></para>
    41       </listitem>
    42       <listitem>
    43         <para>Download (FTP): <ulink url="&btrfs-progs-download-ftp;"/></para>
    44       </listitem>
    45       <listitem>
    46         <para>Download MD5 sum: &btrfs-progs-md5sum;</para>
    47       </listitem>
    48       <listitem>
    49         <para>Download size: &btrfs-progs-size;</para>
    50       </listitem>
    51       <listitem>
    52         <para>Estimated disk space required: &btrfs-progs-buildsize;</para>
    53       </listitem>
    54       <listitem>
    55         <para>Estimated build time: &btrfs-progs-time;</para>
     42        <para>
     43          Download (HTTP): <ulink url="&btrfs-progs-download-http;"/>
     44        </para>
     45      </listitem>
     46      <listitem>
     47        <para>
     48          Download (FTP): <ulink url="&btrfs-progs-download-ftp;"/>
     49        </para>
     50      </listitem>
     51      <listitem>
     52        <para>
     53          Download MD5 sum: &btrfs-progs-md5sum;
     54        </para>
     55      </listitem>
     56      <listitem>
     57        <para>
     58          Download size: &btrfs-progs-size;
     59        </para>
     60      </listitem>
     61      <listitem>
     62        <para>
     63          Estimated disk space required: &btrfs-progs-buildsize;
     64        </para>
     65      </listitem>
     66      <listitem>
     67        <para>
     68          Estimated build time: &btrfs-progs-time;
     69        </para>
    5670      </listitem>
    5771    </itemizedlist>
    … …  
    8599    <title>Kernel Configuration</title>
    86100
    87     <para>Enable the following option in the kernel configuration
    88     and recompile the kernel:</para>
     101    <para>
     102      Enable the following option in the kernel configuration
     103      and recompile the kernel:
     104    </para>
    89105
    90106<screen><literal>File systems ---&gt;
    91107  &lt;*/M&gt; Btrfs filesystem support [CONFIG_BTRFS_FS]</literal></screen>
    92108
    93     <note><para>CONFIG_BTRFS_FS_POSIX_ACL and
    94     CONFIG_REISERFS_FS_XATTR are required for some tests.
    95     Other Btrfs options in the kernel are optional.</para></note>
     109    <note>
     110      <para>
     111        CONFIG_BTRFS_FS_POSIX_ACL and
     112        CONFIG_REISERFS_FS_XATTR are required for some tests.
     113        Other Btrfs options in the kernel are optional.
     114      </para>
     115    </note>
    96116
    97117    <indexterm zone="btrfs-progs btrfs-progs-kernel">
    … …  
    104124    <title>Installation of btrfs-progs</title>
    105125
    106     <para>Install <application>btrfs-progs</application> by running the following
    107     commands:</para>
     126    <para>
     127      Install <application>btrfs-progs</application> by running the following
     128      commands:
     129    </para>
    108130
    109131<screen><userinput>./configure --prefix=/usr  \
    … …  
    113135make</userinput></screen>
    114136
    115     <note><para>Some tests require grep built with perl regular expressions. To
    116     obtain this, rebuild grep with the LFS Chapter 6 instructions after
    117     installing <xref linkend="pcre"/>.</para></note>
    118 
    119     <para>Before running tests, build a support program and
    120     disable several that fail:</para>
     137    <note>
     138      <para>
     139        Some tests require grep built with perl regular expressions. To
     140        obtain this, rebuild grep with the LFS Chapter 6 instructions after
     141        installing <xref linkend="pcre"/>.
     142      </para>
     143    </note>
     144
     145    <para>
     146      Before running tests, build a support program and
     147      disable several that fail:
     148    </para>
    121149
    122150<screen remap="test"><userinput>make fssum &amp;&amp;
    … …  
    131159mv tests/misc-tests/025-zstd-compression/test.sh{,.broken}</userinput></screen>
    132160
    133     <para>To test the results, issue (as the <systemitem
    134     class="username">root</systemitem> user): </para>
     161    <para>
     162      To test the results, issue (as the <systemitem
     163      class="username">root</systemitem> user):
     164    </para>
    135165
    136166<screen role="root" remap="test"><userinput>pushd tests
    … …  
    143173popd</userinput></screen>
    144174
    145     <para>Install the package as the <systemitem
    146     class="username">root</systemitem> user:</para>
     175    <para>
     176      Install the package as the <systemitem
     177      class="username">root</systemitem> user:
     178    </para>
    147179
    148180<screen role="root"><userinput>make install &amp;&amp;
    … …  
    158190    <title>Command Explanations</title>
    159191
    160     <para><option>--disable-documentation</option>: This option
    161     is needed if the recommended dependencies are not installed.</para>
    162 
    163     <para><command>mv tests/{cli,convert,misc,fuzz}-tests/ ...</command>: Disables
    164     tests that fail and prevent tests from completing.</para>
    165 
    166     <para><command>ln -s ... /usr/lib/libbtrfs.so</command>: Creates a
    167     symbolic link in the directory where it is expected.</para>
    168 
    169     <para><command>rm /lib/libbtrfs.{a,so}</command>: Removes unneeded
    170     library entries.</para>
     192    <para>
     193      <option>--disable-documentation</option>: This option
     194      is needed if the recommended dependencies are not installed.
     195    </para>
     196
     197    <para>
     198      <command>mv tests/{cli,convert,misc,fuzz}-tests/ ...</command>: Disables
     199      tests that fail and prevent tests from completing.
     200    </para>
     201
     202    <para>
     203      <command>ln -s ... /usr/lib/libbtrfs.so</command>: Creates a
     204      symbolic link in the directory where it is expected.
     205    </para>
     206
     207    <para>
     208      <command>rm /lib/libbtrfs.{a,so}</command>: Removes unneeded
     209      library entries.
     210    </para>
    171211
    172212  </sect2>
    … …  
    295335        <term><command>mkfs.btrfs</command></term>
    296336        <listitem>
    297           <para>creates a btrfs file system.</para>
     337          <para>
     338            creates a btrfs file system.
     339          </para>
    298340          <indexterm zone="btrfs-progs mkfs.btrfs">
    299341            <primary sortas="b-mkfs.btrfs">mkfs.btrfs</primary>
Note: See TracChangeset for help on using the changeset viewer.