Changeset 2d9bcc8 for postlfs

Timestamp:

07/31/2023 01:44:36 PM (10 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

12.0, 12.1, ken/TL2024, ken/tuningfonts, lazarus, plabs/newcss, python3.11, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18

Children:

4955b595

Parents:

10b89821

git-author:

Xi Ruoyao <xry111@…> (07/30/2023 03:50:01 AM)

git-committer:

Xi Ruoyao <xry111@…> (07/31/2023 01:44:36 PM)

Message:

dosfstools: Use new kernel configuration rendering, and ...

clarify the rationale of the package and kernel support.

Note that we actually do not need this package if we only need to mount
FAT fs, not create or check or relabel it.

Location:

postlfs/filesystems

Files:

• dosfstools-kernel.xml (added)
• dosfstools.xml (modified) (1 diff)

postlfs/filesystems/dosfstools.xml

@@ -75 +75 @@
     <para>
       Enable the following option in the kernel configuration
-      and recompile the kernel:
-    </para>
-
-<screen><literal>File systems ---&gt;
-  &lt;DOS/FAT/EXFAT/NT Filesystems ---&gt;
-    &lt;*/M&gt; MSDOS fs support             [CONFIG_MSDOS_FS]
-    &lt;*/M&gt; VFAT (Windows-95) fs support [CONFIG_VFAT_FS]</literal></screen>
+      and recompile the kernel if you need to mount a FAT-family filesystem:
+    </para>
+
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+      href="dosfstools-kernel.xml"/>
+
+    <para>
+      Note that <option>CONFIG_MSDOS_FS</option> deliberately unsupport
+      long file names.  <option>CONFIG_VFAT_FS</option> should be used
+      instead unless you really want to enforce the DOS-style
+      <quote>8.3</quote> file names.
+    </para>
+
+    <para>
+      You can mount a FAT-family filesystem once the kernel supports it.
+      If you don't need to create, check, or relabel a FAT-family system,
+      you may skip this package.
+    </para>
 
     <indexterm zone="dosfstools dosfstools-kernel">
-      <primary sortas="d-dosfstools">Dosfstools Programs</primary>
+      <primary sortas="d-fat">FAT Support in Kernel</primary>
     </indexterm>