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
