summaryrefslogtreecommitdiffstats
path: root/doc/tdeioslave/fish
diff options
context:
space:
mode:
authorDarrell Anderson <humanreadable@yahoo.com>2014-02-06 17:50:29 -0600
committerDarrell Anderson <humanreadable@yahoo.com>2014-02-06 17:50:29 -0600
commitcf14b1bd7803760ea4657269aeb424869e0058c6 (patch)
tree083f9fdcac07a38d4bf733c601f24f52e6a8e925 /doc/tdeioslave/fish
parent66e86452a4f46f029820115fe6e55761a8d13187 (diff)
downloadtdebase-cf14b1bd7803760ea4657269aeb424869e0058c6.tar.gz
tdebase-cf14b1bd7803760ea4657269aeb424869e0058c6.zip
Reorganize tdeioslave help handbooks, fix related protocol files and issues, update and add handbooks.
Diffstat (limited to 'doc/tdeioslave/fish')
-rw-r--r--doc/tdeioslave/fish/CMakeLists.txt9
-rw-r--r--doc/tdeioslave/fish/Makefile.am2
-rw-r--r--doc/tdeioslave/fish/index.docbook72
3 files changed, 83 insertions, 0 deletions
diff --git a/doc/tdeioslave/fish/CMakeLists.txt b/doc/tdeioslave/fish/CMakeLists.txt
new file mode 100644
index 000000000..f61201bcb
--- /dev/null
+++ b/doc/tdeioslave/fish/CMakeLists.txt
@@ -0,0 +1,9 @@
+#################################################
+#
+# Improvements and feedback are welcome
+#
+# This file is released under GPL >= 2
+#
+#################################################
+
+tde_create_handbook( DESTINATION tdeioslave/fish )
diff --git a/doc/tdeioslave/fish/Makefile.am b/doc/tdeioslave/fish/Makefile.am
new file mode 100644
index 000000000..4a3e8575d
--- /dev/null
+++ b/doc/tdeioslave/fish/Makefile.am
@@ -0,0 +1,2 @@
+KDE_LANG = en
+KDE_DOCS = tdeioslave/fish
diff --git a/doc/tdeioslave/fish/index.docbook b/doc/tdeioslave/fish/index.docbook
new file mode 100644
index 000000000..3d35d055e
--- /dev/null
+++ b/doc/tdeioslave/fish/index.docbook
@@ -0,0 +1,72 @@
+<?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="fish">
+<title>fish</title>
+<articleinfo>
+<authorgroup>
+<author>&Joerg.Walter; &Joerg.Walter.mail;</author>
+<author>&Brad.Hards; &Brad.Hards.mail;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<date>2005-02-29</date>
+<releaseinfo>1.1.2</releaseinfo>
+
+</articleinfo>
+
+<para>Allows you to access another computer's files using the SEcure Shell (<acronym>SSH</acronym>) protocol. The remote computer needs to be running the <acronym>SSH</acronym> daemon, but the remainder of the protocol uses standard commandline tools as discussed below.</para>
+
+<para>You can use the fish tdeioslave like this:
+<userinput>fish://<replaceable>hostname</replaceable></userinput> or <userinput>fish://<replaceable>username</replaceable>@<replaceable>hostname</replaceable></userinput>.</para>
+
+<note><para>You need to use double forward slashes.</para></note>
+
+<para>You can omit the <replaceable>username</replaceable> (and the trailing
+@ symbol) if you have the same username on both computers.</para>
+
+<para>You can add a password in the format:
+<userinput>fish://<replaceable>username</replaceable>:<replaceable>password</replaceable>@<replaceable>hostname</replaceable></userinput>
+but it is not necessary as you will be prompted for one if it is not
+supplied.</para>
+
+<para>If you are running the <acronym>SSH</acronym> daemon on a non-standard
+port, you can specify that port using the normal &URL; syntax as shown
+below:
+<userinput>fish://<replaceable>hostname</replaceable>:<replaceable>portnumber</replaceable></userinput>.</para>
+
+<para>Fish should work with any roughly <acronym>POSIX</acronym> compatible
+&UNIX; based remote computer. It uses the shell commands
+<command>cat</command>, <command>chgrp</command>,
+<command>chmod</command>, <command>chown</command>,
+<command>cp</command>, <command>dd</command>,
+<command>env</command>, <command>expr</command>,
+<command>grep</command>, <command>ls</command>,
+<command>mkdir</command>, <command>mv</command>,
+<command>rm</command>, <command>rmdir</command>,
+<command>sed</command>,
+and <command>wc</command>. Fish starts
+<command>/bin/sh</command> as its shell and expects it to be a
+Bourne shell (or compatible, like <command>bash</command>).
+If the <command>sed</command> and
+<command>file</command> commands are available, as well as a
+<filename>/etc/apache/magic</filename> file with &MIME; type
+signatures, these will be used to guess &MIME; types.
+</para>
+
+<para>If <application>Perl</application> is available on the remote
+machine, it will be used instead. Then only <command>env</command> and
+<command>/bin/sh</command> are needed. Using
+<application>Perl</application> has the additional benefit of being
+faster.</para>
+
+<para>Fish may even work on &Windows; machines, if tools like
+<application>Cygwin</application> are installed. All the above
+utilities must be in the system <envar>PATH</envar>, and the initial
+shell must be able to process the command <command>echo
+FISH:;/bin/sh</command> correctly.</para>
+
+</article>