Reorganize tdeioslave help handbooks, fix related protocol files and issues, update and add handbooks.

3 files changed, 68 insertions, 0 deletions

diff --git a/doc/tdeioslave/floppy/CMakeLists.txt b/doc/tdeioslave/floppy/CMakeLists.txt
new file mode 100644
index 000000000..eb53e2871
--- /dev/null
+++ b/doc/tdeioslave/floppy/CMakeLists.txt
@@ -0,0 +1,9 @@
+#################################################
+#
+#  Improvements and feedback are welcome
+#
+#  This file is released under GPL >= 2
+#
+#################################################
+
+tde_create_handbook( DESTINATION tdeioslave/floppy )
diff --git a/doc/tdeioslave/floppy/Makefile.am b/doc/tdeioslave/floppy/Makefile.am
new file mode 100644
index 000000000..0ef5c361d
--- /dev/null
+++ b/doc/tdeioslave/floppy/Makefile.am
@@ -0,0 +1,2 @@
+KDE_LANG = en
+KDE_DOCS = tdeioslave/floppy
diff --git a/doc/tdeioslave/floppy/index.docbook b/doc/tdeioslave/floppy/index.docbook
new file mode 100644
index 000000000..cabe3323e
--- /dev/null
+++ b/doc/tdeioslave/floppy/index.docbook
@@ -0,0 +1,57 @@
+<?xml version="1.0" ?>
+<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<article lang="&language;" id="floppy">
+<title>Floppy</title>
+<articleinfo>
+<authorgroup>
+<author>&Alexander.Neundorf; &Alexander.Neundorf.mail;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+</articleinfo>
+
+<para>
+The floppy ioslave gives you easy access to the floppy disk drives 
+installed on your system.
+</para>
+
+<para>
+The drive letter becomes the first subdirectory 
+in the floppy &URL;. Let's say there is a file <filename>logo.png</filename> on your floppy 
+disk in drive A, then the &URL; will be <userinput><command>floppy:</command><replaceable>/a/logo.png</replaceable></userinput>
+</para>
+
+<para>
+If you want to access drive B, <userinput><command>floppy:/b</command></userinput> will do it.
+<command>floppy:/</command> is a shortcut for <command>floppy:/a</command>.
+</para>
+
+<note><para>Note that <command>floppy:/logo.png</command> means you have a disk drive 
+named <filename>logo.png</filename>.</para></note>
+
+<para>
+To use it you need to have the mtools package
+installed, and the floppy ioslave supports everything the various mtools 
+command line utilities support. You don't have to mount your floppy disks, 
+simply enter <userinput>floppy:/</userinput> in any &tde; 3.x app and you will be able to 
+read from and write to your floppy drive.</para>
+
+<para>
+It also works with USB sticks, ZIP and JAZ drives.
+You can use <command>floppy:/u</command> for the USB stick and <command>floppy:/z</command> for the zip drive, for example.
+To make this work, you might need to adjust your <filename>/etc/mtools</filename> file. See the manpage
+for documentation.
+</para>
+
+<para>The ioslave gives read and write access to the floppy drive, but not 
+simultaneously. While you can read and write to the floppy during the same 
+session, reading and writing have to happen one after the other, not at the same 
+time.</para>
+
+<para>Author: Alexander Neundorf <email>neundorf@kde.org</email></para>
+
+</article>
+