usb-hotplug usb-hotplug-tutorial-en.xml,1.4,1.5
Paul W. Frields (pfrields)
fedora-docs-commits at redhat.com
Fri Jun 24 20:29:57 UTC 2005
- Previous message (by thread): docs-common/common README,1.1,1.2
- Next message (by thread): proxy-guide proxy-guide-en.xml, NONE, 1.2 Makefile, NONE, 1.2 proxy.eps, NONE, 1.2 proxy.png, NONE, 1.2 fedora-proxy-guide-en.xml, 1.1, NONE
- Messages sorted by:
[ date ]
[ thread ]
[ subject ]
[ author ]
Author: pfrields
Update of /cvs/docs/usb-hotplug
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv14139
Modified Files:
usb-hotplug-tutorial-en.xml
Log Message:
Entity changes, tag cleanup, legacy notice added
Index: usb-hotplug-tutorial-en.xml
===================================================================
RCS file: /cvs/docs/usb-hotplug/usb-hotplug-tutorial-en.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- usb-hotplug-tutorial-en.xml 18 Jun 2005 13:47:18 -0000 1.4
+++ usb-hotplug-tutorial-en.xml 24 Jun 2005 20:29:54 -0000 1.5
@@ -5,14 +5,14 @@
<!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../docs-common/common/fedora-entities-en.ent">
%FEDORA-ENTITIES-EN;
-<!ENTITY BOOKID "usb-hotplug-tutorial-0.52 (2004-10-14)"> <!-- change version of manual and date here -->
-<!ENTITY LOCAL-FCVER "2"> <!-- Immovable version -->
+<!ENTITY BOOKID "usb-hotplug-tutorial-0.53 (2005-06-24)"> <!-- change version of manual and date here -->
+<!ENTITY FCLOCALVER "2"> <!-- Immovable version -->
+<!ENTITY BUG-NUM "128952"> <!-- Bugzilla entry for this document -->
]>
<article id="usb-hotplug-tutorial" lang="en">
<articleinfo>
<title><command>usb-hotplug</command> Tutorial</title>
- <subtitle>&FC; 1 and 2</subtitle>
<copyright>
<year>
2003, 2004
@@ -50,19 +50,27 @@
<revremark>Style and syntax edits by Wade, finished by
Frields, edits by tfox before publication.</revremark>
</revision>
+ <revision>
+ <revnumber>0.53</revnumber>
+ <date>Jun 24 2005</date>
+ <authorinitials>PaulWFrields</authorinitials>
+ <revremark>Added legacy notice, changed entities, and fixed
+ section tags</revremark>
+ </revision>
</revhistory>
</articleinfo>
- <sect1 id="s1-introduction">
+ <section id="sn-introduction">
<title>Introduction</title>
+ &LEGACYNOTICE;
<important>
<title>Important</title>
<para>
- This document is intended for users of &FC; &LOCAL-FCVER; (or previous
+ This document is intended for users of &FC; &FCLOCALVER; (or previous
versions) only. Newer versions of &FC; have new facilities for adding
hot-pluggable storage devices.
</para>
</important>
- <sect2 id="s2-overview">
+ <section id="sn-overview">
<title>Overview</title>
<para>
&FC; uses the <command>hotplug</command> facility to recognize when new
@@ -82,8 +90,8 @@
configure these components improves the effectiveness of existing tools,
such as the <application>usermount</application> helper.
</para>
- </sect2>
- <sect2 id="s2-aboutdoc">
+ </section>
+ <section id="sn-aboutdoc">
<title>About This Document</title>
<para>
The most up-to-date version of this document is always found at the &FP;
@@ -97,16 +105,12 @@
this document: <computeroutput>&BOOKID;</computeroutput>
</para>
<para>
- Comments and suggestions may also be forwarded to the author at <ulink
- url="mailto:stickstr5 at hotmail.com">stickstr5 at hotmail.com</ulink>.
- </para>
- <para>
Portions of this document were suggested by tips written by Tim Waugh
and available at the time of writing at <ulink
url="http://cyberelk.net/tim/usb-storage.html">http://cyberelk.net/tim/usb-storage.html</ulink>.
</para>
- </sect2>
- <sect2 id="s2-acknowledgments">
+ </section>
+ <section id="sn-acknowledgments">
<title>Acknowledgments</title>
<para>
The author is grateful to Dave Pawson for his help in finding gaps in
@@ -115,9 +119,9 @@
support, and kept this document concise and readable, and its style
consistent.
</para>
- </sect2>
- </sect1>
- <sect1 id="s1-summary">
+ </section>
+ </section>
+ <section id="sn-summary">
<title>Summary</title>
<!-- I think you mean the "quotes" to signify a first term, hence the usage. -->
<!-- AIUI, we want to save <quote> for when actually quoting something. -->
@@ -221,8 +225,8 @@
</para>
</step>
</procedure>
- </sect1>
- <sect1 id="s1-hotplug-files">
+ </section>
+ <section id="sn-hotplug-files">
<title>The <command>hotplug</command> Configuration Files</title>
<para>
The file <filename>/etc/hotplug/usb.distmap</filename> contains a list of
@@ -298,7 +302,7 @@
determine whether the USB mass storage driver module was loaded. If the
<filename>usb-storage</filename> module is listed, do
<emphasis>not</emphasis> edit your <command>hotplug</command>
- configuration files. Skip to <xref linkend="s1-updfstab-files"/> and
+ configuration files. Skip to <xref linkend="sn-updfstab-files"/> and
follow those steps to continue diagnosing the problem.
</para>
<para>
@@ -381,16 +385,16 @@
-->
- </sect1>
- <sect1 id="s1-updfstab-files">
+ </section>
+ <section id="sn-updfstab-files">
<title>The <command>updfstab</command> Configuration Files</title>
<para>
If <command>hotplug</command> automatically loaded the proper module for
- you (refer to <xref linkend="s1-hotplug-files"/>), check
+ you (refer to <xref linkend="sn-hotplug-files"/>), check
<filename>/etc/fstab</filename> for an entry for your device. If your
device has an entry, you should now see it in your graphical browser. If
you still can't mount the device, the console owner may not own the device
- file. Skip to <xref linkend="s1-pam"/> to continue troubleshooting.
+ file. Skip to <xref linkend="sn-pam"/> to continue troubleshooting.
</para>
<para>
To see if your system now has enough information to properly update
@@ -404,7 +408,7 @@
<command>updfstab</command> files.
</para>
- <sect2 id="s2-updfstab-conf">
+ <section id="sn-updfstab-conf">
<title><filename>/etc/updfstab.conf</filename></title>
<para>
The main configuration file is <filename>/etc/updfstab.conf</filename>.
@@ -422,8 +426,8 @@
include /etc/updfstab.conf.default
</screen>
- </sect2>
- <sect2 id="s2-updfstab-conf-default">
+ </section>
+ <section id="sn-updfstab-conf-default">
<title><filename>/etc/updfstab.conf.default</filename></title>
<!-- Reserving <command> to reference just command line programs; unfortunately, -->
<!-- there is not good catch-all tag for the contents of a config file; a -->
@@ -485,8 +489,8 @@
information, as well as a complete directive reference. Issue the
command <command>man updfstab</command> to read it.
</para>
- </sect2>
- <sect2 id="s2-adding-devices">
+ </section>
+ <section id="sn-adding-devices">
<title>Adding Devices</title>
<para>
To add a device to the <command>updfstab</command> facility, create the
@@ -633,9 +637,9 @@
-->
- </sect2>
- </sect1>
- <sect1 id="s1-pam">
+ </section>
+ </section>
+ <section id="sn-pam">
<title>PAM</title>
<para>
PAM, or <firstterm>Pluggable Authentication Modules</firstterm>, is a
@@ -646,7 +650,7 @@
system documentation, at
<filename>/usr/share/doc/pam-<replaceable>version</replaceable>/txts/pam.txt</filename>.
</para>
- <sect2 id="s2-consoleperms">
+ <section id="sn-consoleperms">
<title><filename>/etc/security/console.perms</filename></title>
<para>
This tutorial discusses only a small subset of the PAM system, the
@@ -682,13 +686,13 @@
properly inherit changes.
</para>
</important>
- </sect2>
- <sect2 id="s2-adding-perms">
+ </section>
+ <section id="sn-adding-perms">
<title>Adding Device Access Permissions</title>
<para>
Create a new device class that points to the mount point you assigned in
your <filename>/etc/updfstab.conf.custom</filename> file in <xref
- linkend="s2-adding-devices"/>. Name the class after your
+ linkend="sn-adding-devices"/>. Name the class after your
<computeroutput>device</computeroutput> directive for simplicity. Also
create a permission definition which describes what permissions the
console user inherits after logging in, and how these permissions revert
@@ -722,9 +726,9 @@
<filename>updfstab.conf.default</filename>.
</para>
</note>
- </sect2>
- </sect1>
- <sect1 id="s1-run-updfstab">
+ </section>
+ </section>
+ <section id="sn-run-updfstab">
<title>Running <command>updfstab</command></title>
<para>
Now run the <command>updfstab</command> command to properly update the
@@ -785,8 +789,8 @@
<guiicon>Computer</guiicon> on your desktop) displays your removable
device as well.
</para>
- </sect1>
- <sect1 id="s1-references">
+ </section>
+ <section id="sn-references">
<title>References</title>
<itemizedlist>
<listitem>
@@ -806,5 +810,5 @@
</para>
</listitem>
</itemizedlist>
- </sect1>
+ </section>
</article>
- Previous message (by thread): docs-common/common README,1.1,1.2
- Next message (by thread): proxy-guide proxy-guide-en.xml, NONE, 1.2 Makefile, NONE, 1.2 proxy.eps, NONE, 1.2 proxy.png, NONE, 1.2 fedora-proxy-guide-en.xml, 1.1, NONE
- Messages sorted by:
[ date ]
[ thread ]
[ subject ]
[ author ]
More information about the Fedora-docs-commits
mailing list