[kde-doc-english] [patch] update for kdebase/doc/kioslave/fish.docbook

[Brad Hards]

I did a quick demo of fish at a LUG meeting, and ended up pulling
up this entry which had us all a bit confused. So a slight
re-arrange and a little extra text from the FAQ (in the source
directory).
diff -u -4 -p -r1.7 fish.docbook
--- fish.docbook        8 Jan 2005 23:50:46 -0000       1.7
+++ fish.docbook        9 Feb 2005 11:25:53 -0000
@@ -2,23 +2,41 @@
 <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>2002-06-23</date>
-<releaseinfo>1.1.1</releaseinfo>
+<date>2005-02-09</date>
+<releaseinfo>1.1.2</releaseinfo>

 </articleinfo>

-<para>Allows you to access another computer's files using a simple
-<acronym>SSH</acronym> shell account and standard &UNIX; utilities on
-the remote side. This way, no server software is needed and you gain
-access to that computer's files as if they were local (or on
-<acronym>NFS</acronym>, since it is slower than local access). It uses
-the same protocol as <application>MidnightCommander</application>'s
-#sh <acronym>VFS</acronym> handler.</para>
+<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 SSH daemon, but the remainder of the protocol uses standard command
+line tools, as discussed below.</para>
+
+<para>You can use the fish kioslave 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 SSH 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>,
@@ -49,9 +67,5 @@ faster.</para>
 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>

-<para>Use the fish kioslave like this:  
<userinput>fish://<replaceable>hostname</replaceable></userinput>or 
<userinput>fish://<replaceable>username</replaceable>@<replaceable>hostname</replaceable></userinput></para>
-
-<para>You do not need to provide the username if you have the same username 
on both computers.  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>
-
 </article>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://mail.kde.org/pipermail/kde-doc-english/attachments/20050209/71923eb2/attachment.sig