[kde-doc-english] [kio-extras] doc/kioslave: moved network:/ kioslave to kdebase/runtime/kioslave

[Aleix Pol]

Git commit 19d51f11205369d982cae74ddb0ca52ca5104901 by Aleix Pol, on behalf of Friedrich W. H. Kossebau.
Committed on 04/05/2009 at 16:41.
Pushed by apol into branch 'master'.

moved network:/ kioslave to kdebase/runtime/kioslave

svn path=/trunk/KDE/kdebase/runtime/; revision=963373

M  +1    -0    doc/kioslave/CMakeLists.txt
A  +1    -0    doc/kioslave/network/CMakeLists.txt
A  +61   -0    doc/kioslave/network/index.docbook

http://commits.kde.org/kio-extras/19d51f11205369d982cae74ddb0ca52ca5104901

diff --git a/doc/kioslave/CMakeLists.txt b/doc/kioslave/CMakeLists.txt
index 49fece5..1ad51d6 100644
--- a/doc/kioslave/CMakeLists.txt
+++ b/doc/kioslave/CMakeLists.txt
@@ -7,6 +7,7 @@ add_subdirectory(floppy)
 add_subdirectory(gzip)
 add_subdirectory(info)
 add_subdirectory(man)
+add_subdirectory(network)
 add_subdirectory(nfs)
 add_subdirectory(sftp)
 if(NOT WIN32)
diff --git a/doc/kioslave/network/CMakeLists.txt b/doc/kioslave/network/CMakeLists.txt
new file mode 100644
index 0000000..dd75aec
--- /dev/null
+++ b/doc/kioslave/network/CMakeLists.txt
@@ -0,0 +1 @@
+kde4_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en)
diff --git a/doc/kioslave/network/index.docbook b/doc/kioslave/network/index.docbook
new file mode 100644
index 0000000..560d4c1
--- /dev/null
+++ b/doc/kioslave/network/index.docbook
@@ -0,0 +1,61 @@
+<?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="network">
+
+<title>network</title>
+
+<articleinfo>
+  <authorgroup>
+    <author>
+      <personname><firstname>Friedrich W. H.</firstname><surname>Kossebau</surname></personname>
+      <email>kossebau at kde.org</email>
+    </author>
+  <!-- TRANS:ROLES_OF_TRANSLATORS -->
+  </authorgroup>
+
+  <date>2009-04-28</date>
+  <releaseinfo>0.1</releaseinfo>
+
+</articleinfo>
+
+
+<para>
+  The network ioslave enables the user to browse the devices connected to the local network
+  and the services running on them. It it also possible to start programs for services
+  whose type is known.
+</para>
+
+<para>
+  To see all the devices found, enter
+  <userinput><command>network:/</command></userinput>.
+</para>
+
+<para>
+  <userinput><command>network:/</command><replaceable>hostname_of_device</replaceable></userinput>
+  will list the services found to be running on a device.
+</para>
+
+<para>
+  Selecting a service will forward to a url which matches the service, given there is a suitable, e.g.
+  <userinput><command>ssh:/</command>hostname_of_device:port/</userinput> for a <acronym>SSH</acronym> service.
+  Each known service type has a mimetype assigned to it, so a user can assign new handlers
+  for the resulting urls. This is done with the control module
+  <menuchoice><guimenuitem>File Associations</guimenuitem></menuchoice> in &systemsettings;.
+  The mimetypes of the services are currently all named <userinput>inode/vnd.kde.service.*</userinput>.
+</para>
+
+<note>
+  <para>
+    The network kioslave currently only finds and displays devices and services which are
+    actively advertising themselves using the service discovery framework
+    <ulink url="http://www.dns-sd.org/">DNS-SD</ulink>.
+  </para>
+</note>
+
+</article>
+