Changeset 3496df9 for general

Timestamp:

12/22/2007 07:15:43 AM (16 years ago)

Author:

Alexander E. Patrakov <alexander@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

d10ebccc

Parents:

f2775848

Message:

Improved wording on HAL page, following suggestions from Archaic.

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

File:

• general/sysutils/hal.xml (modified) (8 diffs)

general/sysutils/hal.xml

@@ -245 +245 @@
 
     <sect3><title>Configuration Information</title>
+    <sect4><title>Allowing users to invoke HAL methods</title>
 
       <para>The default setup for <application>HAL</application> is to allow
@@ -303 +304 @@
 &lt;/deviceinfo&gt;</literal>
 EOF</userinput></screen>
-
+      </sect4>
+
+      <sect4><title>Installing mount helpers</title>
       <para><application>HAL</application> only provides the methods such
       as Mount() to act on hardware. In order to take advantage of these,
@@ -311 +314 @@
       installed.</para>
       <!-- FIXME: is Ivman still alive? -->
-
+      <!-- FIXME: explicitly name the mount helpers
+           from KDE (???) and Xfce (exo-mount) -->
+      </sect4>
+
+      <sect4><title>Changing default mount options</title>
       <para>In some cases, it is necessary to specify some default mount
       options for filesystems. E.g., in non-English environments, the
@@ -352 +359 @@
       <para>The important point above is that the configuration procedure is
       desktop-specific. However, as of December, 2007, only GNOME allows the
-      user to set default mount options on a per-filesystem basis. To do so,
-      change the
-      <systemitem>/system/storage/default_options/[fs_type]/mount_options</systemitem>
-      GConf key either using <xref linkend="gconf-editor"/>, or from the
-      command line, as demonstrated in the following example:</para>
-
-<screen><userinput>gconftool-2 --type list --list-type=string \
-    --set /system/storage/default_options/vfat/mount_options \
-    "[shortname=mixed,uid=,usefree,iocharset=koi8-r,codepage=866]"</userinput></screen>
-
-      <para>See more details in the gnome-mount(1) manual page.</para>
-      
-      <para>KDE allows the mount options to be set only on a per-volume basis,
+      user to set default mount options on a per-filesystem basis,
+      as described in the next paragraph.
+      KDE allows the mount options to be set only on a per-volume basis,
       not per-filesystem, which is a
       <ulink url="http://bugs.kde.org/show_bug.cgi?id=133456">bug</ulink>,
@@ -377 +374 @@
            an XML-ized sudo-like confguration parser, which has nothing
            common with the "default mount options" problem. -->
-      In these desktop environments, if the built-in
-      default mount options are not suitable, it is needed to mention every
-      possible removable storage device in <filename>/etc/fstab</filename>
-      with the correct options, thus mostly defeating the point of
-      installing HAL.</para>
-
-      <para>If HAL does not accept new mount options by default,
-      (in the above example, this happens with the <option>usefree</option>
-      option), as <systemitem class="username">root</systemitem> user,
-      create a custom policy file that mentions unknown mount options:</para>
+      In KDE and Xfce, if the built-in default mount options are not suitable,
+      it is needed to mention every possible removable storage device in
+      <filename>/etc/fstab</filename> with the correct options, thus mostly
+      defeating the point of installing HAL.</para>
+      
+      <para>In order to adjust the default mount options, GNOME users should
+      change the
+      <systemitem>/system/storage/default_options/[fs_type]/mount_options</systemitem>
+      GConf key either using <xref linkend="gconf-editor"/>, or from the
+      command line, as demonstrated in the following example:</para>
+
+<screen><userinput>gconftool-2 --type list --list-type=string \
+    --set /system/storage/default_options/vfat/mount_options \
+    "[shortname=mixed,uid=,usefree,iocharset=koi8-r,codepage=866]"</userinput></screen>
+
+      <para>See more details in the gnome-mount(1) manual page.</para>
+      </sect4>
+
+      <sect4><title>Adding allowed mount options</title>
+      <para>The list of mount options permitted in the default HAL
+      configuration resides in the
+      <filename>/usr/share/hal/fdi/policy/10osvendor/20-storage-methods.fdi</filename>
+      file. GNOME and KDE users may want to use options not in this
+      list (in the above example, this applies to the <option>usefree</option>
+      option). In this case, as <systemitem class="username">root</systemitem>
+      user, create a custom policy file that mentions unknown mount
+      options:</para>
 
 <screen role="root"><userinput>install -v -m755 -d /etc/hal/fdi/policy/30user &amp;&amp;
@@ -407 +421 @@
       &lt;match key="storage.no_partitions_hint" bool="true"&gt;
         &lt;append key="volume.mount.valid_options" type="strlist"&gt;usefree&lt;/append&gt;
+        &lt;!-- Insert other options here --&gt;
       &lt;/match&gt;
     &lt;/match&gt;
@@ -415 +430 @@
       &lt;match key="volume.fstype" string="vfat"&gt;
         &lt;append key="volume.mount.valid_options" type="strlist"&gt;usefree&lt;/append&gt;
+        &lt;!-- Insert other options here --&gt;
       &lt;/match&gt;
     &lt;/match&gt;
@@ -422 +438 @@
 EOF</userinput></screen>
 
+    </sect4>
     </sect3>