changeset 22933:b99c2feda3eb

Move netstream documentation into TOOLS/README.

--- a/DOCS/xml/en/usage.xml	Mon Apr 09 11:30:26 2007 +0000
+++ b/DOCS/xml/en/usage.xml	Mon Apr 09 11:54:03 2007 +0000
@@ -429,68 +429,6 @@
 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
 
 
-<sect1 id="mpst" xreflabel="Remote streams">
-<title>Remote streams</title>
-
-<para>
-Remote streams allow you to access most <application>MPlayer</application>
-stream type from a remote host. The main purpose of this feature is to make
-it possible to directly use the CD or DVD drive of another computer on the
-network (provided you have the required bandwidth). On the downside some
-stream type (currently TV and MF) are not usable remotely because they are
-implemented at the demuxer level. It is sad for MF but TV stream would anyway
-require an insane amount of bandwidth.
-</para>
-
-<!-- ********** -->
-
-<sect2 id="compile_mpst_server">
-<title>Compiling the server</title>
-
-<para>
-After having compiled <application>MPlayer</application> go to the
-<filename>TOOLS/netstream</filename> directory and enter
-<application>make</application> to build the server binary.
-You can then copy the <application>netstream</application> binary
-to the right place on your system (usually
-<filename class="directory">/usr/local/bin</filename> on Linux).
-</para>
-</sect2>
-
-<!-- ********** -->
-
-<sect2 id="use_mpst">
-<title>Using remote streams</title>
-
-<para>
-First you have to start the server on the computer you intend to remotely
-access. Currently the server is very basic and does not have any commands
-line arguments so just enter <filename>netstream</filename>. Now you can
-for example play the second track of a VCD on the server with :
-<screen>
-mplayer -cache 5000 <replaceable>mpst://servername/vcd://2</replaceable>
-</screen>
-You can also access files on this server :
-<screen>
-mplayer -cache 5000 <replaceable>mpst://servername//usr/local/movies/lol.avi</replaceable>
-</screen>
-Note that paths which aren't starting with a / will be relative to
-the directory where the server is running. The <option>-cache</option> option
-is not needed but highly recommended.
-</para>
-
-<para>
-Be aware that currently the server is not secure at all. So do not complain
-about the numerous exploits which are possible through this. Instead send
-some (good) patch to make it better or start writing your own server.
-</para>
-</sect2>
-</sect1>
-
-
-<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
-
-
 <sect1 id="edl" xreflabel="Edit Decision Lists (EDL)">
 <title>Edit Decision Lists (EDL)</title>
 

--- a/TOOLS/README	Mon Apr 09 11:30:26 2007 +0000
+++ b/TOOLS/README	Mon Apr 09 11:54:03 2007 +0000
@@ -11,7 +11,6 @@
 FIXME: Document the following tools:
 
 bmovl-test
-netstream
 
 
 MPlayer scripts in the TOOLS dir
@@ -517,3 +516,35 @@
               - Put the wrappers in the RealPlayer codecs directory.
 
 Notes:        Known to work at least on Linux x86 with RealPlayer8.
+
+
+
+netstream - access remote streams
+---------------------------------
+
+NOTE: netstream does not link at the moment - help welcome.
+
+netstream allows you to access most MPlayer stream types from a remote host.
+The main purpose of this feature is to make it possible to directly use the
+CD or DVD drive of another computer on the network (provided you have the
+required bandwidth). On the downside some stream types (currently TV and MF)
+are not usable remotely because they are implemented at the demuxer level.
+
+Be aware that currently the server is not secure at all.
+
+Compile the server by running 'make netstream' and then copy the netstream
+binary to the right place on your system (usually /usr/local/bin on Unix).
+Start the netstream server on the computer you intend to access remotely.
+There are no command line arguments.
+
+Play the second track of a VCD on the server with:
+
+  mplayer -cache 5000 mpst://servername/vcd://2
+
+Access files on this server with:
+
+  mplayer -cache 5000 mpst://servername//usr/local/movies/lol.avi
+
+Note that paths which do not start with a / will be interpreted as relative to
+the directory where the server is running. The '-cache' option is not needed
+but highly recommended.