Changeset 8aefeb67 for introduction/welcome/askhelp.xml

Timestamp:

07/21/2005 09:49:02 PM (19 years ago)

Author:

Randy McMurchy <randy@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 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:

4382a36

Parents:

e4e0cc35

Message:

Various tagging and text modifications to the 'Conventions' and 'Asking for Help' pages

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

File:

• introduction/welcome/askhelp.xml (modified) (5 diffs)

introduction/welcome/askhelp.xml

@@ -21 +21 @@
   mailing lists are willing to help you. An overview of the LFS mailing
   lists can be found in <xref linkend="intro-welcome-maillists"/>. To assist us
-  in diagnosing and solving your problem, include as much relevant information as
-  possible in your request for help.</para>
+  in diagnosing and solving your problem, include as much relevant information
+  as possible in your request for help.</para>
 
   <sect2>
@@ -32 +32 @@
       <listitem>
         <para>Is the hardware support compiled into the kernel or
-        available as a module to the kernel?  If it is a module, is it configured
-        properly in <filename>modules.conf</filename> and has it been loaded?  You
-        should use <command>lsmod</command> as root to see if it's loaded. Check the
-        <filename>sys.log</filename> or run <command>modprobe &lt;driver&gt;
-        </command> to review any error message.  If it loads properly, you may need
-        to add the <command>modprobe</command> to your boot scripts.</para>
+        available as a module to the kernel?  If it is a module, is it
+        configured properly in <filename>modules.conf</filename> and has it
+        been loaded?  You should use <command>lsmod</command> as the
+        <systemitem class='username'>root</systemitem> user to see if it's
+        loaded. Check the <filename>syslog.log</filename> or run
+        <command>modprobe <replaceable>[driver]</replaceable></command> to
+        review any error message. If it loads properly, you may need to add
+        the <command>modprobe</command> command to your boot scripts.</para>
       </listitem>
       <listitem>
@@ -43 +45 @@
         uses groups to make these settings easier, but it also adds the step of
         adding users to groups to allow access. A simple <command>moduser
-        -G audio &lt;user&gt;</command> may be all that's necessary for that
-        user to have access to the sound system.  Any question that starts
-        out with "It works as root, but not as ..." requires a thorough review
-        of permissions prior to asking.</para>
+        -G audio <replaceable>[user]</replaceable></command> may be all that's
+        necessary for that user to have access to the sound system. Any question
+        that starts out with <quote>It works as root, but not as ...</quote>
+        requires a thorough review of permissions prior to asking.</para>
       </listitem>
       <listitem>
-        <para>BLFS liberally uses <filename>/opt/&lt;package&gt;</filename>.
+        <para>BLFS liberally uses <filename
+        class='directory'>/opt/<replaceable>[package]</replaceable></filename>.
         The main objection to this centers around the need to expand your
         environment variables for each package placed there (e.g.,
-        PATH=$PATH:/opt/kde/bin).  In some cases, the package will walk you
-        through the changes, but some will not.  The section called "<ulink
-        url="beyond.html">Going Beyond BLFS</ulink>" is available to help
-        you check.</para>
+        PATH=$PATH:/opt/kde/bin). In most cases, the package instructions will
+        walk you through the changes, but some will not. The section called
+        <quote><ulink url="beyond.html">Going Beyond BLFS</ulink></quote> is
+        available to help you check.</para>
       </listitem>
     </itemizedlist>
@@ -92 +95 @@
     in the mailing list prefer not to be used as an alternative to doing
     reasonable research on your end.  In addition, the quality of your
-    experience with BLFS  is also greatly enhanced by this research, and
+    experience with BLFS is also greatly enhanced by this research, and
     the quality of volunteers is enhanced because they don't feel that their
     time has been abused, so they are far more likely to participate.</para>
@@ -106 +109 @@
 
 </sect1>
-